@kud/gh-ink 0.75.0 → 0.75.2

package/dist/index.d.ts

@@ -196,7 +196,11 @@ declare const SidePanel: ({ sidebar, liveLabel, width, height, focused, cursor,
 type FocusSlot = {
     /** The mark in front of the row, accent by default. */
     mark?: string;
-    /** The mark's colour. Defaults to the accent. */
+    /**
+     * The mark's colour in the list gutter (`focusCellFor`). Defaults to the
+     * accent. The ready row's pill takes its accent from its own
+     * `variant="accent"`, so this never reaches the pill.
+     */
     markColor?: string;
     /** What the row is a slot OF, in the host's words: `focus`, say. */
     label: string;
@@ -217,6 +221,7 @@ type FocusSlot = {
     };
 };
 declare const FOCUS_MARK = "\uDB81\uDCFE";
+declare const FOCUS_JUMP_KEY = "g";
 declare const DEFAULT_FOCUS_LABEL = "focus";
 declare const DEFAULT_FOCUS_EMPTY = "nothing to focus on";
 /**
@@ -256,7 +261,7 @@ declare const focusRefColor: (focus: Pick<FocusSlot, "ref" | "refColor">) => str
  * with nothing to point at. Either prop (`label`/`empty`) reserves the row;
  * with neither and no focus value the caller draws nothing at all.
  */
-declare const FocusSlotLine: ({ focus, label, empty, width, }: {
+declare const FocusSlotLine: ({ focus, label, empty, width, jumpKey, }: {
     /** `undefined` while the first answer is out; `null` when it came back empty. */
     focus: FocusSlot | null | undefined;
     /** What to call the row. The host's word; defaults to `focus`. */
@@ -265,6 +270,12 @@ declare const FocusSlotLine: ({ focus, label, empty, width, }: {
     empty?: string;
     /** Columns the row may use. */
     width: number;
+    /**
+     * The key that jumps to the focus row, drawn as a quiet hint after the
+     * reason. Ready rows only: loading and empty have no row to jump to, so
+     * they never draw it even when it is set.
+     */
+    jumpKey?: string;
 }) => React.JSX.Element;
 
 /**
@@ -1124,4 +1135,4 @@ declare const matchesFilter: (repo: string, filter: RepoFilter) => boolean;
  */
 declare const parsePatterns: (value: string) => string[];
 
-export { type Action, type ActionGroup, ActionMenu, App, COLS, type ChromeHints, type ChromeSpec, type ChromeState, CiStatusLine, type CiStatusState, type Command, CommentsPanel, type CommentsPanelProps, DEFAULT_FOCUS_EMPTY, DEFAULT_FOCUS_LABEL, type DetailContext, type ExplainSection, type ExtensionTarget, FOCUS_MARK, type FocusGutter, type FocusSlot, FocusSlotLine, HealthPanel, type HealthPanelProps, type InboxBudget, type InboxExtension, type JiraAvailableTransition, type JiraTransition, type JiraTransitionsFor, type LiveLabel, LookupMiss, MIN_SIDEBAR_COLS, type MenuGap, type MenuRow, PrRow, type PrRowProps, type Rails, type RepoFilter, type RowAnnouncement, type RowMotion, SIDEBAR_COLS, type SettledResult, SidePanel, type Sidebar, type SidebarRow, type StatusStrip, StatusStripLine, type StripItem, type StripState, type StripStatusState, type TabForStatus, type TrailingColumns, type TrailingShed, ageLabel, budgetNotice, buildActions, buildCheckoutCmd, clipboard, counts, drillCmd, explainGhAction, explainItem, fitCount, focusCellFor, focusRefColor, gapsAbove, healthColor, healthDisplay, healthGlyph, healthLegend, isMenuGap, itermRun, jumpToRepo, jumpToRepoPane, matchesFilter, maxViewStart, menuRowsOf, menuTone, moveCursor, numberColumnsOf, openInTab, parsePatterns, railCapacity, railHeights, railRowsOf, railWidth, railsOf, readCache, renderMarkdown, reposInSections, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, sectionShedOf, signatureOf, stripGlyph, stripLayout, stripSignature, toCiStatusState, trailingColumnsOf, truncate, useActionMenu, useChrome, windowCount, withHeaders, withoutItem, workCount, writeCache };
+export { type Action, type ActionGroup, ActionMenu, App, COLS, type ChromeHints, type ChromeSpec, type ChromeState, CiStatusLine, type CiStatusState, type Command, CommentsPanel, type CommentsPanelProps, DEFAULT_FOCUS_EMPTY, DEFAULT_FOCUS_LABEL, type DetailContext, type ExplainSection, type ExtensionTarget, FOCUS_JUMP_KEY, FOCUS_MARK, type FocusGutter, type FocusSlot, FocusSlotLine, HealthPanel, type HealthPanelProps, type InboxBudget, type InboxExtension, type JiraAvailableTransition, type JiraTransition, type JiraTransitionsFor, type LiveLabel, LookupMiss, MIN_SIDEBAR_COLS, type MenuGap, type MenuRow, PrRow, type PrRowProps, type Rails, type RepoFilter, type RowAnnouncement, type RowMotion, SIDEBAR_COLS, type SettledResult, SidePanel, type Sidebar, type SidebarRow, type StatusStrip, StatusStripLine, type StripItem, type StripState, type StripStatusState, type TabForStatus, type TrailingColumns, type TrailingShed, ageLabel, budgetNotice, buildActions, buildCheckoutCmd, clipboard, counts, drillCmd, explainGhAction, explainItem, fitCount, focusCellFor, focusRefColor, gapsAbove, healthColor, healthDisplay, healthGlyph, healthLegend, isMenuGap, itermRun, jumpToRepo, jumpToRepoPane, matchesFilter, maxViewStart, menuRowsOf, menuTone, moveCursor, numberColumnsOf, openInTab, parsePatterns, railCapacity, railHeights, railRowsOf, railWidth, railsOf, readCache, renderMarkdown, reposInSections, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, sectionShedOf, signatureOf, stripGlyph, stripLayout, stripSignature, toCiStatusState, trailingColumnsOf, truncate, useActionMenu, useChrome, windowCount, withHeaders, withoutItem, workCount, writeCache };

package/dist/index.js

@@ -1,6 +1,6 @@
 import React2, { createContext, useState, useRef, useContext, useEffect, useCallback, useMemo } from 'react';
 import { useWindowSize, useInput, Text, Box } from 'ink';
-import { colors, ScrollView, TextInput, Pill, getIconMode, FooterHints, useAppKeys, LoadingScreen, StatusMessage, useFilterMode, useListCursor, CommandPalette, Tabs, ProgressBar, pillWidth } from '@kud/ink-ui';
+import { colors, ScrollView, TextInput, Pill, getIconMode, FooterHints, useAppKeys, LoadingScreen, pillWidth, StatusMessage, useFilterMode, useListCursor, CommandPalette, Tabs, ProgressBar } from '@kud/ink-ui';
 import { isPassCheck, isFailCheck, isInconclusiveCheck, resolveThread, unresolveThread, replyToThread, rerunFailedRun, mergePr, reRequestReviewer, parseRef, formatRef, fetchItemNode } from '@kud/gh';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 import { PIN_MARK, sizeOf, sizePartsOf, depthOf, impliedLabels, labelPriority, checkoutDirs, profileOf, inboxConfig, relativeTime, filterBySearch, filterByRepos, filterByOrigin, refCandidates, resolveRef } from '@kud/gh-workflow';
@@ -1694,6 +1694,7 @@ var failureNotice = (failed) => {
   return `\u2717 Couldn't ${newest.action} ${newest.label}: ${newest.failure?.reason ?? "no reason reported"}${more}  w restore`;
 };
 var FOCUS_MARK = "\u{F04FE}";
+var FOCUS_JUMP_KEY = "g";
 var DEFAULT_FOCUS_LABEL = "focus";
 var DEFAULT_FOCUS_EMPTY = "nothing to focus on";
 var focusCellFor = (focus, url) => {
@@ -1703,23 +1704,34 @@ var focusCellFor = (focus, url) => {
 };
 var focusRefColor = (focus) => focus.refColor ?? (focus.ref.startsWith("#") ? colors.accent : colors.ticket);
 var cells = (s) => [...s].length;
-var titleBudgetOf = (focus, label, width) => {
+var titleBudgetOf = (focus, label, width, jumpKey) => {
+  const hint = jumpKey ? jumpKey : void 0;
   const mark = focus.mark ?? FOCUS_MARK;
-  const head = 2 + cells(mark) + 1 + cells(label) + 2 + (focus.marker ? cells(focus.marker) + 1 : 0) + cells(focus.ref) + 2;
+  const head = 2 + pillWidth(`${mark} ${label}`) + 2 + (focus.marker ? cells(focus.marker) + 1 : 0) + cells(focus.ref) + 2;
+  const hintCells = hint ? 3 + cells(hint) + 5 : 0;
   const tail = 3 + cells(focus.reason);
-  const titleMax = width - head - tail;
+  const titleMax = width - head - tail - hintCells;
   if (titleMax >= 1)
-    return { title: truncate(focus.title, titleMax), reason: focus.reason };
+    return { title: truncate(focus.title, titleMax), reason: focus.reason, hint };
+  const reasonMax = width - head - 3 - 1 - hintCells;
+  if (hint === void 0 || reasonMax >= 1)
+    return {
+      title: "",
+      reason: truncate(focus.reason, Math.max(0, width - head - 3 - 1 - hintCells)),
+      hint
+    };
   return {
     title: "",
-    reason: truncate(focus.reason, Math.max(0, width - head - 3 - 1))
+    reason: truncate(focus.reason, Math.max(0, width - head - 3 - 1)),
+    hint: void 0
   };
 };
 var FocusSlotLine = ({
   focus,
   label = DEFAULT_FOCUS_LABEL,
   empty = DEFAULT_FOCUS_EMPTY,
-  width
+  width,
+  jumpKey
 }) => {
   if (focus === void 0)
     return /* @__PURE__ */ jsxs(Box, { marginBottom: 1, children: [
@@ -1732,15 +1744,20 @@ var FocusSlotLine = ({
       /* @__PURE__ */ jsx(Text, { dimColor: true, children: `${label}  ${empty}` })
     ] });
   const mark = focus.mark ?? FOCUS_MARK;
-  const { title, reason } = titleBudgetOf(focus, label, width);
+  const { title, reason, hint } = titleBudgetOf(focus, label, width, jumpKey);
   return /* @__PURE__ */ jsxs(Box, { marginBottom: 1, children: [
     /* @__PURE__ */ jsx(Text, { children: "  " }),
-    /* @__PURE__ */ jsx(Text, { color: focus.markColor ?? colors.accent, bold: true, children: `${mark} ` }),
-    /* @__PURE__ */ jsx(Text, { dimColor: true, children: `${label}  ` }),
+    /* @__PURE__ */ jsx(Pill, { variant: "accent", tone: "tonal", children: `${mark} ${label}` }),
+    /* @__PURE__ */ jsx(Text, { children: "  " }),
     focus.marker ? /* @__PURE__ */ jsx(Text, { children: `${focus.marker} ` }) : null,
     /* @__PURE__ */ jsx(Text, { color: focusRefColor(focus), bold: true, children: `${focus.ref}  ` }),
     /* @__PURE__ */ jsx(Text, { bold: true, children: title }),
-    /* @__PURE__ */ jsx(Text, { dimColor: true, children: `   ${reason}` })
+    /* @__PURE__ */ jsx(Text, { dimColor: true, children: `   ${reason}` }),
+    hint ? /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: "   " }),
+      /* @__PURE__ */ jsx(Text, { color: colors.accent, bold: true, children: hint }),
+      /* @__PURE__ */ jsx(Text, { dimColor: true, children: " jump" })
+    ] }) : null
   ] });
 };
 var quietly = $({ quiet: true });
@@ -3324,7 +3341,7 @@ var HelpModal = ({
     ["f", "filter by repo"],
     ["r", "refresh"],
     ["w", "restore a change that failed"],
-    ...hasFocus ? [["g", "jump to focus"]] : [],
+    ...hasFocus ? [[FOCUS_JUMP_KEY, "jump to focus"]] : [],
     ...extensionLegend(extensions),
     ["?", "this help"],
     ["q", "quit"]
@@ -3969,7 +3986,7 @@ var BrowseScreen = ({
       onRefresh?.();
       return;
     }
-    if (input === "g" && focus) {
+    if (input === FOCUS_JUMP_KEY && focus) {
       const tabId = focus.target.tab;
       const at = localSections.findIndex((s) => s.id === tabId);
       if (at === -1) return;
@@ -4497,7 +4514,8 @@ var BrowseScreen = ({
             focus,
             label: focusLabel,
             empty: focusEmpty,
-            width: COLS
+            width: COLS,
+            jumpKey: FOCUS_JUMP_KEY
           }
         ) : null,
         skippedForBudget ? /* @__PURE__ */ jsxs(Box, { marginBottom: 1, children: [
@@ -4710,7 +4728,15 @@ var App = ({
   onSettled
 }) => {
   const { rows } = useWindowSize();
-  const [state, setState] = useState({ phase: "loading" });
+  const [launchCache] = useState(() => cacheKey ? readCache(cacheKey) : null);
+  const launchPainted = !!launchCache && launchCache.sections.length > 0;
+  const [state, setState] = useState(
+    () => launchPainted && launchCache ? {
+      phase: "browse",
+      sections: launchCache.sections,
+      login: launchCache.login
+    } : { phase: "loading" }
+  );
   const browsePeel = useRef(null);
   const drillPeel = useRef(null);
   const [typing, setTyping] = useState(false);
@@ -4740,7 +4766,9 @@ var App = ({
   });
   const [pending, setPending] = useState(null);
   const [refreshing, setRefreshing] = useState(false);
-  const [fetchedAt, setFetchedAt] = useState(null);
+  const [fetchedAt, setFetchedAt] = useState(
+    launchPainted && launchCache ? launchCache.at : null
+  );
   const [refreshError, setRefreshError] = useState(null);
   const [ciStatusState, setCiStatusState] = useState({
     kind: "loading"
@@ -4750,6 +4778,7 @@ var App = ({
     return sameCiStatusState(prev, next) ? prev : next;
   });
   const hasStrip = !!stripFetcher;
+  const hasFocusSlot = focusLabel !== void 0 || focusEmpty !== void 0;
   const [stripState, setStripState] = useState({
     kind: "loading"
   });
@@ -4758,8 +4787,12 @@ var App = ({
     if (prev.kind !== "ready") return next;
     return stripSignature(prev.strip) === stripSignature(strip) ? prev : next;
   });
-  const displayedKey = useRef("");
-  const displayedSections = useRef([]);
+  const displayedKey = useRef(
+    launchPainted && launchCache ? signatureOf(launchCache.sections) : ""
+  );
+  const displayedSections = useRef(
+    launchPainted && launchCache ? launchCache.sections : []
+  );
   const [transients, setTransients] = useState(NO_TRANSIENTS);
   const transitTabs = useRef(/* @__PURE__ */ new Map());
   const [heldSince, setHeldSince] = useState(NO_HOLDS);
@@ -5024,21 +5057,7 @@ var App = ({
     setTimeout(() => applyOrRefresh(), 1500);
   };
   useEffect(() => {
-    const cached = cacheKey ? readCache(cacheKey) : null;
-    const painted = !!cached && cached.sections.length > 0;
-    if (painted && cached) {
-      displayedKey.current = signatureOf(cached.sections);
-      displayedSections.current = cached.sections;
-      setFetchedAt(cached.at);
-      if (cached.sidebar) setSidebar(cached.sidebar);
-      if (cached.focus !== void 0) setFocus(cached.focus);
-      setState({
-        phase: "browse",
-        sections: cached.sections,
-        login: cached.login
-      });
-    }
-    if (!painted || !isFresh(cached)) revalidate();
+    if (!launchPainted || !isFresh(launchCache)) revalidate();
   }, []);
   useEffect(() => {
     if (!hasCiStatus || !ciFetcher) return;
@@ -5114,8 +5133,12 @@ var App = ({
     () => cacheKey ? readCache(cacheKey)?.budget ?? null : null
   );
   const [appliedSummary, setAppliedSummary] = useState("");
-  const [sidebar, setSidebar] = useState(void 0);
-  const [focus, setFocus] = useState(void 0);
+  const [sidebar, setSidebar] = useState(
+    launchPainted ? launchCache?.sidebar : void 0
+  );
+  const [focus, setFocus] = useState(
+    launchPainted ? launchCache?.focus : void 0
+  );
   const [skippedForBudget, setSkippedForBudget] = useState(false);
   const [mergedUrls, setMergedUrls] = useState([]);
   const [leavingUrls, setLeavingUrls] = useState([]);
@@ -5168,7 +5191,7 @@ var App = ({
               width: COLS
             }
           ) : null,
-          focusLabel !== void 0 || focusEmpty !== void 0 ? /* @__PURE__ */ jsx(
+          hasFocusSlot ? /* @__PURE__ */ jsx(
             FocusSlotLine,
             {
               focus: void 0,
@@ -5181,7 +5204,10 @@ var App = ({
             Box,
             {
               flexDirection: "column",
-              minHeight: Math.max(5, rows - 6 - (hasCiStatus ? 2 : 0)),
+              minHeight: Math.max(
+                5,
+                rows - 5 - (hasCiStatus ? 2 : 0) - (hasStrip ? 2 : 0) - (hasFocusSlot ? 2 : 0)
+              ),
               children: state.phase === "loading" ? /* @__PURE__ */ jsx(LoadingScreen, { label: `Fetching ${title}\u2026` }) : /* @__PURE__ */ jsx(
                 NoRowsScreen,
                 {
@@ -5340,4 +5366,4 @@ var matchesFilter = (repo, filter) => {
 };
 var parsePatterns = (value) => value.split(",").map((p) => p.trim()).filter(Boolean);
 
-export { ActionMenu, App, COLS, CiStatusLine, CommentsPanel, DEFAULT_FOCUS_EMPTY, DEFAULT_FOCUS_LABEL, FOCUS_MARK, FocusSlotLine, HealthPanel, LookupMiss, MIN_SIDEBAR_COLS, PrRow, SIDEBAR_COLS, SidePanel, StatusStripLine, ageLabel, budgetNotice, buildActions, buildCheckoutCmd, clipboard, counts, drillCmd, explainGhAction, explainItem, fitCount, focusCellFor, focusRefColor, gapsAbove, healthColor, healthDisplay, healthGlyph, healthLegend, isMenuGap, itermRun, jumpToRepo, jumpToRepoPane, matchesFilter, maxViewStart, menuRowsOf, menuTone, moveCursor, numberColumnsOf, openInTab, parsePatterns, railCapacity, railHeights, railRowsOf, railWidth, railsOf, readCache, renderMarkdown, reposInSections, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, sectionShedOf, signatureOf, stripGlyph, stripLayout, stripSignature, toCiStatusState, trailingColumnsOf, truncate, useActionMenu, useChrome, windowCount, withHeaders, withoutItem, workCount, writeCache };
+export { ActionMenu, App, COLS, CiStatusLine, CommentsPanel, DEFAULT_FOCUS_EMPTY, DEFAULT_FOCUS_LABEL, FOCUS_JUMP_KEY, FOCUS_MARK, FocusSlotLine, HealthPanel, LookupMiss, MIN_SIDEBAR_COLS, PrRow, SIDEBAR_COLS, SidePanel, StatusStripLine, ageLabel, budgetNotice, buildActions, buildCheckoutCmd, clipboard, counts, drillCmd, explainGhAction, explainItem, fitCount, focusCellFor, focusRefColor, gapsAbove, healthColor, healthDisplay, healthGlyph, healthLegend, isMenuGap, itermRun, jumpToRepo, jumpToRepoPane, matchesFilter, maxViewStart, menuRowsOf, menuTone, moveCursor, numberColumnsOf, openInTab, parsePatterns, railCapacity, railHeights, railRowsOf, railWidth, railsOf, readCache, renderMarkdown, reposInSections, resolveRepoPath, runHere, runInPane, runInPaneHorizontal, sameCiStatusState, sectionShedOf, signatureOf, stripGlyph, stripLayout, stripSignature, toCiStatusState, trailingColumnsOf, truncate, useActionMenu, useChrome, windowCount, withHeaders, withoutItem, workCount, writeCache };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kud/gh-ink",
-  "version": "0.75.0",
+  "version": "0.75.2",
   "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",
@@ -44,7 +44,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@kud/ink-ui": ">=0.39.0 <1",
+    "@kud/ink-ui": ">=0.41.0 <1",
     "ink": ">=7",
     "react": ">=19"
   },
@@ -54,7 +54,7 @@
     "zx": "8.8.5"
   },
   "devDependencies": {
-    "@kud/ink-ui": "0.39.0",
+    "@kud/ink-ui": "0.41.0",
     "@types/node": "22.20.1",
     "@types/react": "19.2.17",
     "ink": "7.1.0",