@pi-unipi/footer 2.14.1 → 2.14.2

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "2.14.1",
-  "description": "Persistent status bar for Unipi \u2014 subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
+  "version": "2.14.2",
+  "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",
   "license": "MIT",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.1",
-    "@pi-unipi/background-tasks": "2.14.1"
+    "@pi-unipi/core": "2.14.2",
+    "@pi-unipi/background-tasks": "2.14.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/src/glance-editor.ts

@@ -63,6 +63,24 @@ function repeat(s: string, n: number): string {
 	return s.repeat(Math.max(0, n));
 }
 
+/**
+ * Frame width for a terminal of `terminalWidth` columns: one column SHORT of
+ * the terminal (legacy 8-column floor preserved below 9 columns).
+ *
+ * Issue #31 invariant — the frame is repainted every second and pi-tui joins
+ * the rewritten lines with "\r\n". A line at EXACTLY the terminal width hits
+ * the auto-wrap threshold: on terminals that wrap immediately (and whenever
+ * a glyph renders wider than visibleWidth() assumed) the cursor silently
+ * advances one extra row per line, desyncing the differential renderer —
+ * every refresh then paints a fresh frame copy one block lower until the
+ * screen fills. Never writing the last column keeps every frame line below
+ * the wrap threshold on every terminal.
+ */
+export function glanceFrameWidth(terminalWidth: number): number {
+	if (!Number.isFinite(terminalWidth)) return 8;
+	return Math.max(8, terminalWidth - 1);
+}
+
 function padLine(line: string, width: number): string {
 	const w = visibleWidth(line);
 	if (w === width) return line;
@@ -160,7 +178,8 @@ export class GlanceEditor extends CustomEditor {
 	}
 
 	override render(width: number): string[] {
-		const safe = Math.max(8, width);
+		// One column short of the terminal — see glanceFrameWidth() / issue #31.
+		const safe = glanceFrameWidth(width);
 		const inner = Math.max(0, safe - 2);
 
 		// Base render at inner width: harvest content rows only (rules dropped).

package/src/index.ts

@@ -354,8 +354,11 @@ function setupFooterUI(pi: ExtensionAPI, ctx: ExtensionContext, state: FooterSta
         // Hard safety net: never return a line wider than the terminal.
         // This catches any edge cases in layout math or visibleWidth()
         // inconsistencies with PUA characters + ANSI codes.
+        // Cap at width - 1 (issue #31): a line at EXACTLY the terminal width
+        // trips immediate-wrap terminals and desyncs the diff renderer.
         const line = layout.topContent;
-        return [visibleWidth(line) > width ? truncateToWidth(line, width) : line];
+        const cap = Math.max(1, width - 1);
+        return [visibleWidth(line) > cap ? truncateToWidth(line, cap) : line];
       },
     };
   }, { placement: "aboveEditor" });
@@ -373,7 +376,9 @@ function setupFooterUI(pi: ExtensionAPI, ctx: ExtensionContext, state: FooterSta
         if (!strip) return [];
         // Centered under the input box.
         const w = visibleWidth(strip);
-        if (w >= width) return [truncateToWidth(strip, width)];
+        // Truncate one column short of the terminal (issue #31 — same wrap
+        // desync as the glance frame; see glanceFrameWidth()).
+        if (w >= width) return [truncateToWidth(strip, Math.max(1, width - 1))];
         const leftPad = Math.floor((width - w) / 2);
         return [" ".repeat(leftPad) + strip];
       },

package/src/process-line.ts

@@ -55,7 +55,9 @@ export function countBgProcesses(): BgProcessCounts | null {
  * Returns [] when there is nothing to show.
  */
 export function renderProcessLine(width: number): string[] {
-  if (width <= 0) return [];
+  // One column can never host a meaningful one-liner, and any content would
+  // be exactly-full-width (issue #31 wrap desync) — render nothing.
+  if (width <= 1) return [];
   const counts = countBgProcesses();
   if (!counts) return [];
 
@@ -68,7 +70,9 @@ export function renderProcessLine(width: number): string[] {
 
   const line = parts.join("  ");
   const w = visibleWidth(line);
-  if (w >= width) return [truncateToWidth(line, width)];
+  // One column short of the terminal (issue #31 — same wrap desync as the
+  // glance frame; see glanceFrameWidth() in glance-editor.ts).
+  if (w >= width) return [truncateToWidth(line, Math.max(1, width - 1))];
   const leftPad = Math.floor((width - w) / 2);
   return [" ".repeat(leftPad) + line];
 }