pi-footer-dock 0.1.3 → 0.1.4

package/CHANGELOG.md

@@ -4,6 +4,27 @@ All notable changes to Footer Dock are listed here. The format follows [Keep a C
 
 ## [Unreleased]
 
+## [0.1.4] - 2026-11-14
+
+### Added
+
+- **Icons choose themselves on terminals that cannot show Nerd Font symbols.** With no icon choice saved (Appearance › Icons now starts at "automatic" and says which set that is: "automatic (Nerd Font)" or "automatic (plain symbols)"), Footer Dock uses the plain symbols instead of the Nerd Font set on a Linux console, a `dumb` terminal, or a locale that names a legacy character set (for example `en_US.ISO-8859-1`); a locale of plain `C` or `POSIX` is not treated as a sign. Everyone else keeps the Nerd Font set, with the one-time note about empty boxes (not shown when the plain symbols were chosen automatically). A saved choice always wins, and nothing is written to the settings file. The five icons of the plain symbol set that only other extensions use are now `…`, `○`, `i`, `@` and `*` (all one cell wide, none an emoji; the footer's own icons are unchanged), and the extension guide no longer calls the portable set plain ASCII.
+- **A meter look that does not depend on the font.** The new quota option `meterStyle` (`slanted`, the default and today's `▰▱`; `line` `━─`; `blocks` `█░`) changes the characters of the limit meter and nothing else: still seven cells, the same fill, colours and animation. `line` and `blocks` are characters most terminals draw themselves, so they look the same in any font (the slanted blocks show as a thick and a dotted line in some, for example Ghostty with its default font). Choose it under Appearance › Meter look, or with `/dock-config`. Versions before 0.1.4 reject a settings file that contains `meterStyle`.
+- **Every colour of the footer can be changed.** Seven roles: `accent` (icons, the model name and the limit meter), `text`, `muted` (labels and separators), `highlight` (the context bar, the changed-files count, the compaction notice), `warning`, `error` and `success`. Each is `theme` (the theme's own colour), a `#rrggbb` hex, or for two of them one more named choice. Set them on the settings screen (Appearance › Colours), with the new `/dock-color` command (`/dock-color accent #aa55cc`, `/dock-color reset`), or as `"colors"` in the settings file. See "Colours" in `docs/footer-configuration.md`. Versions before 0.1.4 reject a settings file that contains `colors` or `iconBold`, so after going back remove those lines.
+- **Bold icons for the plain symbols, on by default.** The plain icons (`/dock-glyphs`) are drawn in bold; `"iconBold": false`, the "Bold icons" row or `/dock-color bold off` turns it off. It never changes the width of anything. Nerd Font symbols have a single weight, so bold shows nothing on them and Footer Dock does not apply it there; `/dock-color bold on` says so.
+- **The footer reads on your terminal's real background.** Footer Dock asks the terminal for its background colour (through Pi's own colour query, once when Pi starts and again when the terminal switches between light and dark). Any colour the theme supplies that would be hard to read on that background is lightened or darkened, keeping its hue, until it reaches a minimum contrast (4.5:1 for text and highlights, 3:1 for labels, warnings, errors, success and the accent). A theme that matches the terminal is drawn exactly as before. This fixes the footer fading out when the Pi theme is `light` on a dark terminal (or `dark` on a light one). A terminal that does not answer changes nothing. A colour you typed is never changed; `/dock-color` warns when it would be hard to read, and with no arguments it says what background it found.
+- **`terminal` for the text and label colours.** `/dock-color text terminal` and `/dock-color muted terminal` use your terminal's own default colour (labels in its faint form), which is always readable and needs no query.
+
+### Changed
+
+- **For contributors: secret scanning and no comments in code.** `scripts/check-secrets.sh` runs gitleaks before every commit and push (after `sh scripts/install-hooks.sh`), in the gate and in a new `secrets` job of the Check workflow, and refuses credential files by name. The code carries no comments (`npm run comments`, part of `npm run check`); the reasons are in the documents. `scripts/check-hygiene.sh` also fails when a public file names a file the export leaves out. See `CONTRIBUTING.md`.
+- **The settings screen is easier to read and to use.** Icons, bold icons and the colours now sit together under a new **Appearance** entry, the first one on the menu (the top level has seven entries instead of eight). Each colour row shows a swatch of the colour it really draws and a word (`██ lavender, adapted to your theme`); Enter opens a short picker (default, the other named choices, your own colour, "Type a colour…"), and the field takes a `#rrggbb` with a preview and its contrast on your terminal's background, so a custom colour no longer needs a command. The rows were renamed so that a row that shows or hides something is named by the thing and a row that chooses is named by the question: for the limit usage "Window: 5h", "Percent shown", "Meter", "Reset time", "Collapse windows" (with "Keep 5h" inside), "Start expanded", "Animate changes"; "Model: provider" and "Model: name" became "Provider" and "Model name"; "Item clicks" became "Clicking an item" (`act` or `explain`). The choices of every item row now read "hidden when the row is a bit tight" and so on instead of "hidden from lg". Nothing in the settings file changed.
+
+- **The default accent is our lavender, adapted to your theme and terminal.** Icons and the model name used to take the theme's accent and the limit meter a fixed lavender; now all three are one colour. It keeps the lavender hue and takes its lightness from the theme's accent (so it follows Pi's `system` theme and your terminal's colours), and is moved away from the background if the contrast would be under 3:1. Choose `theme` for the accent (`/dock-color accent theme`) to get the icon and model-name colours of 0.1.3 back. The old quota option `meterColor` still works and now means the accent: `"theme"` sets the accent to `theme`; the row "Meter colour" on the settings screen is replaced by "Accent colour".
+- **Warnings are separate from highlights, and healthy numbers are no longer yellow.** The context bar and its percentage, the changed-files count and the compaction notice were drawn in the warning colour at every level, so a healthy footer already had yellow on it and a real warning had nothing to stand out against. They now use a calm `highlight` colour (the theme's text colour); the warning and error colours are kept for limits at 25% or less, blocked limits and the problems marker. Set `highlight` to `warning` for the 0.1.3 look.
+- **The plain symbols (`/dock-glyphs`, Appearance › Icons, formerly called "portable"; the settings file still says `portable`) have new symbols.** `⌂` folder, `Y` branch, `◔` context, `≡` cache, `∴` thinking, `»` speed, `↻` reset. The old speed symbol `⚡` is drawn as an emoji, two cells wide, in many terminals and misaligned the row; the old reset symbol `◌` was drawn badly in some fonts. The Nerd Font set is unchanged.
+- The quota's reset icon now follows the icon colour and bold setting like every other icon.
+
 ## [0.1.3] - 2026-11-07
 
 ### Added

package/README.md

@@ -28,7 +28,7 @@ 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.
+**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 nearly every font has (`/dock-glyphs` again switches back), or install a Nerd Font. Footer Dock mentions this once, the first time it starts. On a Linux console, a `dumb` terminal or a terminal with a legacy character set it picks the plain symbols by itself; a choice in Appearance › Icons always wins.
 
 ## What the footer shows
 
@@ -112,22 +112,23 @@ Other providers show no limits (`quota unsupported`); OpenAI-style APIs that sen
 ## Requirements
 
 - Pi 1.2 or newer, and Node.js 22.19 or newer (the same as Pi).
-- A terminal with mouse support for clicking (everything also works from the keyboard and with `/dock-*` commands). A Nerd Font gives the best icons; `/dock-glyphs` switches to portable symbols.
+- A terminal with mouse support for clicking (everything also works from the keyboard and with `/dock-*` commands). A Nerd Font gives the best icons; `/dock-glyphs` switches to plain symbols.
 - Tested on Linux. macOS and Windows are expected to work; opening the project folder with the system file manager has not been run on them yet.
 
 ## Commands
 
-| Command               | What it does                                               |
-| --------------------- | ---------------------------------------------------------- |
-| `/dock-settings`      | The settings menu                                          |
-| `/dock-info [item]`   | Explains a footer item                                     |
-| `/dock-quota`         | Shows or hides the collapsed limit windows                 |
-| `/dock-open`          | Opens the project folder in your file manager              |
-| `/dock-open-with ...` | Chooses another app for that, for example `thunar {path}`  |
-| `/dock-glyphs`        | Switches between Nerd Font and portable icons              |
-| `/dock-refresh`       | Reads Git and usage again                                  |
-| `/dock-config ...`    | Session-only footer configuration as JSON                  |
-| `/dock-debug`         | Safe diagnostics for a bug report (no content, no secrets) |
+| Command               | What it does                                                |
+| --------------------- | ----------------------------------------------------------- |
+| `/dock-settings`      | The settings menu                                           |
+| `/dock-info [item]`   | Explains a footer item                                      |
+| `/dock-quota`         | Shows or hides the collapsed limit windows                  |
+| `/dock-open`          | Opens the project folder in your file manager               |
+| `/dock-open-with ...` | Chooses another app for that, for example `thunar {path}`   |
+| `/dock-glyphs`        | Switches between Nerd Font icons and plain symbols          |
+| `/dock-color ...`     | Footer colours and bold icons, for example `accent #aa55cc` |
+| `/dock-refresh`       | Reads Git and usage again                                   |
+| `/dock-config ...`    | Session-only footer configuration as JSON                   |
+| `/dock-debug`         | Safe diagnostics for a bug report (no content, no secrets)  |
 
 ## Large repositories