@kud/jira-ink 0.9.0 → 0.10.0

package/dist/index.d.ts

@@ -412,6 +412,12 @@ type BoardLeaves<L> = {
     }) => ReactNode;
     onOpen: (leaf: L) => void;
 };
+/** The stop under the cursor, and everything hanging off it. */
+type CursorAt<L> = {
+    stop: Stop<L>;
+    /** The stop and its descendants, as `subtreeOf` reads them. */
+    subtree: Block<L>[];
+};
 type IssueBoardProps<L = never> = {
     model: BoardModel;
     leaves?: BoardLeaves<L>;
@@ -467,6 +473,18 @@ type IssueBoardProps<L = never> = {
      * app keys down while a letter is a letter — `q` must type there, not quit.
      */
     onInputFocus?: (focused: boolean) => void;
+    /**
+     * Where the cursor is, for a host that binds keys of its own — a move menu,
+     * or `C` / `O` over everything hanging off the row.
+     *
+     * The board owns the cursor, so a host that wanted to act on the selected
+     * row had no way to learn which one it was: `onOpen` answers only on ↵. The
+     * subtree comes with it rather than as a second call, because the host has
+     * no handle on `blocks` to walk it from.
+     *
+     * `null` while a tab holds nothing.
+     */
+    onCursor?: (at: CursorAt<L> | null) => void;
 };
 /**
  * Rows are windowed by hand rather than handed to `Table`, which renders every
@@ -477,7 +495,7 @@ type IssueBoardProps<L = never> = {
  * host — only the keys that open and close the layers it pushes itself: the
  * search input and the legend.
  */
-declare const IssueBoard: <L = never>({ model, leaves, parents, viewer, loadedAt, scope, showingAll, searchError, width, height, onOpen, onToggleAll, onRefresh, onSearch, onClearSearch, frame, onInputFocus, }: IssueBoardProps<L>) => string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react.JSX.Element | null | undefined;
+declare const IssueBoard: <L = never>({ model, leaves, parents, viewer, loadedAt, scope, showingAll, searchError, width, height, onOpen, onToggleAll, onRefresh, onSearch, onClearSearch, frame, onInputFocus, onCursor, }: IssueBoardProps<L>) => string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | react.ReactPortal | react.ReactElement<unknown, string | react.JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | react.JSX.Element | null | undefined;
 
 type PriorityMarker = {
     /** Always one column wide, so a list filling every row keeps its grid. */
@@ -502,4 +520,4 @@ declare const priorityMarker: (name: string | null) => PriorityMarker;
 declare const MOCK_BOARD_ROWS: BoardRow[];
 declare const mockBoard: () => BoardModel;
 
-export { type Block, type BoardLeaves, type BoardModel, type BoardOptions, type BoardRow, type BoardScope, type BoardTab, type BoardTabs, IssueBoard, type IssueBoardProps, IssueBody, type IssueBodyProps, type IssueDetail, IssueDetailView, type IssueDetailViewProps, MOCK_BOARD_ROWS, OFF_BOARD, type Placement, type PriorityGlyph, type PriorityMarker, type StatusCategory, type Stop, type TabSource, type Transition, type TransitionTarget, blockIndexOfStop, blocksFor, boardOf, countsFor, fenceNote, headNote, isStop, issueDetailOf, mockBoard, parentsOf, pendingRow, pillVariantFor, placementOf, priorityGlyph, priorityMarker, relativeAge, rowsInTab, settleRow, stopsOf, subtreeOf, tabLabelOf, tabOf, tabsFromBoard, tabsFromCategories, tabsFromConfig, toBoardRow, transitionRow, transitionsOf, treePrefix, visibleTabs, withBehind };
+export { type Block, type BoardLeaves, type BoardModel, type BoardOptions, type BoardRow, type BoardScope, type BoardTab, type BoardTabs, type CursorAt, IssueBoard, type IssueBoardProps, IssueBody, type IssueBodyProps, type IssueDetail, IssueDetailView, type IssueDetailViewProps, MOCK_BOARD_ROWS, OFF_BOARD, type Placement, type PriorityGlyph, type PriorityMarker, type StatusCategory, type Stop, type TabSource, type Transition, type TransitionTarget, blockIndexOfStop, blocksFor, boardOf, countsFor, fenceNote, headNote, isStop, issueDetailOf, mockBoard, parentsOf, pendingRow, pillVariantFor, placementOf, priorityGlyph, priorityMarker, relativeAge, rowsInTab, settleRow, stopsOf, subtreeOf, tabLabelOf, tabOf, tabsFromBoard, tabsFromCategories, tabsFromConfig, toBoardRow, transitionRow, transitionsOf, treePrefix, visibleTabs, withBehind };

package/dist/index.js

@@ -647,7 +647,8 @@ var IssueBoard = ({
   onSearch,
   onClearSearch,
   frame,
-  onInputFocus
+  onInputFocus,
+  onCursor
 }) => {
   const [legend, setLegend] = useState(false);
   const [search, setSearch] = useState({
@@ -704,6 +705,12 @@ var IssueBoard = ({
     isActive: listFocused
   });
   useEffect(() => setCursor(0), [tab, setCursor]);
+  const at = stops[cursor];
+  useEffect(() => {
+    onCursor?.(
+      at ? { stop: at, subtree: subtreeOf(blocks, blockIndexOfStop(blocks, cursor)) } : null
+    );
+  }, [at, blocks, cursor, onCursor]);
   const openStop = (stop) => {
     if (!stop) return;
     if (stop.kind === "issue") onOpen(stop.row.key);
@@ -810,10 +817,10 @@ var IssueBoard = ({
       /* @__PURE__ */ jsx(Box, { width: 28, flexShrink: 0, children: /* @__PURE__ */ jsx(Text, { color: colors.accent, children: glyph }) }),
       /* @__PURE__ */ jsx(Text, { dimColor: true, children: meaning })
     ] }, glyph)) : stops.length === 0 ? /* @__PURE__ */ jsx(Box, { paddingLeft: 4, children: /* @__PURE__ */ jsx(Text, { dimColor: true, children: emptyHint() }) }) : blocks.slice(start, end).map((block, i) => {
-      const at = start + i;
-      const focused = at === focus;
-      const prefix = treePrefix(blocks, at);
-      return block.kind === "gap" ? /* @__PURE__ */ jsx(Text, { children: " " }, `gap:${at}`) : block.kind === "fence" ? (() => {
+      const at2 = start + i;
+      const focused = at2 === focus;
+      const prefix = treePrefix(blocks, at2);
+      return block.kind === "gap" ? /* @__PURE__ */ jsx(Text, { children: " " }, `gap:${at2}`) : block.kind === "fence" ? (() => {
         const { segment, behind } = fenceNote(
           block.parent,
           model.tabs,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kud/jira-ink",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Ink components for viewing Jira issues: the board and the issue detail screen, shared by jira-cli's TUI and cockpit",
   "type": "module",
   "main": "dist/index.js",