@xzzpig/pi-starline 0.5.0 → 0.7.1

package/FORK-CHANGELOG.md

@@ -0,0 +1,28 @@
+# Fork release notes
+
+## 0.7.1 — Pi cursor compatibility
+
+- Restore `underline` and `terminal` editor cursor styles on Pi 1.2 and later while preserving the existing Pi 1.1 cursor path.
+- The previous published fork version was 0.5.1. This release also includes the upstream syncs and fork changes recorded in 0.6.0 and 0.7.0 below.
+
+## 0.7.0 — Upstream v0.9.0 sync
+
+- Adopt the compact editor layout, `editorMinRows`, configurable pill row, live throughput, and turn timing. The old editor metadata row is removed and its status placement maps to the right-hand footer.
+- Retain Starline's user-message renderer, its padding and colour settings, and the shared editor/message colour controls. If pi-tidy also styles messages, patch order can determine the visible renderer; set `tidy.userMessageStyle` to `"off"` to leave user messages to Starline.
+- Preserve the fork's shared mouse, clipboard and wheel integrations, pi-zentui markers, and group-expand compatibility. Clean-copy supports the configured Starline rail alongside upstream pi-tidy frames.
+
+## 0.6.0 — Upstream v0.6.1 sync
+
+- Adopt upstream's pill-only status bar, clickable pills, bubbles and keyboard actions. The old text-footer configuration is removed.
+- Keep the fork's `pi-mouse-events` consumer, component expansion and group-target compatibility. Pill pointer requests and click-away use the shared mouse layer rather than a second Starline mouse patch.
+- Prefer Pi's native clipboard through the shared asynchronous copy slot when available; older v2 mouse-event publishers retain the existing OSC 52 fallback.
+- Route editor-wheel input through the shared post-component slot using Pi's calculated delta, including acceleration and Alt-wheel, while retaining the earlier fallback for older v2 publishers.
+- Ship upstream's public `types/pill-api.d.ts` along with the fork's built declarations and release notes.
+
+## 0.5.1 — Release candidate
+
+- Recognize the optional `@xzzpig/transcript-expand-target.v1` contract for group summary clicks. Invalid or absent providers fall back to the existing component resolver; no new mandatory package dependency or default-setting change.
+- Add `build:types` and `prepack` to include `dist/public.d.ts` alongside the extension sources.
+- Keep historical upstream/fork release notes in `CHANGELOG.md`; this fork-only file records the new compatibility release without expanding upstream documentation edits.
+
+Validated host: Pi 1.1.0. Native drag-selection acceptance and OpenSpec archival are release gates, not implied by a successful package build.

package/README.md

@@ -1,229 +1,139 @@
 # Starline
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Andy8647/pi-starline/main/assets/cover.png" alt="pi-starline: a statusline you can click" width="840">
+</p>
+
 A Starship-inspired statusline, Opencode-style editor chrome, and fullscreen mouse control for [Pi](https://pi.dev).
 
-> Starline is a fork of [pi-zentui](https://github.com/lmilojevicc/pi-zentui) by Luka, renamed and released on its own. It has diverged well past upstream and adds a pill footer style, a colour palette with `$ref` expansion, `model`/`thinking` footer segments, a git host icon, per-segment display options, configurable editor cursor styles, and mouse selection and copying.
+Starline makes Pi's fullscreen mode feel like a finished terminal app:
 
-## Screenshots
+- **See the state:** a pill footer with directory, git, runtime, model, context and cost; click one for the numbers behind it.
+- **Act on it:** click a pill to switch model or thinking level, see what is queued, or list running subagents.
+- **Type comfortably:** a compact bordered input box, paste collapse, and a `ctrl+g` hint for your `$EDITOR`.
+- **Drive with the mouse:** select and copy anywhere, click to move the caret, wheel to scroll the draft.
 
-![Starline](https://raw.githubusercontent.com/Andy8647/pi-starline/main/assets/starline.png)
+## Features
 
-## What is this?
+**Footer**
 
-Starline makes Pi's fullscreen mode feel like a finished terminal app — three
-pieces of one product, not a theme:
+- Starship-style segments: directory, git, runtime (57 runtimes), model, context, cost, plus optional session name, `user@host`, time, OS, session duration and project version.
+- A colour palette with `$name` references; the bar is built from `pill.segments`, in your order.
+- One `git` pill: branch, dirty markers and any operation in progress together. Click it for the changed files, ahead/behind and stashes. The list is read-only, because an agent may be running in the same tree.
+- One `context` pill: the percentage, and nothing else. Click it for the window size, tokens used, session in/out totals and the cache rate.
+- Other extensions' statuses from `ctx.ui.setStatus()` as pills, on either side or in the middle.
+- The model pill's icon spins while the agent works, and the pill counts the run's elapsed time; when the run ends the number stays as the total it reached.
+- No git pill on the bar means no `git status`: the refresh only reads the repository when something on the bar shows it.
 
-- **See the state** — a Starship-inspired statusline and pill footer: current directory, git branch and status, runtime/version detection, context usage and token counts in a compact, icon-rich format
-- **Type comfortably** — Opencode-style editor chrome: a clean bordered input box with accent rail and copy-friendly mode, model and provider inside the frame, paste collapse, and a `ctrl+g` hint pointing at your `$EDITOR` when a draft outgrows the box
-- **Drive with the mouse** — fullscreen mouse control: select and copy anywhere, click a tool box to expand just it, click to move the caret, wheel to scroll the draft — [see Mouse](#mouse-fullscreen-control)
+**Clickable pills**
 
-## Features
+- **Model:** pick from your scoped models (the ones ctrl+p cycles).
+- **Thinking:** pick a level from the ones the model supports.
+- **Queue:** an inbox icon and a count while messages wait; click to read them.
+- **Subagents:** with [pi-subagents](https://github.com/nicobailon/pi-subagents), a count of running subagents; click for agent, model, time and tokens, live.
+- **Your extension's pill:** a small published API lets any extension open the same bubble with its own content. See [Clickable pills for other extensions](https://github.com/Andy8647/pi-starline/blob/main/docs/pill-api.md).
+- Clicking anywhere else on screen closes the bubble, and the click still does what it would have done: the caret moves, the line gets selected.
+- Every action also runs from the keyboard as `/starline <name>`, and the pointer turns into a hand over anything clickable.
+
+**Editor**
+
+- Bordered input box with an accent rail, as tall as its text; paste, selection and `ctrl+g` hints ride its top rule. `editorMinRows` keeps it a fixed minimum height.
+- This fork retains Starline's full-width user-message rails and their existing colour and padding settings. If pi-tidy also styles messages, the visible renderer can depend on load order; set `tidy.userMessageStyle` to `"off"` in Pi's `settings.json` to leave user messages to Starline.
+- Copy-friendly mode drops the rail glyphs so terminal selection copies less chrome.
+
+**Mouse** (Pi's `tuiMode: "fullscreen"`)
 
-### Footer (Starship-inspired)
-
-- `dirname` — current directory (`basename` by default; optional `full` path with directory depth via `pathDisplay`)
-- `on  branch` — git branch with icon
-- `[!?↑]` — git status indicators (modified, untracked, ahead/behind, stashed, etc.)
-- `via  v5.5.0` — runtime detection with version and Starship-style Nerd Font runtime/language modules
-- Optional segments (off by default): session name, `user@host`, current time, OS icon, session duration, and the **project package version** (e.g. `package.json` → `0.6.0`) — distinct from the runtime segment, which shows the installed toolchain
-- Right side shows context usage, token counts, and cost
-- Built-in footer segments can be shown or hidden individually from `/starline`
-- Fully custom Starship-style layout via a `footerFormat` template string — see [Footer Format Template](https://github.com/Andy8647/pi-starline/blob/main/docs/configuration.md#footer-format-template)
-- Third-party Pi extension statuses from `ctx.ui.setStatus()` can be shown on the left,
-  middle, or right side of the footer, on the editor's metadata row, or hidden per
-  status key from `/starline`
-
-### Editor (Opencode-inspired)
-
-- Bordered input box with configurable accent rail and border colors
-- Model name and provider displayed inside the editor frame
-- Configurable model, provider, and thinking-level indicator colors
-- Prompt-box-style user messages matching the Starline input chrome
-- Copy-friendly mode hides editor and previous-message rail glyphs so terminal selection copies less chrome
-
-### Mouse (fullscreen control)
-
-The second half of the product: the statusline tells you where you are, the
-mouse lets you act on what you see. Starline drives Pi 0.84's own renderer
-(`tuiMode: "fullscreen"`) through the [`@xzzpig/pi-mouse-events`](https://www.npmjs.com/package/@xzzpig/pi-mouse-events)
-extension, which owns the renderer prototype and dispatches mouse events to
-components — the extension API stops at high-level hooks, and the selection
-hint, click-to-expand and clean-copy all need to reach into the renderer
-itself. Install it alongside Starline; without it Starline's mouse features
-are simply off (everything else keeps working).
-
-- **Select and copy anywhere.** Drag to select in the transcript or the input box; double-click a word (paths and kebab-case stay whole), triple-click a line. Releasing copies — or set Pi's `fullscreenCopyOnSelect: false` and the selection stays highlighted, waiting for the copy key ([Pi #7720](https://github.com/earendil-works/pi/issues/7720), shipped in Pi 0.84.4).
-- **Clean copies.** Transcript selections drop Starline's rails, rule rows and pi-toolbox frame borders before they reach the clipboard; editor selections copy the draft's text, not the painted rows.
-- **Selection hint.** A selection that is not auto-copying shows exactly how many characters the copy key (`ctrl+x` by default, whatever `app.message.copy` is bound to) will copy, and a selection inside the editor names your editor — `ctrl+g to edit in nvim`.
-- **Click to expand one component.** A plain click anywhere on a tool box — title, output, hint row, borders — toggles just that box (MCP boxes included); bash boxes, skill blocks, branch summaries, compaction summaries and custom entries count too. The direction comes from the hint row when one is on screen and from the component's own state otherwise, so a box with no hint left once expanded still closes on a click. Only a plain click toggles: dragging across a box still selects and copies, a double-click still word-selects, and a click on a link still opens it.
-- **Click to move the caret** in the input box; **backspace/delete remove a selected range**; the **wheel scrolls the draft** over the input box, and a draft taller than the box keeps the `ctrl+g` external-editor hint on screen.
-
-0.2.x's `fixedEditor` config block was renamed to `mouse` (migrated
-automatically, see [the changelog](CHANGELOG.md)); the fixed editor itself is
-gone, superseded by Pi's fullscreen mode.
-
-### Git Status Icons
-
-<details>
-<summary>The indicators and what they mean</summary>
-
-| Icon | Meaning    |
-| ---- | ---------- |
-| `!`  | Modified   |
-| `?`  | Untracked  |
-| `+`  | Staged     |
-| `✘`  | Deleted    |
-| `»`  | Renamed    |
-| `=`  | Conflicted |
-| `$`  | Stashed    |
-| `↑`  | Ahead      |
-| `↓`  | Behind     |
-| `⇕`  | Diverged   |
-
-</details>
-
-### Runtime Detection
-
-Detects Starship Nerd Font runtime/language modules, uses the Starship Nerd Font symbols, and keeps Starship-style defaults such as `bold green` for Node.js. By default Starline maps those styles through your active Pi theme; switch the Starship/footer color source to `terminal` in `/starline` if you want your terminal colorscheme to supply the exact ANSI colors.
-
-<details>
-<summary>All 57 detected runtimes and how they are recognised</summary>
-
-| Runtime/language | Detection examples                                            |
-| ---------------- | ------------------------------------------------------------- |
-| Buf              | `buf.yaml`, `buf.gen.yaml`, `buf.work.yaml`                   |
-| Bun              | `bun.lock`, `bun.lockb`                                       |
-| C                | `.c`, `.h` files                                              |
-| C++              | `.cpp`, `.cc`, `.cxx`, `.hpp` files                           |
-| CMake            | `CMakeLists.txt`, `CMakeCache.txt`                            |
-| COBOL            | `.cbl`, `.cob` files                                          |
-| Conda            | `CONDA_DEFAULT_ENV` environment                               |
-| Crystal          | `.cr` files, `shard.yml`                                      |
-| Dart             | `.dart` files, `pubspec.yaml`, `.dart_tool/`                  |
-| Deno             | `deno.json`, `deno.jsonc`, `deno.lock`                        |
-| .NET             | `.csproj`, `.fsproj`, `global.json`, `Directory.Build.*`      |
-| Elixir           | `mix.exs`                                                     |
-| Elm              | `.elm` files, `elm.json`, `elm-stuff/`                        |
-| Erlang           | `rebar.config`, `erlang.mk`                                   |
-| Fennel           | `.fnl` files                                                  |
-| Fortran          | `.f`, `.f90`, `.f95`, `.f03`, `.f08`, `.f18`, `fpm.toml`      |
-| Gleam            | `.gleam` files, `gleam.toml`                                  |
-| Go               | `go.mod`                                                      |
-| Gradle           | `build.gradle`, `build.gradle.kts`, `gradle/`                 |
-| Guix shell       | `GUIX_ENVIRONMENT` environment                                |
-| Haskell          | `.hs`, `.cabal`, `stack.yaml`, `cabal.project`                |
-| Haxe             | `.hx`, `.hxml`, `haxelib.json`, `.haxerc`                     |
-| Helm             | `helmfile.yaml`, `Chart.yaml`                                 |
-| Java             | `.java-version`                                               |
-| Julia            | `.jl` files, `Project.toml`, `Manifest.toml`                  |
-| Kotlin           | `.kt`, `.kts` files                                           |
-| Lua              | `.lua` files, `stylua.toml`, `.luarc.json`, `lua/` dir        |
-| Maven            | `pom.xml`                                                     |
-| Meson            | `MESON_DEVENV=1` and `MESON_PROJECT_NAME` environment         |
-| Mojo             | `.mojo` files                                                 |
-| Nim              | `.nim`, `.nims`, `.nimble`, `nim.cfg`                         |
-| Nix shell        | `IN_NIX_SHELL=pure` or `IN_NIX_SHELL=impure` environment      |
-| Node.js          | `package.json`, `.nvmrc`, `.node-version`                     |
-| OCaml            | `.opam`, `.ml`, `.mli`, `dune`, `_opam/`, `esy.lock/`         |
-| Odin             | `.odin` files                                                 |
-| OPA/Rego         | `.rego` files                                                 |
-| Perl             | `.pl`, `.pm`, `Makefile.PL`, `cpanfile`, `META.*`             |
-| PHP              | `composer.json`                                               |
-| Pixi             | `pixi.toml`, `pixi.lock`, `PIXI_ENVIRONMENT_NAME` environment |
-| Pulumi           | `Pulumi.yaml`, `Pulumi.yml`                                   |
-| PureScript       | `.purs` files, `spago.dhall`, `spago.yaml`, `spago.lock`      |
-| Python           | `pyproject.toml`, `requirements.txt`, `setup.py`, `Pipfile`   |
-| R                | `.R`, `.Rmd`, `.Rproj`, `DESCRIPTION`, `.Rproj.user/`         |
-| Raku             | `.raku`, `.rakumod`, `.p6`, `.pm6`, `META6.json`              |
-| Red              | `.red`, `.reds` files                                         |
-| Ruby             | `Gemfile`, `.ruby-version`                                    |
-| Rust             | `Cargo.toml`                                                  |
-| Scala            | `.scala`, `.sbt`, `build.sbt`, `.metals/`                     |
-| Solidity         | `.sol` files                                                  |
-| Spack            | `SPACK_ENV` environment                                       |
-| Swift            | `.swift` files, `Package.swift`                               |
-| Terraform        | `.tf`, `.tfplan`, `.tfstate`, `.terraform/`                   |
-| Typst            | `.typ` files, `template.typ`                                  |
-| Vagrant          | `Vagrantfile`                                                 |
-| V                | `.v` files, `v.mod`, `vpkg.json`                              |
-| Xmake            | `xmake.lua`                                                   |
-| Zig              | `.zig` files, `build.zig`                                     |
-
-</details>
+The fork's mouse enhancements use [`@xzzpig/pi-mouse-events`](https://www.npmjs.com/package/@xzzpig/pi-mouse-events) rather than installing a competing mouse patch. Install it alongside Starline; without it, these enhancements and pill click-away are disabled. Pi's own component clicks remain available. Version 0.3.0 or newer also shares pointer shapes, uses Pi's native clipboard when available, and routes editor scrolling with Pi's calculated wheel delta; older v2 installations fall back to the previous copy and wheel paths.
+
+- Drag to select in the transcript or the draft; double-click keeps paths and kebab-case whole; triple-click takes a line.
+- Clean copies: Starline's rails and rule rows and pi-toolbox frames are dropped before the clipboard.
+- A selection hint says how many characters the copy key will copy.
+- Click a tool, bash box, skill or summary to toggle that component; drag selection and links remain available.
+- Click to move the caret; backspace/delete remove a selected range; the wheel scrolls the draft.
+
+## Screenshots
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Andy8647/pi-starline/main/assets/starline.png" alt="Starline in a pi session: transcript, editor frame and pill bar" width="840">
+</p>
+
+A session as a whole: the transcript above, the editor frame in the middle, the bar along the bottom.
 
 ## Install
 
-Starline drives Pi 0.84's alternate-screen renderer, so it needs **Pi ≥ 0.84.4**.
-If you are on a distribution that bundles an older Pi, upgrade it or wait for it to catch up.
+Needs **Pi 1.x** and a [Nerd Font](https://www.nerdfonts.com/) (or set `icons.mode` to `"ascii"`).
 
 ```bash
 # From npm (local fork @xzzpig/pi-starline)
 pi install npm:@xzzpig/pi-starline
 
-# From upstream git
+# For fork mouse enhancements and shared pill interaction
+pi install npm:@xzzpig/pi-mouse-events
+
+# Or install the separate upstream package from git
 pi install git:github.com/Andy8647/pi-starline
 ```
 
-Coming from pi-zentui? Run `mv ~/.pi/agent/zentui.json ~/.pi/agent/starline.json` to carry your config over — Starline does not read the old file automatically. Inside it, rename any `colorMode: "zentui"` value to `colorMode: "themed"`.
+What changed in each version: **[Changelog](https://github.com/Andy8647/pi-starline/blob/main/CHANGELOG.md)**.
 
-What changed in each version, and what you need to do about it: **[Changelog](https://github.com/Andy8647/pi-starline/blob/main/CHANGELOG.md)**.
+## Configure
 
-## Config
+`/starline` opens a menu for the everyday settings: colour sources, feature toggles, the order of the bar (`Pills`), and where other extensions' statuses go. The `Pills` tab is the bar itself: one row per segment, its value is the position it holds, and every status an extension published this session gets a row of its own, so one of them can be placed without editing JSON.
 
-Settings live in `~/.pi/agent/starline.json`. The file is optional — anything missing falls back to a default, and unknown keys are ignored at runtime.
+Everything else lives in `~/.pi/agent/starline.json`. The file is optional; missing keys fall back to defaults.
 
 ```json
 {
-	"footerStyle": "pill",
+	"pill": { "segments": ["model", "cwd", "git", "context", "cost"] },
 	"colors": { "gitBranch": "bold purple" },
 	"mouse": { "clickToToggleExpandable": false }
 }
 ```
 
-`/starline` opens an interactive menu for the settings worth changing day to day: colour sources, feature toggles, which built-in segments show, and where third-party extension statuses go. `Tab` and `Shift+Tab` move between its five sections.
+## Docs
 
-**[Full configuration reference →](https://github.com/Andy8647/pi-starline/blob/main/docs/configuration.md)** — every option with its default: the pill footer, the colour palette and its `$name` references, footer format templates, per-segment display options, icon overrides, and editor styling.
-
-## Requirements
-
-- [Pi](https://pi.dev) coding agent 0.84.4 or newer
-- A [Nerd Font](https://www.nerdfonts.com/) for icons (or set `icons.mode` to `"ascii"`)
+- [Configuration](https://github.com/Andy8647/pi-starline/blob/main/docs/configuration.md): every option and its default.
+- [What the footer shows](https://github.com/Andy8647/pi-starline/blob/main/docs/segments.md): git status indicators and the detected runtimes.
+- [Clickable pills for other extensions](https://github.com/Andy8647/pi-starline/blob/main/docs/pill-api.md): put your extension's content in a pill.
+- [Clickable pills: design](https://github.com/Andy8647/pi-starline/blob/main/docs/clickable-pills.md): how the pills, bubbles and bridges work.
 
 ## Development
 
 ```bash
 npm install
-npm run verify
-npm run fmt
-npm run pack:check
-```
-
-### Test in Pi
-
-The project keeps Pi core packages as peer dependencies for runtime and dev dependencies for
-typechecking. To avoid accidentally running the local `node_modules/.bin/pi` shim, the dev scripts use
-the globally installed Pi binary by default:
-
-```bash
-npm run pi:dev
-npm run pi:install-local
+npm run verify       # lint, typecheck, tests
+npm run pi:dev       # run Pi with this checkout and no other extensions
 ```
 
-Override the binary if your Pi install is somewhere else:
-
-```bash
-PI_BIN=/path/to/pi npm run pi:dev
-```
+`pi:dev` uses the globally installed Pi; set `PI_BIN=/path/to/pi` to use another.
 
 ## Credits
 
-Forked from [pi-zentui](https://github.com/lmilojevicc/pi-zentui) by Luka, whose work is the foundation of this project.
-
-Inspired by:
-
-- [Starship](https://starship.rs/) — the minimal, blazing-fast, and infinitely customizable prompt
-- [Opencode](https://github.com/opencode-ai/opencode) — terminal-based AI coding assistant
+Started as a fork of [pi-zentui](https://github.com/lmilojevicc/pi-zentui) by Luka. Inspired by [Starship](https://starship.rs/) and [Opencode](https://github.com/opencode-ai/opencode).
 
 ## License
 
 MIT
+
+## Compatibility: explicit expand targets (fork-only)
+
+This fork's click-to-expand resolution (`mouse/tool-box.ts`) checks an
+optional, versioned **explicit expand-target protocol** before its own
+`setExpanded`/hint logic:
+
+- Providers publish a resolver on a component instance under
+  `Symbol.for("@xzzpig/transcript-expand-target.v1")` with
+  `{ version: 1, resolveLocalTarget(localRow, width) }`. The consumer is
+  `mouse/explicit-expand-target.ts` (fork-only file).
+- Today the only provider is
+  [`@xzzpig/pi-group-collapse`](../pi-group-collapse): its group summaries
+  resolve to the independent group object, so clicking a summary toggles
+  the group instead of the tool that carries it.
+- Without a provider nothing changes: no published protocol, a wrong
+  version, a non-callable resolver, a thrown resolution, or an invalid
+  resolved shape all fall through to the existing resolution. Installing
+  the provider is never required, and load order in either direction
+  works (the resolver is read per click, not cached).
+- Drag selection, double-click word selection, hyperlinks, wheel, and
+  overlay behavior are unaffected; the explicit target only answers for
+  the specific local rows it owns.

package/dist/public.d.ts

@@ -0,0 +1,5 @@
+import { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+declare function export_default(pi: ExtensionAPI): void;
+
+export { export_default as default };