Correct stale overlay docstring, duplicate import, and doc claim

Author: TheGreatAxios

docs/TUI.md

@@ -325,8 +325,9 @@ blank row separates the subject from context. Choices are deliberately small:
 each one is a bare, single-line action name (`Reject`, `Accept once`, the
 scope's label) with no consequence text folded into the row. A scope's hint
 paints instead as a body message above the choice list
-(`permissionBodyFromRequest` in `src/tui/gate-wire.ts`), and the expand key
-reveals the full body — collapsed payloads and hints alike — in the overlay
+(`permissionBodyFromRequest` in `src/tui/gate-wire.ts`), and the expand key,
+which binds only when the subject carries collapsed payloads, reveals the
+full body — collapsed payloads and hints alike — in the overlay
 and, whole, in the transcript. Every choice reserves the same fixed two rows
 (label plus a row of air) so list paging stays a simple multiple. The active
 choice is marked by text color alone — cream (`UI.text`) against the dim rows

src/tui/decision-truncation.test.ts

@@ -10,8 +10,7 @@ import { SelectRenderable } from "@opentui/core";
 import type { PermissionRequest } from "../permission/types.js";
 import { withTestRenderer } from "./harness";
 import { createAppShell } from "./shell/index.js";
-import { toggleOverlayExpand } from "./shell/overlay-list.js";
-import { createOverlayList } from "./shell/overlay-list";
+import { createOverlayList, toggleOverlayExpand } from "./shell/overlay-list.js";
 import { wireGates } from "./gate-wire.js";
 import { DECISION_CHOICE_ROWS } from "./overlay-body";
 import {

src/tui/overlay-list.test.ts

@@ -1,9 +1,8 @@
 /**
- * Selection continuity of the shell's overlay list across count and height
- * changes. Scroll clamping and windowing itself are delegated to
- * @opentui/core's SelectRenderable and are not re-tested here; what this pins
- * is the wrapper's own reshape/setCount logic that carries the live selection
- * across a rebuild so a resize does not snap the cursor back.
+ * Overlay-list navigation and windowing: page/jump/move clamping, the
+ * end-exclusive visible window, and the setCount/setHeight/reshape logic
+ * that carries the live selection across a rebuild so a resize or list
+ * change does not snap the cursor back.
  */
 import { describe, expect, test } from "bun:test";
 import { withTestRenderer } from "./harness";