@yaag/tui 0.5.0 → 0.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yaag/tui",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "publishConfig": {
     "access": "public"
   },
@@ -19,6 +19,6 @@
   },
   "dependencies": {
     "@earendil-works/pi-tui": "^0.84.0",
-    "@yaag/runtime": "0.5.0"
+    "@yaag/runtime": "0.5.2"
   }
 }

package/src/tree-render.ts

@@ -24,11 +24,23 @@ export interface TreeRenderOptions {
   readonly fold?: FoldState;
   /** The settled Run's Result, or the error plus bounded stderr tail. */
   readonly result?: string;
+  /**
+   * Draws the chrome that only an interactive surface can use: the key footer,
+   * the closing rule below the Result, and the ruled tree band of a Run that
+   * spawned no Agent. A surface that takes no input sets it to `false` and gets
+   * the header, the tree, the details pane of a selected node, and the Result.
+   * It defaults to `true`.
+   */
+  readonly interactive?: boolean;
 }
 
 /**
- * Renders the four stacked regions — header, tree, details pane, key footer —
- * as unstyled terminal lines, every line truncated to `width`.
+ * Renders the four-region frame — header, tree, details pane, key footer — plus
+ * the Result of a settled Run, as unstyled terminal lines, every line truncated
+ * to `width`. `interactive: false` drops the regions a surface that takes no
+ * input has no use for. A tree that has rows keeps the rule above it and the
+ * rule below it; the Result is then the last region, and it gets no rule below
+ * it.
  *
  * Pure over the state: two calls with the same state and options return equal
  * arrays. Every untrusted string passes `sanitizeTerminalLine` first, so a
@@ -39,7 +51,11 @@ export function renderTree(state: TreeState, options: TreeRenderOptions): readon
   const rows = visibleRows(tree, options.fold ?? emptyFold());
   const rule = "─".repeat(Math.max(1, Math.floor(options.width)));
   const selected = selectedNode(rows, options.selectedPath);
-  const lines = [headerLine(state, options), rule, ...treeLines(rows, options), rule];
+  const interactive = options.interactive ?? true;
+  const collapseTreeBand = rows.length === 0 && !interactive;
+  const lines = collapseTreeBand
+    ? [headerLine(state, options)]
+    : [headerLine(state, options), rule, ...treeLines(rows, options), rule];
   const details = renderDetailsPane(selected, {
     width: options.width,
     outputTail: selected === undefined ? [] : state.outputTail(agentOfPath(selected.path)),
@@ -50,9 +66,11 @@ export function renderTree(state: TreeState, options: TreeRenderOptions): readon
     lines.push(clampToWidth("Result:", options.width));
     for (const line of result.split("\n"))
       lines.push(clampToWidth(`  ${sanitizeTerminalLine(line)}`, options.width));
-    lines.push(rule);
+    // The Result is the last region a non-interactive surface draws, so its
+    // closing rule would only separate it from nothing.
+    if (interactive) lines.push(rule);
   }
-  lines.push(clampToWidth(FOOTER, options.width));
+  if (interactive) lines.push(clampToWidth(FOOTER, options.width));
   return lines;
 }