@marcosgilf/pi-footer 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Marcos Gil
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,19 @@
-# Temporary Holding Version
+# pi-footer
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Single owner for Pi's custom footer. It loads `pi-session` and `pi-usage`, then combines their data and click actions. Both feature extensions use `pi-modal` for details.
+
+## Install
+
+```sh
+pi install npm:@marcosgilf/pi-footer
+```
+
+`pi-footer` loads `pi-session` and `pi-usage` from package dependencies. Remove separate `npm:@marcosgilf/pi-session` and `npm:@marcosgilf/pi-usage` entries from Pi settings to avoid loading either extension twice.
+
+- Click context indicator to open session details.
+- Click Copilot plan usage to open quota details.
+- Wide terminals combine session/skill info on the left and usage/model info on the right; narrow terminals stack usage/model and session/skill lines.
+- `/session-usage` and Command+Shift+S (`super+shift+s`) open session details.
+- `/copilot-usage` and `super+shift+u` open Copilot details.
+
+Pi extensions run with Pi's operating-system permissions. Review package source before installing.

package/package.json

@@ -1,6 +1,36 @@
 {
   "name": "@marcosgilf/pi-footer",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "One Pi footer that combines session and Copilot usage extensions.",
+  "type": "module",
+  "license": "MIT",
+  "private": false,
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi",
+    "footer",
+    "statusline"
+  ],
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "dependencies": {
+    "@marcosgilf/pi-session": "^0.1.0",
+    "@marcosgilf/pi-usage": "^0.2.0"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
+}

package/src/index.ts

@@ -0,0 +1,125 @@
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { type TuiMouseEvent, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import registerSession from "@marcosgilf/pi-session";
+import { getContextUsageStyle } from "@marcosgilf/pi-session/core";
+import { OPEN_SESSION_USAGE_EVENT, SESSION_USAGE_STATUS_KEY } from "@marcosgilf/pi-session/events";
+import registerUsage from "@marcosgilf/pi-usage";
+import { COPILOT_USAGE_STATUS_KEY, OPEN_COPILOT_USAGE_EVENT } from "@marcosgilf/pi-usage/events";
+
+type ClickBounds = { left: number; right: number };
+
+function usageStyle(text: string): "warning" | "accent" {
+  const match = text.match(/(?:^|\s)(\d+(?:\.\d+)?)%/);
+  return match && Number(match[1]) >= 90 ? "warning" : "accent";
+}
+
+function addCustomFooter(ctx: ExtensionContext, pi: ExtensionAPI): void {
+  ctx.ui.setFooter((tui, theme, footerData) => {
+    let disposed = false;
+    const requestRender = () => {
+      if (!disposed) tui.requestRender();
+    };
+    const unsubscribe = footerData.onBranchChange(requestRender);
+    let usageClickBounds: ClickBounds | undefined;
+    let contextClickBounds: ClickBounds | undefined;
+    let usageClickRow = 1;
+    let contextClickRow = 1;
+
+    return {
+      dispose() {
+        disposed = true;
+        unsubscribe();
+      },
+      handleMouse(event: TuiMouseEvent) {
+        if (event.button !== "left" || event.type !== "click") return;
+        const clickedUsage =
+          event.y === usageClickRow &&
+          usageClickBounds !== undefined &&
+          event.x >= usageClickBounds.left &&
+          event.x < usageClickBounds.right;
+        const clickedContext =
+          event.y === contextClickRow &&
+          contextClickBounds !== undefined &&
+          event.x >= contextClickBounds.left &&
+          event.x < contextClickBounds.right;
+        if (!clickedUsage && !clickedContext) return;
+        pi.events.emit(clickedContext ? OPEN_SESSION_USAGE_EVENT : OPEN_COPILOT_USAGE_EVENT, undefined);
+        return { handled: true, render: true };
+      },
+      invalidate() {},
+      render(width: number) {
+        const contextText = footerData.getExtensionStatuses().get(SESSION_USAGE_STATUS_KEY) ?? "";
+        const contextPercent = Number.parseFloat(contextText);
+        const contextLabel = contextText
+          ? theme.fg(getContextUsageStyle(Number.isFinite(contextPercent) ? contextPercent : null), contextText)
+          : "";
+
+        const model = ctx.model;
+        const modelName = model?.name || model?.id || "no-model";
+        const thinking = model?.reasoning ? ` • ${ctx.thinkingLevel || "off"}` : "";
+        let modelText = `${modelName}${thinking}`;
+        if (footerData.getAvailableProviderCount() > 1 && model) modelText = `(${model.provider}) ${modelText}`;
+
+        const usageText = footerData.getExtensionStatuses().get(COPILOT_USAGE_STATUS_KEY) ?? "";
+        const usageLabel = usageText ? theme.fg(usageStyle(usageText), usageText) : "";
+        const right = usageLabel ? `${usageLabel} · ${modelText}` : modelText;
+        const clippedRight = truncateToWidth(right, width, "");
+        const rightWidth = visibleWidth(clippedRight);
+        const usageWidth = visibleWidth(usageLabel);
+        const usageRight = Math.min(usageWidth, rightWidth);
+        const home = process.env.HOME || "";
+        let cwd = home && ctx.cwd.startsWith(`${home}/`) ? `~${ctx.cwd.slice(home.length)}` : ctx.cwd;
+        const branch = footerData.getGitBranch();
+        if (branch) cwd += ` (${branch})`;
+        const sessionName = ctx.sessionManager.getSessionName();
+        if (sessionName) cwd += ` • ${sessionName}`;
+
+        const statuses = Array.from(footerData.getExtensionStatuses().entries())
+          .filter(([key]) => key !== SESSION_USAGE_STATUS_KEY && key !== COPILOT_USAGE_STATUS_KEY)
+          .sort(([a], [b]) => a.localeCompare(b))
+          .map(([, text]) => text);
+        const statusText = [contextLabel, statuses.join(" ")].filter(Boolean).join(" · ");
+        const statusWidth = visibleWidth(statusText);
+        const statusLine = truncateToWidth(statusText, width, theme.fg("dim", "..."));
+        const statusClickRight = Math.min(visibleWidth(contextLabel), visibleWidth(statusLine));
+        const lines = [truncateToWidth(theme.fg("dim", cwd), width, theme.fg("dim", "..."))];
+
+        if (statusText && statusWidth + rightWidth + 2 <= width) {
+          const rightLeft = width - rightWidth;
+          lines.push(`${statusText}${" ".repeat(Math.max(0, rightLeft - statusWidth))}${clippedRight}`);
+          contextClickBounds = contextLabel ? { left: 0, right: statusClickRight } : undefined;
+          usageClickBounds = usageRight > 0 ? { left: rightLeft, right: rightLeft + usageRight } : undefined;
+          contextClickRow = 1;
+          usageClickRow = 1;
+        } else if (statusText) {
+          lines.push(clippedRight, statusLine);
+          contextClickBounds = contextLabel ? { left: 0, right: statusClickRight } : undefined;
+          usageClickBounds = usageRight > 0 ? { left: 0, right: usageRight } : undefined;
+          contextClickRow = 2;
+          usageClickRow = 1;
+        } else {
+          lines.push(`${" ".repeat(Math.max(0, width - rightWidth))}${clippedRight}`);
+          contextClickBounds = undefined;
+          usageClickBounds =
+            usageRight > 0 ? { left: width - rightWidth, right: width - rightWidth + usageRight } : undefined;
+          contextClickRow = 1;
+          usageClickRow = 1;
+        }
+
+        return lines;
+      },
+    };
+  });
+}
+
+export default function (pi: ExtensionAPI): void {
+  registerSession(pi);
+  registerUsage(pi);
+
+  pi.on("session_start", (_event, ctx) => {
+    if (ctx.mode === "tui") addCustomFooter(ctx, pi);
+  });
+  pi.on("session_shutdown", (_event, ctx) => {
+    if (ctx.mode === "tui") ctx.ui.setFooter(undefined);
+  });
+}