pi-minimal-footer 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -7,12 +7,25 @@ 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
 
@@ -52,7 +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.1...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

@@ -10,16 +10,23 @@
   <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-coding-agent).
+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
@@ -37,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
 
@@ -50,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
 {
@@ -68,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 };
 }
@@ -176,12 +178,17 @@ export default function (pi: ExtensionAPI) {
           render(width: number): string[] {
             const left = buildLeft();
             const right = buildRight(footerData, (s) => theme.bold(s));
-            const leftW = visibleWidth(left);
             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,6 +1,6 @@
 {
   "name": "pi-minimal-footer",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "A minimal footer extension for pi — clean status line with path, skills, model, and context usage.",
   "keywords": [
     "pi-package",
@@ -24,7 +24,7 @@
     "media/"
   ],
   "engines": {
-    "node": ">=18"
+    "node": ">=22.19.0"
   },
   "repository": {
     "type": "git",