pi-minimal-footer 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -7,6 +7,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-09-01
+
+### Changed
+
+- Updated the Node.js engine declaration to match current Pi releases (`>=22.19.0`)
+- README polish: remove internal API jargon, fix `e.g.,` comma, tighten config section
+
+### Fixed
+
+- Keep merged footer settings non-optional so the extension passes strict TypeScript checks
+- Footer no longer overflows on narrow terminal windows — truncate the path (then the right side) to fit the terminal width using pi-tui's `truncateToWidth`, instead of emitting a line wider than the terminal (which crashed pi)
+
+## [0.1.1] - 2026-06-15
+
+### Added
+
+- Preview screenshot (`preview.png`) and `pi.image` gallery metadata for pi.dev/packages
+- README badges: npm version, downloads, and license
+- Screenshot preview rendered directly in README
+
+### Changed
+
+- Model and context usage rendered in **bold** for better at-a-glance scanning
+- README tagline tightened to "A clean, compact one-line footer for pi."
+
+### Fixed
+
+- Skills segment no longer shows trailing `|` separator when one skill has an empty status value
+
 ## [0.1.0] - 2026-06-15
 
 First npm-ready release.
@@ -36,6 +65,8 @@ First npm-ready release.
 
 - Project scaffold — `extensions/index.ts` with basic footer structure, `package.json` with pi extension manifest, `README.md`, `LICENSE` (MIT)
 
-[Unreleased]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.1.2...HEAD
+[0.1.2]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.1.1...v0.1.2
+[0.1.1]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/Ryu-CZ/pi-minimal-footer/compare/v0.0.0...v0.1.0
 [0.0.0]: https://github.com/Ryu-CZ/pi-minimal-footer/releases/tag/v0.0.0

package/README.md

@@ -1,13 +1,32 @@
 # pi-minimal-footer
 
-A minimal footer extension for [pi](https://github.com/earendil-works/pi-coding-agent) that replaces the default footer with a clean, compact status line:
+<p>
+  <a href="https://www.npmjs.com/package/pi-minimal-footer">
+    <img src="https://img.shields.io/npm/v/pi-minimal-footer" alt="npm version">
+  </a>
+  <a href="https://www.npmjs.com/package/pi-minimal-footer">
+    <img src="https://img.shields.io/npm/dt/pi-minimal-footer" alt="npm downloads">
+  </a>
+  <a href="LICENSE">
+    <img src="https://img.shields.io/npm/l/pi-minimal-footer" alt="license">
+  </a>
+  <a href="https://pi.dev/packages/pi-minimal-footer">
+    <img src="https://img.shields.io/badge/pi-package-1a1a2e" alt="pi package">
+  </a>
+</p>
+
+A clean, compact one-line footer for [Pi](https://github.com/earendil-works/pi).
 
 ```
 ~/path/to/dir                (skill1 | skill2)   main  sonnet  12/128k
 ```
 
+![pi-minimal-footer screenshot](media/github-preview.png)
+
 ## Install
 
+Available on the [Pi package gallery](https://pi.dev/packages/pi-minimal-footer).
+
 ```bash
 # From npm (recommended)
 pi install npm:pi-minimal-footer
@@ -25,10 +44,10 @@ ln -s "$PWD/extensions" ~/.pi/agent/extensions/minimal-footer
 ## Features
 
 - **Working directory** — relative path from home (`~/...`)
-- **Active skills** — extension statuses from `ctx.ui.setStatus()`
+- **Active skills** — extensions reporting their current status
 - **Git branch** — current branch name
 - **Model** — active model ID
-- **Context usage** — tokens used / context window (e.g. `12/128k`)
+- **Context usage** — tokens used / context window (e.g., `12/128k`)
 
 ## Commands
 
@@ -38,11 +57,11 @@ ln -s "$PWD/extensions" ~/.pi/agent/extensions/minimal-footer
 | `/minfooter on` | Enable |
 | `/minfooter off` | Disable |
 
-> The `/minfooter` command only controls the `enabled` setting. To tweak individual segments (path, model, etc.), edit `~/.pi/agent/settings.json` directly.
+> The `/minfooter` command only toggles the `enabled` flag. To show or hide individual segments, edit `~/.pi/agent/settings.json` directly.
 
 ## Configuration
 
-Settings are persisted in `~/.pi/agent/settings.json` under the `minFooter` key:
+Settings live in `~/.pi/agent/settings.json` under the `minFooter` key:
 
 ```json
 {
@@ -56,5 +75,3 @@ Settings are persisted in `~/.pi/agent/settings.json` under the `minFooter` key:
   }
 }
 ```
-
-Edit the file directly to show or hide individual segments. The `/minfooter` command is a shortcut that toggles only the `enabled` flag.

package/extensions/index.ts

@@ -11,7 +11,7 @@
  */
 
 import type { ExtensionAPI, ExtensionContext, ReadonlyFooterDataProvider } from "@earendil-works/pi-coding-agent";
-import { visibleWidth } from "@earendil-works/pi-tui";
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { homedir } from "node:os";
@@ -29,7 +29,9 @@ interface Settings {
   };
 }
 
-const DEFAULT_SETTINGS: Settings["minFooter"] = {
+type FooterSettings = NonNullable<Settings["minFooter"]>;
+
+const DEFAULT_SETTINGS: FooterSettings = {
   enabled: true,
   showGitBranch: true,
   showSkills: true,
@@ -67,7 +69,7 @@ function readEnabled(): boolean {
   return s.minFooter?.enabled !== false; // default to true
 }
 
-function readConfig(): Settings["minFooter"] {
+function readConfig(): FooterSettings {
   const s = readSettings();
   return { ...DEFAULT_SETTINGS, ...s.minFooter };
 }
@@ -130,13 +132,14 @@ function buildLeft(): string {
   return state.cwd;
 }
 
-function buildRight(footerData: ReadonlyFooterDataProvider): string {
+function buildRight(footerData: ReadonlyFooterDataProvider, bold: (s: string) => string): string {
   const segments: string[] = [];
 
   if (config.showSkills) {
     const statuses = footerData.getExtensionStatuses();
-    if (statuses.size > 0) {
-      segments.push("(" + [...statuses.values()].join(" | ") + ")");
+    const skillNames = [...statuses.values()].filter(s => s.trim());
+    if (skillNames.length > 0) {
+      segments.push("(" + skillNames.join(" | ") + ")");
     }
   }
 
@@ -146,11 +149,11 @@ function buildRight(footerData: ReadonlyFooterDataProvider): string {
   }
 
   if (config.showModel) {
-    segments.push(state.model);
+    segments.push(bold(state.model));
   }
 
   if (config.showContext) {
-    segments.push(state.context);
+    segments.push(bold(state.context));
   }
 
   return segments.join("  ");
@@ -174,13 +177,18 @@ export default function (pi: ExtensionAPI) {
         return {
           render(width: number): string[] {
             const left = buildLeft();
-            const right = buildRight(footerData);
-            const leftW = visibleWidth(left);
+            const right = buildRight(footerData, (s) => theme.bold(s));
             const rightW = visibleWidth(right);
-            const gap = Math.max(1, width - leftW - rightW);
-            const spacer = " ".repeat(gap);
-            const line = theme.fg("dim", `${left}${spacer}${right}`);
-            return [line];
+
+            // If the right side (model + context) alone doesn't fit, drop the path and truncate it.
+            if (rightW >= width) {
+              return [theme.fg("dim", truncateToWidth(right, width, ""))];
+            }
+
+            // Otherwise keep the right side intact and fit the path into the remaining
+            // space (padded to exactly fill it, keeping the right side right-aligned).
+            const leftPart = truncateToWidth(left, width - rightW - 1, "...", true);
+            return [theme.fg("dim", `${leftPart} ${right}`)];
           },
           invalidate(): void {},
           dispose: unsub,

package/package.json

@@ -1,8 +1,14 @@
 {
   "name": "pi-minimal-footer",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "A minimal footer extension for pi — clean status line with path, skills, model, and context usage.",
-  "keywords": ["pi-package", "pi-extension", "pi", "footer", "minimal"],
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi",
+    "footer",
+    "minimal"
+  ],
   "homepage": "https://github.com/Ryu-CZ/pi-minimal-footer#readme",
   "bugs": {
     "url": "https://github.com/Ryu-CZ/pi-minimal-footer/issues"
@@ -14,10 +20,11 @@
     "extensions/",
     "LICENSE",
     "README.md",
-    "package.json"
+    "package.json",
+    "media/"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=22.19.0"
   },
   "repository": {
     "type": "git",
@@ -28,6 +35,9 @@
     "@earendil-works/pi-tui": "*"
   },
   "pi": {
-    "extensions": ["./extensions"]
+    "extensions": [
+      "./extensions"
+    ],
+    "image": "https://raw.githubusercontent.com/Ryu-CZ/pi-minimal-footer/main/media/preview.png"
   }
 }