@erichll/pi-statusline 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.4.0 - 2026-10-08
+
+- Upgrade Pi AI, coding-agent, and TUI development dependencies to `^1.1.0`
+  and replace wildcard peers with the same tested baseline. Node types
+  (`^26.6.4`) and TypeScript (`^7.0.2`) already match the latest stable versions.
+
+## 0.3.0 - 2026-10-04
+
+- Add `spacing` (0–3 blank lines, default 1) to control the gap between the input box and the statusline; configurable in the panel and persisted in the configuration.
+- Hide the `Compactions` count while it is zero, including the first active compaction.
+
 ## 0.2.0 - 2026-10-04
 
 - Use the same muted color for No content and Avg; default modelDisplay to name while preserving explicit last preferences.

package/README.md

@@ -1,6 +1,6 @@
 # @erichll/pi-statusline
 
-A configurable footer for Pi 1.0 with Git status, session usage, runtime/tool activity, themes, and live configuration preview. Uses Pi's native footer and leaves the editor intact.
+A configurable footer for Pi 1.1 with Git status, session usage, runtime/tool activity, themes, and live configuration preview. Uses Pi's native footer and leaves the editor intact.
 
 ```text
   Example model(high)  󰆼 [█░░░░░░░░░]11.9%  󰉋 pi-packages   main ● *2 ↑2  󰊄 49.4k
@@ -13,7 +13,7 @@ Elapsed 5m 42s · Avg 45 tok/s · Cache 86% · Turns 3 · Compactions 1
 pi install npm:@erichll/pi-statusline
 ```
 
-Requires Node.js >=22.19, Pi >=1.0.0, a Nerd Font for the default Powerline layout,
+Requires Node.js >=22.19, Pi >=1.1.0, a Nerd Font for the default Powerline layout,
 and optionally Git. Switch icons/separators in the panel for a font-independent
 layout. The package has no
 other runtime dependencies and makes no network requests or credential lookups.
@@ -79,6 +79,7 @@ existing file to the new path before running `/reload`; the old path is no longe
   "pathMode": "basename",
   "modelDisplay": "name",
   "contextDisplay": "bar",
+  "spacing": 1,
   "segments": [
     {
       "id": "model",
@@ -167,6 +168,11 @@ existing file to the new path before running `/reload`; the old path is no longe
   the bar completely and retain the reported percentage. Both modes use the
   existing context warning colors. Text mode includes token counts and capacity;
   bar mode shows progress and percentage.
+- Spacing: `1` (default), `0`, `2` or `3` blank lines above the statusline.
+  Pi renders the footer directly under the editor, so this is the only supported
+  way to add breathing room between the input box and the statusline; the editor's
+  own bottom border cannot be removed. Choose **Spacing above statusline** in the
+  panel or set `"spacing": 0` for a flush footer.
 - `segments`: optional ordered array of `{ id, enabled, icon?, color?, iconColor?, background? }`.
   An explicit list is authoritative: omitted segments are disabled but remain
   available in the panel. The `statuses` segment always occupies the second row.
@@ -245,7 +251,8 @@ footer has no Idle label or leading separator.
   show `Compaction failed` / `Compaction cancelled` while no model run is active,
   until subsequent activity.
 - `Compactions` counts unique successful entries across the **whole session file**,
-  including other branches, not merely the selected tree path.
+  including other branches, not merely the selected tree path. It is hidden
+  while the count is zero, including during the first active compaction.
 `runtime.enabled: false` hides the statusline's runtime metrics. Individual
 options hide their corresponding items; `status` controls the local Elapsed
 and compaction-result labels. The `statuses` segment independently controls other

package/examples/statusline.json

@@ -7,6 +7,7 @@
   "pathMode": "basename",
   "modelDisplay": "name",
   "contextDisplay": "bar",
+  "spacing": 1,
   "segments": [
     {
       "id": "model",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@erichll/pi-statusline",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Configurable Pi statusline with live preview, Git and session usage",
   "type": "module",
   "license": "MIT",
@@ -17,14 +17,14 @@
     "smoke": "python3 test/pty-smoke.py"
   },
   "peerDependencies": {
-    "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
-    "@earendil-works/pi-tui": "*"
+    "@earendil-works/pi-ai": "^1.1.0",
+    "@earendil-works/pi-coding-agent": "^1.1.0",
+    "@earendil-works/pi-tui": "^1.1.0"
   },
   "devDependencies": {
-    "@earendil-works/pi-ai": "^1.0.0",
-    "@earendil-works/pi-coding-agent": "^1.0.0",
-    "@earendil-works/pi-tui": "^1.0.0",
+    "@earendil-works/pi-ai": "^1.1.0",
+    "@earendil-works/pi-coding-agent": "^1.1.0",
+    "@earendil-works/pi-tui": "^1.1.0",
     "@types/node": "^26.6.4",
     "typescript": "^7.0.2"
   }

package/src/config.ts

@@ -13,7 +13,7 @@ export function presetConfig(): StatuslineConfig {
   const enabled = new Set<string>(["model", "thinking", "directory", "git", "context", "tokens", "statuses"]);
   return {
     version: 1, enabled: true, preset: "powerline", icons: "nerd",
-    separator: "powerline", pathMode: "basename", modelDisplay: "name", contextDisplay: "bar",
+    separator: "powerline", pathMode: "basename", modelDisplay: "name", contextDisplay: "bar", spacing: 1,
     segments: SEGMENT_IDS.map((id) => ({ id, enabled: enabled.has(id) })),
     runtime: { enabled: true, status: true, tools: true, noContent: true, noContentSeconds: 10, avg: true, cache: true, counts: true, retainSummary: true },
   };
@@ -29,6 +29,10 @@ function boolean(value: unknown, name: string): boolean {
   if (typeof value !== "boolean") throw new Error(`Invalid ${name}`);
   return value;
 }
+function integer(value: unknown, min: number, max: number, name: string): number {
+  if (typeof value !== "number" || !Number.isInteger(value) || value < min || value > max) throw new Error(`Invalid ${name} (${min}–${max})`);
+  return value;
+}
 export function parseConfig(raw: unknown): StatuslineConfig {
   if (!record(raw)) throw new Error("Configuration must be an object");
   if (raw.version !== undefined && raw.version !== 1) throw new Error("Unsupported configuration version");
@@ -40,6 +44,7 @@ export function parseConfig(raw: unknown): StatuslineConfig {
   if (raw.pathMode !== undefined) config.pathMode = choice(raw.pathMode, ["basename", "abbreviated", "full"], "pathMode");
   if (raw.modelDisplay !== undefined) config.modelDisplay = choice(raw.modelDisplay, ["name", "last"], "modelDisplay");
   if (raw.contextDisplay !== undefined) config.contextDisplay = choice(raw.contextDisplay, ["text", "bar"], "contextDisplay");
+  if (raw.spacing !== undefined) config.spacing = integer(raw.spacing, 0, 3, "spacing");
   for (const group of ["runtime"] as const) {
     if (raw[group] === undefined) continue;
     if (!record(raw[group])) throw new Error(`Invalid ${group}`);

package/src/panel.ts

@@ -1,6 +1,6 @@
 import { Input, matchesKey, SelectList, truncateToWidth, type Component, type Focusable, type SelectItem } from "@earendil-works/pi-tui";
 import { COLORS, parseConfig, presetConfig } from "./config.ts";
-import { cleanText, renderFooter, type RenderTheme } from "./render.ts";
+import { cleanText, renderFooter, withSpacing, type RenderTheme } from "./render.ts";
 import type { SegmentConfig, StatuslineConfig, StatuslineSnapshot } from "./types.ts";
 
 interface PanelOptions {
@@ -63,6 +63,7 @@ export class StatuslinePanel implements Component, Focusable {
       { value: "pathMode", label: `Path: ${this.draft.pathMode}` },
       { value: "modelDisplay", label: `Model display: ${this.draft.modelDisplay}`, description: "name: display name · last: final model ID component" },
       { value: "contextDisplay", label: `Context display: ${this.draft.contextDisplay}`, description: "text: tokens/capacity(percent) · bar: progress and percent" },
+      { value: "spacing", label: `Spacing above statusline: ${this.draft.spacing}`, description: "Blank lines between the input box and the statusline (0–3)" },
       ...this.draft.segments.filter((segment) => segment.id !== "thinking").map((segment) => ({ value: `segment:${segment.id}`, label: `[${segment.enabled ? "x" : " "}] ${segment.id}`, description: segment.id === "statuses" ? "Secondary row · Space toggles, Enter edits" : "Space toggles · Alt+Up/Down reorders · Enter edits" })),
       { value: "runtime", label: "Runtime options" },
       { value: "save", label: "Save and apply globally" },
@@ -121,6 +122,7 @@ export class StatuslinePanel implements Component, Focusable {
       case "pathMode": this.draft.pathMode = cycle(this.draft.pathMode, ["basename", "abbreviated", "full"]); break;
       case "modelDisplay": this.draft.modelDisplay = cycle(this.draft.modelDisplay, ["name", "last"]); break;
       case "contextDisplay": this.draft.contextDisplay = cycle(this.draft.contextDisplay, ["text", "bar"]); break;
+      case "spacing": this.draft.spacing = cycle(this.draft.spacing, [0, 1, 2, 3]); break;
       case "runtime": this.section = value; this.rebuild(); return;
       case "reset": this.draft = presetConfig(); break;
       case "cancel": this.options.done(); return;
@@ -185,7 +187,7 @@ export class StatuslinePanel implements Component, Focusable {
     if (width <= 0) return [];
     if (this.listHeight !== Math.max(1, this.options.height() - 12)) this.rebuild(this.list.getSelectedItem()?.value);
     const { data, example } = this.options.snapshot();
-    const preview = renderFooter(width, data, this.draft, this.options.theme());
+    const preview = withSpacing(renderFooter(width, data, this.draft, this.options.theme()), this.draft.spacing);
     const lines = [
       this.paint(`Statusline settings${this.editing ? ` / ${this.editing.id}` : this.section ? ` / ${this.section}` : ""}`, "accent"),
       this.paint(example ? "Preview · example data" : "Preview · current session", "muted"),

package/src/render.ts

@@ -203,6 +203,16 @@ export function renderFooter(width: number, data: StatuslineSnapshot, config: St
   return lines;
 }
 
+/**
+ * Pi renders the footer directly under the editor, so leading blank lines are the only
+ * extension-side way to adjust the gap between the input box and the statusline.
+ */
+export function withSpacing(lines: string[], spacing: number): string[] {
+  const count = Number.isFinite(spacing) ? Math.max(0, Math.floor(spacing)) : 0;
+  if (lines.length === 0 || count === 0) return lines;
+  return [...Array<string>(count).fill(""), ...lines];
+}
+
 export function sampleSnapshot(): StatuslineSnapshot {
   return {
     model: "Example model", modelId: "example/provider/model", reasoning: true, thinking: "high", cwd: "/projects/pi-packages", home: "/home/example",

package/src/runtime-render.ts

@@ -25,7 +25,7 @@ export function renderRuntime(width: number, data: StatuslineSnapshot, config: S
   else if (enabled && config.runtime.status && runtime?.runId) add("elapsed", `Elapsed ${elapsed(runtime.elapsedMs)}`);
   if (enabled && compact?.active) {
     add("status", `${config.icons === "ascii" ? "Compacting..." : "Compacting…"} ${seconds(compact.elapsedMs)}`, "warning");
-    if (config.runtime.counts) add("compactions", `Compactions ${compact.count}`);
+    if (config.runtime.counts && compact.count > 0) add("compactions", `Compactions ${compact.count}`);
   } else {
     if (enabled && runtime) {
       if (config.runtime.status) {
@@ -46,7 +46,7 @@ export function renderRuntime(width: number, data: StatuslineSnapshot, config: S
       }
       if (config.runtime.counts && runtime.runId) add("turns", `Turns ${runtime.turns}`);
     }
-    if (enabled && config.runtime.counts && compact) add("compactions", `Compactions ${compact.count}`);
+    if (enabled && config.runtime.counts && compact && compact.count > 0) add("compactions", `Compactions ${compact.count}`);
     if (extensionStatus) parts.push({ id: "statuses", text: extensionStatus, styled: extensionStatus });
   }
   const separator = config.icons === "ascii" ? " | " : " · ";

package/src/session.ts

@@ -3,7 +3,7 @@ import type { AssistantMessage } from "@earendil-works/pi-ai";
 import type { ExtensionContext, ReadonlyFooterDataProvider } from "@earendil-works/pi-coding-agent";
 import type { TUI } from "@earendil-works/pi-tui";
 import { emptyGit, GitPoller, type GitReader } from "./git.ts";
-import { renderFooter } from "./render.ts";
+import { renderFooter, withSpacing } from "./render.ts";
 import type { StatuslineConfig, StatuslineSnapshot } from "./types.ts";
 import { UsageCache } from "./usage.ts";
 import { RuntimeState } from "./runtime.ts";
@@ -67,7 +67,7 @@ export class FooterSession {
       this.timer = setInterval(() => this.refresh(), 1000);
       this.timer.unref();
       return {
-        render: (width: number) => renderFooter(width, this.snapshot(), this.config, this.ctx.ui.theme),
+        render: (width: number) => withSpacing(renderFooter(width, this.snapshot(), this.config, this.ctx.ui.theme), this.config.spacing),
         invalidate: () => {}, // Theme and extension statuses are read fresh on every render.
         dispose: () => this.stopResources(),
       };

package/src/types.ts

@@ -33,6 +33,8 @@ export interface StatuslineConfig {
   pathMode: "basename" | "abbreviated" | "full";
   modelDisplay: "name" | "last";
   contextDisplay: "text" | "bar";
+  /** Blank lines rendered above the statusline, between the editor and the footer (0–3). */
+  spacing: number;
   segments: SegmentConfig[];
   runtime: RuntimeConfig;
 }