acuvo-code 0.4.0 → 0.4.1

package/lib/input-box.mjs

@@ -213,10 +213,37 @@ export function splitKeys(chunk) {
  */
 export function paint(output, state, { first = false } = {}) {
   const { lines, cursorColumn } = renderBox(state);
-  const up = first ? '' : `${CSI}3A`;
+
+  /**
+   * ── ⚠️⚠️ THE CURSOR MATH, AND MY FIRST VERSION ATE THE SCREEN ──────────────
+   *
+   * Roman: *"it moves upwards every time you type a character then deletes the
+   * design you did."* Exactly right, and the arithmetic says why.
+   *
+   * After a paint the cursor rests on the INPUT line — line 2 of 3, not below
+   * the box. The first version began each repaint with `ESC[3A`, which is where
+   * it would be if the cursor were below. From line 2, moving up 3 lands ONE
+   * LINE ABOVE the top border — and the `ESC[0J` that follows clears from there
+   * to the bottom of the screen. So every keystroke crept upward and erased
+   * another line of the banner.
+   *
+   * ⭐ THE INVARIANT, WRITTEN DOWN BECAUSE IT IS THE WHOLE FUNCTION: this
+   * routine ENTERS with the cursor on the input line and LEAVES it there. So a
+   * repaint moves up exactly ONE line to reach the top border, and the final
+   * reposition moves up exactly one from the last line written.
+   *
+   *   ╭────────╮   <- line 1   ESC[1A from the input line reaches here
+   *   │› …      │   <- line 2   cursor lives here, in and out
+   *   ╰────────╯   <- line 3   cursor is here after writing; ESC[1A returns
+   *
+   * ⚠️ NO TRAILING NEWLINE. Writing one after the last border scrolls the
+   * viewport when the box is at the bottom of the screen, and every subsequent
+   * `up` is then off by a row for the rest of the session.
+   */
+  const home = first ? '' : `\r${CSI}1A`;
   output.write(
-    `${CSI}?25l${up}\r${CSI}0J${lines.join('\n')}\n` +
-    `${CSI}2A\r${CSI}${cursorColumn}G${CSI}?25h`,
+    `${CSI}?25l${home}${CSI}0J${lines.join('\n')}` +
+    `${CSI}1A\r${CSI}${cursorColumn}G${CSI}?25h`,
   );
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acuvo-code",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Acuvo Code — the terminal client for the Acuvo capability registry. Zero dependencies, by design.",
   "type": "module",
   "bin": {