pi-footer-dock 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to Footer Dock are listed here. The format follows [Keep a C
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-10-20
+
+### Added
+
+- The first time Footer Dock starts for a user who never chose an icon set, it says once what to do if the icons look like empty boxes (`/dock-glyphs`, or install a Nerd Font). It is remembered in the settings file as `glyphHintShown`; a settings file that had to be ignored is never rewritten for this. The README now says in the Install section that the icons need a Nerd Font. **New setting:** `glyphHintShown` (written automatically; you never need to set it). Versions before 0.1.2 reject a settings file that contains it, so after going back to 0.1.1 or 0.1.0 delete that line.
+- The package manifest now names the launch video (`pi.video`), so the package page on pi.dev can play it. The video is hosted by GitHub as an attachment (the same one the README plays); it is not part of the npm package.
+
+### Fixed
+
+- The cost screen's bar of dollars by category sat directly under the "This session" and "This month" lines; there is now a blank row between them, as on the other screens.
+
 ## [0.1.1] - 2026-10-19
 
 ### Changed

package/README.md

@@ -8,6 +8,10 @@
 [![Pi 1.2 and 1.3](https://img.shields.io/badge/Pi-1.2%20%7C%201.3-b4befe)](#requirements)
 [![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](CONTRIBUTING.md)
 
+https://github.com/user-attachments/assets/2f7eab93-210e-40e2-8736-d7cc64520ccc
+
+_The 30-second tour, also [on YouTube](https://youtu.be/fkBa8wB2_YI)._
+
 **A two-row status footer for [Pi](https://pi.dev) that tells you what is going on.** Git, model, context, tokens, cache, speed, provider limits and cost, in two rows that fit your terminal, with an explanation behind every value.
 
 ![Footer Dock on a wide terminal](docs/images/footer-wide.png)
@@ -24,6 +28,8 @@ pi install npm:pi-footer-dock
 
 Then restart Pi (or run `/reload`). That is all. Full instructions, updating, removing and troubleshooting: **[SETUP.md](SETUP.md)**.
 
+**Icons need a [Nerd Font](https://www.nerdfonts.com/) in your terminal.** If the icons show up as empty boxes, your font does not have them: run `/dock-glyphs` for plain symbols that every font has, or install a Nerd Font. Footer Dock mentions this once, the first time it starts.
+
 ## What the footer shows
 
 | Item           | What it is                                                                         | Click the icon                            | Click the text |

package/dist/index.js

@@ -364,6 +364,9 @@ function say(ctx, text, level = "info") {
   } catch {
   }
 }
+var sayAt = (ctx, level = "info") => (text) => {
+  say(ctx, text, level);
+};
 
 // src/open-with-command.ts
 function runOpenWith(args, ctx, settings) {
@@ -4554,7 +4557,16 @@ var ownOption = (id, key) => {
   if (id === "quota") return QUOTA_ONLY.includes(key);
   return id === "compaction" && key === "unit" || id === "cost" && key === "period";
 };
-var KEYS = ["version", "glyphs", "quotaExpanded", "clicks", "openWith", "limits", "slots"];
+var KEYS = [
+  "version",
+  "glyphs",
+  "glyphHintShown",
+  "quotaExpanded",
+  "clicks",
+  "openWith",
+  "limits",
+  "slots"
+];
 var defaultSettings = () => ({ version: 1, slots: {} });
 var settingsItems = () => [...slotHelp.keys()].filter((id) => id !== QUOTA_TOGGLE);
 function slots(value) {
@@ -4579,15 +4591,19 @@ function parseSettings(value) {
   if (data.slots !== void 0) result.slots = slots(data.slots);
   return result;
 }
+function readFlags(data, result) {
+  for (const key of ["glyphHintShown", "quotaExpanded"]) {
+    if (data[key] === void 0) continue;
+    if (typeof data[key] !== "boolean") throw new Error(`${key} must be boolean`);
+    result[key] = data[key];
+  }
+}
 function readChoices(data, result) {
   if (data.glyphs !== void 0) {
     if (data.glyphs !== "nerd" && data.glyphs !== "portable") throw new Error("Invalid glyph set");
     result.glyphs = data.glyphs;
   }
-  if (data.quotaExpanded !== void 0) {
-    if (typeof data.quotaExpanded !== "boolean") throw new Error("quotaExpanded must be boolean");
-    result.quotaExpanded = data.quotaExpanded;
-  }
+  readFlags(data, result);
   if (data.limits !== void 0) {
     if (data.limits !== "on" && data.limits !== "off") throw new Error("limits must be on or off");
     result.limits = data.limits;
@@ -7370,7 +7386,7 @@ var cost = {
           sessionFact(estimate, priced),
           ...headlineFact(snapshot.history, period ?? "month", new Date(now))
         ),
-        ...priced ? [categoryBar(breakdown)] : []
+        ...priced ? [gap, categoryBar(breakdown)] : []
       ],
       body: [
         ...priced ? pricedBody(breakdown) : [],
@@ -8424,6 +8440,7 @@ var FooterInteractions = class {
 };
 
 // src/settings-controller.ts
+var GLYPH_HINT = `${PRODUCT}: if the icons look like empty boxes, your terminal font has no Nerd Font symbols. Run /dock-glyphs for plain symbols, or install a Nerd Font.`;
 var SettingsController = class {
   constructor(store) {
     this.store = store;
@@ -8441,12 +8458,26 @@ var SettingsController = class {
   followSavedGlyphs() {
     this.toggled = void 0;
   }
+  /** Set while the file on disk was ignored: it must not be overwritten with defaults. */
+  ignored = false;
   /** Re-reads the file; says why through `report` if it had to be ignored. */
   load(report) {
     const { settings, problem } = this.store.load();
     this.current = settings;
+    this.ignored = problem !== void 0;
     if (problem) report(`${PRODUCT} settings ignored: ${problem}.`);
   }
+  /**
+   * Once, for a user who never chose an icon set: what to do if the icons are not drawn (a
+   * terminal cannot tell us its font). Never touches a file that was ignored; a failed save only
+   * means the note may come again.
+   */
+  announceGlyphs(report) {
+    const { glyphs, glyphHintShown } = this.current;
+    if (this.ignored || glyphs !== void 0 || glyphHintShown) return;
+    report(GLYPH_HINT);
+    this.update({ ...this.current, glyphHintShown: true });
+  }
   /** Applies a change in memory first, so the footer follows even if saving fails. */
   update(next) {
     this.current = next;
@@ -9359,9 +9390,8 @@ var DockRuntime = class {
     this.stop();
     if (ctx.mode !== "tui") return;
     ctx.ui.setFooter(void 0);
-    this.settings.load((message) => {
-      say(ctx, message, "warning");
-    });
+    this.settings.load(sayAt(ctx, "warning"));
+    this.settings.announceGlyphs(sayAt(ctx));
     this.ctx = ctx;
     this.trackers.start(ctx);
     this.live = this.usage.capture(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-footer-dock",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "A two-row status footer for Pi: Git, model, context, tokens, cache, speed, provider limits and cost, with explanations behind every value.",
   "type": "module",
   "license": "Apache-2.0",
@@ -41,7 +41,8 @@
     "extensions": [
       "./dist/index.js"
     ],
-    "image": "https://raw.githubusercontent.com/KKhosla7/pi-footer-dock/main/docs/images/footer-wide.png"
+    "image": "https://raw.githubusercontent.com/KKhosla7/pi-footer-dock/main/docs/images/footer-wide.png",
+    "video": "https://github.com/user-attachments/assets/2f7eab93-210e-40e2-8736-d7cc64520ccc"
   },
   "scripts": {
     "format": "prettier --write .",