pi-one-ui 0.3.1 → 0.5.0

package/CHANGELOG.md

@@ -6,6 +6,48 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-09-05
+
+### Changed
+
+- Reduced the Editor to the single `minimalist` style with an `on`/`off` switch: `off` restores Pi's native editor, and the retired `opencode` style is removed (`enabled` merges into `style`, legacy values migrate automatically).
+- Added `/oneui` panel settings for the Editor component: style (`on`/`off`), color source (`theme`/`terminal`), and border color mode (`static`/`adaptive`), each with an inline description.
+- In `off` mode, an explicitly configured `colors.editorBorder` is applied to the native editor border through `colorSource` (theme tokens or fixed terminal colors); without it the native effort/theme coloring is preserved.
+
+### Performance
+
+- Cached `ToolExecutionComponent` render widgets across expand/collapse toggles: repeated Ctrl+O toggles and identical result updates now skip the full native rebuild, cutting batch expansion of many tools (e.g. 30 × 1000-line outputs) from ~130ms to under 0.2ms while keeping expanded and collapsed render slots independent.
+
+### Removed
+
+- Removed the `opencode` Editor style along with its polished renderer, completion-menu module, and `styles.opencode` configuration; the `enabled` field is gone.
+
+### Migration
+
+- `components.editor.enabled: false` becomes `components.editor.style: "off"`; `style: "opencode"`/`"minimalist"` become `"on"`. The `styles.opencode` block and `opencode-copy-friendly`/`accent-rail` selections are ignored.
+
+### Fixed
+
+- Toggling the Editor style between `on`/`off` no longer replaces the editor factory: the existing instance (and Pi's overlay focus target) stays valid, so the `/oneui` panel restores keyboard focus to the input editor after closing.
+- Unconfigured `cwd`, model-label, and static border colors now prefer the theme's `cwd`/`editorModel`/`editorBorder` tokens (which may reference `vars` variables or hex), falling back to Pi's native defaults when the theme does not define them.
+
+## [0.4.0] - 2026-09-03
+
+### Changed
+
+- Simplified Editor styling to the `opencode` and `minimalist` options; removed Minimalist context-usage metadata in favor of Footer's more complete context configuration.
+- Added response-local live output throughput to the WorkingLine token segment after a bounded sampling window.
+
+### Removed
+
+- Removed the `opencode-copy-friendly` and `accent-rail` Editor styles, including Accent Rail layout patching and style-specific settings.
+- Removed the inherited upstream image from pi-one-ui's package-gallery metadata.
+
+### Migration
+
+- Existing `opencode-copy-friendly` or `accent-rail` selections fall back to `opencode`; remove obsolete nested settings for those styles when convenient.
+- Configure context percentage, token totals, thresholds, and gauges through Footer instead of Minimalist Editor settings.
+
 ## [0.3.1] - 2026-08-31
 
 ### Changed
@@ -45,7 +87,9 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 - Reduced rendering lag when expanding settled tool groups by reusing cached child output.
 
-[Unreleased]: https://github.com/kerolt/pi-one-ui/compare/v0.3.1...HEAD
+[Unreleased]: https://github.com/kerolt/pi-one-ui/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/kerolt/pi-one-ui/compare/v0.4.0...v0.5.0
+[0.4.0]: https://github.com/kerolt/pi-one-ui/compare/v0.3.1...v0.4.0
 [0.3.1]: https://github.com/kerolt/pi-one-ui/compare/v0.3.0...v0.3.1
 [0.3.0]: https://github.com/kerolt/pi-one-ui/compare/v0.2.2...v0.3.0
 [0.2.2]: https://github.com/kerolt/pi-one-ui/compare/v0.2.1...v0.2.2

package/README.en.md

@@ -25,24 +25,24 @@ Header → Context → WorkingLine → Editor → Footer
 
 - **Header**: startup information, logo, and shortcut hints.
 - **Context**: the conversation area, including user messages, assistant messages, thinking, tools, diffs, Markdown, and summaries.
-- **WorkingLine**: working state, spinner, token/thought/elapsed information, and turn summaries.
-- **Editor**: input editor, completion, metadata, Accent Rail, and Minimalist styles.
+- **WorkingLine**: working state, spinner, token/thought/elapsed information, live output rate, and turn summaries.
+- **Editor**: input editor, completion, metadata, and the Minimalist style (Pi native is one toggle away).
 - **Footer**: current directory, Git, runtime, token, cost, and extension status information.
 - **Overlay**: temporary interfaces such as the settings panel and Context Inspector, managed by a shared OverlayManager.
 
 ### Built-in functionality
 
-| Feature | Description | Entry point |
-| --- | --- | --- |
-| Unified settings panel | Organizes settings by Header, Context, WorkingLine, Editor, Footer, and Features | `/oneui` |
-| Context Inspector | Shows context usage and previews the system prompt, memory, skills, tools, and messages | `/context` |
-| Session reference | Searches previous Pi sessions or SubAgents and injects their useful context | `@` completion |
-| Subagent autocomplete | Completes SubAgent names and delegation hints | `@` completion |
-| Tool / Diff renderer | Provides unified rendering for tool calls, results, collapsed content, and Edit/Write diffs | Automatic |
-| Subagent live renderer | Preserves pi-subagents' dedicated progress cards and keeps them out of generic tool groups | Automatic |
-| Markdown enhancement | Adds Mermaid, admonitions, URL linking, and related rendering improvements | Automatic |
-| Built-in themes | Provides CC Dark and CC Light themes | `/theme` |
-| Compatibility aliases | Optionally provides common command aliases | `/clear`, `/exit` |
+| Feature                | Description                                                                                 | Entry point       |
+| ---------------------- | ------------------------------------------------------------------------------------------- | ----------------- |
+| Unified settings panel | Organizes settings by Header, Context, WorkingLine, Editor, Footer, and Features            | `/oneui`          |
+| Context Inspector      | Shows context usage and previews the system prompt, memory, skills, tools, and messages     | `/context`        |
+| Session reference      | Searches previous Pi sessions or SubAgents and injects their useful context                 | `@` completion    |
+| Subagent autocomplete  | Completes SubAgent names and delegation hints                                               | `@` completion    |
+| Tool / Diff renderer   | Provides unified rendering for tool calls, results, collapsed content, and Edit/Write diffs | Automatic         |
+| Subagent live renderer | Preserves pi-subagents' dedicated progress cards and keeps them out of generic tool groups  | Automatic         |
+| Markdown enhancement   | Adds Mermaid, admonitions, URL linking, and related rendering improvements                  | Automatic         |
+| Built-in themes        | Provides CC Dark and CC Light themes                                                        | `/theme`          |
+| Compatibility aliases  | Optionally provides common command aliases                                                  | `/clear`, `/exit` |
 
 ## Quick start
 
@@ -90,8 +90,9 @@ Using the `/oneui` settings panel is recommended. The panel uses a top-centered
   "version": 1,
   "components": {
     "editor": {
-      "enabled": true,
-      "style": "opencode"
+      "style": "on",
+      "colorSource": "theme",
+      "borderColorMode": "static"
     },
     "userMessages": {
       "enabled": true,
@@ -111,6 +112,10 @@ Using the `/oneui` settings panel is recommended. The panel uses a top-centered
 }
 ```
 
+The Editor keeps a single `minimalist` decoration style controlled by `style`: `on` enables the Minimalist decoration, `off` restores Pi's native editor (the border follows the theme and effort coloring by default; when `colors.editorBorder` is explicitly configured, the off mode applies that color through `colorSource`, overriding the native effort coloring). Legacy configurations migrate automatically: `enabled: false` becomes `style: "off"`, and `opencode`/`minimalist` become `style: "on"`; the `styles.opencode` block and the retired `opencode-copy-friendly`/`accent-rail` styles are ignored. `borderColorMode` supports `static` (fixed `colors.editorBorder`) and `adaptive` (border shifts with the effort level); `colorSource` supports `theme` (colors resolved through the active Pi theme tokens) and `terminal` (fixed terminal colors). When `cwd`, the model label, or the static border are not explicitly configured, the theme's `cwd`/`editorModel`/`editorBorder` tokens are used first (they may point to `vars` variables or hex values), falling back to Pi's native defaults when the theme does not define them; the terminal source falls back to Pi's native colors as well when unconfigured (only an explicit terminal color name or hex is rendered fixed). Context-usage information is presented by Footer.
+
+The WorkingLine token segment appends live output throughput, such as `⚡12 tok/s`, after a model response has run for at least 500ms. Throughput is calculated independently for the current response and resets on the next `turn_start`; disabling the token segment hides it as well.
+
 Available layout and renderer options may change between versions, so prefer configuring them through `/oneui`.
 
 ### Canonical configuration policy
@@ -127,9 +132,9 @@ It does not automatically read, merge, or migrate historical configuration files
 
 `pi-one-ui` originally combined source from the following open-source projects. Many thanks to their maintainers and contributors for providing the initial foundation.
 
-| Upstream project | Capabilities incorporated into `pi-one-ui` | Reference baseline |
-| --- | --- | --- |
-| [pi-zentui](https://github.com/lmilojevicc/pi-zentui) | Starship-style Footer, Opencode-style Editor, layouts, and shell capabilities | v0.21.0, commit `5341b38` |
+| Upstream project                                                | Capabilities incorporated into `pi-one-ui`                                                 | Reference baseline        |
+| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------ | ------------------------- |
+| [pi-zentui](https://github.com/lmilojevicc/pi-zentui)           | Starship-style Footer, Opencode-style Editor, layouts, and shell capabilities              | v0.21.0, commit `5341b38` |
 | [pi-cc-extensions](https://github.com/minuque/pi-cc-extensions) | Claude Code-style Context renderer, Tool/Diff rendering, Context Inspector, and references | v0.8.67, commit `dba37e5` |
 
 Production code lives in `extensions/`. The project has since unified its entry point, configuration storage, lifecycle, layout ownership, overlays, and input routing. The current implementation is no longer equivalent to either upstream project and does not automatically track upstream changes.
@@ -178,16 +183,16 @@ After changing the source, run the following command in Pi:
 
 ### Development commands
 
-| Command | Purpose |
-| --- | --- |
-| `npm install` | Install dependencies |
-| `npm run format` | Format source, tests, and configuration files |
-| `npm run check` | Check formatting and import organization |
-| `npm run fix` | Fix formatting and organize imports |
-| `npm run typecheck` | Run TypeScript type checking |
-| `npm test` | Run all tests with Vitest |
-| `npm run pack:check` | Preview the npm package contents |
-| `npm run verify` | Run Biome checks, type checking, and all tests |
+| Command              | Purpose                                        |
+| -------------------- | ---------------------------------------------- |
+| `npm install`        | Install dependencies                           |
+| `npm run format`     | Format source, tests, and configuration files  |
+| `npm run check`      | Check formatting and import organization       |
+| `npm run fix`        | Fix formatting and organize imports            |
+| `npm run typecheck`  | Run TypeScript type checking                   |
+| `npm test`           | Run all tests with Vitest                      |
+| `npm run pack:check` | Preview the npm package contents               |
+| `npm run verify`     | Run Biome checks, type checking, and all tests |
 
 Before submitting changes, run at least:
 

package/README.md

@@ -25,8 +25,8 @@ Header → Context → WorkingLine → Editor → Footer
 
 - **Header**：启动信息、Logo 和快捷键提示。
 - **Context**：对话内容区，包含用户消息、Assistant 消息、Thinking、Tool、Diff、Markdown 和 Summary。
-- **WorkingLine**：工作状态、spinner、token/thought/elapsed 信息和回合摘要。
-- **Editor**：输入编辑器、completion、metadata、Accent Rail 和 Minimalist 样式。
+- **WorkingLine**：工作状态、spinner、token/thought/elapsed、实时输出速率和回合摘要。
+- **Editor**：输入编辑器、completion、metadata，以及 Minimalist 样式（可切换 Pi 原生）。
 - **Footer**：目录、Git、runtime、token、cost 和扩展状态等信息。
 - **Overlay**：设置面板、Context Inspector 等临时浮层由统一的 OverlayManager 管理。
 
@@ -83,15 +83,17 @@ pi install git:github.com/kerolt/pi-one-ui
 ~/.pi/agent/pi-one-ui.json
 ```
 
-推荐通过 `/oneui` 设置面板修改配置。面板采用更靠近顶部的居中布局；切换 Editor 启用状态或样式时会保持打开并在 Editor 替换后恢复焦点，持久化失败时则恢复列表中的有效旧值。当前配置仍使用 v1 结构，例如：
+
+推荐通过 `/oneui` 设置面板修改配置。面板采用更靠近顶部的居中布局；切换 Editor 开关、颜色源或边框模式时会保持打开并在 Editor 替换后恢复焦点，持久化失败时则恢复列表中的有效旧值。当前配置仍使用 v1 结构，例如：
 
 ```json
 {
   "version": 1,
   "components": {
     "editor": {
-      "enabled": true,
-      "style": "opencode"
+      "style": "on",
+      "colorSource": "theme",
+      "borderColorMode": "static"
     },
     "userMessages": {
       "enabled": true,
@@ -111,6 +113,10 @@ pi install git:github.com/kerolt/pi-one-ui
 }
 ```
 
+Editor 只保留 `minimalist` 一种装饰样式，通过 `style` 开关控制：`on` 启用 Minimalist 装饰，`off` 恢复 Pi 原生编辑器（边框默认跟随主题与 effort 变色；若显式配置了 `colors.editorBorder`，off 模式下也会按 `colorSource` 应用该颜色，覆盖原生 effort 变色）。旧配置的 `enabled: false` 会迁移为 `style: "off"`，`opencode`/`minimalist` 会迁移为 `style: "on"`，`styles.opencode` 嵌套配置与 `opencode-copy-friendly`、`accent-rail` 一并失效。`borderColorMode` 支持 `static`（固定 `colors.editorBorder`）与 `adaptive`（边框随 effort 档位变化）；`colorSource` 支持 `theme`（颜色取当前主题 token）与 `terminal`（固定终端色）。cwd、模型名与边框（static）未显式配置时优先使用主题的 `cwd`/`editorModel`/`editorBorder` token（可指向 vars 变量或 hex），主题未定义则回落 Pi 原生默认；terminal 源未配置时同样回落 Pi 原生颜色（配置了终端色名/hex 才固定渲染）。上下文占用相关信息由 Footer 统一展示。
+
+WorkingLine 的 token segment 会在一次模型响应持续至少 500ms 后追加实时输出速率，例如 `⚡12 tok/s`。速率按当前响应独立计算，在下一次 `turn_start` 时重置；关闭 token segment 时也会一并隐藏。
+
 不同布局和渲染器的可用选项会随版本变化，建议优先使用 `/oneui` 面板进行配置。
 
 ### Canonical 配置约定

package/extensions/app/commands/settings-previews.ts

@@ -1,10 +1,8 @@
 import type { Theme } from "@earendil-works/pi-coding-agent";
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import { renderUserMessageStyle } from "../../layouts/context/message/user-message-styles.ts";
-import { renderAccentRailEditorFrame } from "../../layouts/editor/accent-rail-editor.ts";
 import { sanitizeEditorMetadataText } from "../../layouts/editor/editor-metadata-format.ts";
 import { renderMinimalistFrame } from "../../layouts/editor/minimalist-editor.ts";
-import { renderPolishedEditorFrame } from "../../layouts/editor/ui.ts";
 import { safeThemeFg } from "../../shared/style.ts";
 import type { PolishedTuiConfig } from "../config/shell.ts";
 
@@ -60,61 +58,30 @@ export function renderEditorSettingsPreview(
   const viewport = editor.viewportIndicators
     ? { above: "2", below: "3" }
     : undefined;
-  let frame: string[];
-  if (editor.style === "accent-rail") {
-    frame = renderAccentRailEditorFrame({
-      width: previewWidth,
-      editorLines,
-      autocompleteLines,
-      viewport,
-      uiTheme: theme,
-      config: safeConfig,
-    });
-  } else if (editor.style === "minimalist") {
-    frame = renderMinimalistFrame({
-      width: previewWidth,
-      editorLines,
-      viewport,
-      inputText: EDITOR_PREVIEW_INPUT,
-      metadata: {
-        cwd: "/workspace/zentui/src",
-        projectRoot: "/workspace/zentui",
-        branch: "feat/settings-previews",
-        dirty: true,
-        ahead: 2,
-        behind: 1,
-        costLabel: "$.12",
-        modelLabel,
-        thinkingLevel: "high",
-        contextPercent: 75,
-        contextWindow: 372_000,
-        sessionName: "Preview",
-        agentDurationMs: 12_000,
-        agentActive: true,
-      },
-      uiTheme: theme,
-      config: safeConfig,
-      borderColor,
-    });
-  } else {
-    frame = renderPolishedEditorFrame({
-      width: previewWidth,
-      editorLines,
-      autocompleteLines,
-      viewport,
-      uiTheme: theme,
-      config: safeConfig,
-      modelMeta: {
-        modelLabel,
-        modelId: "sonnet-4",
-        modelName: "Sonnet 4",
-        providerLabel: "Anthropic",
-        sessionName: "Preview",
-      },
+  const frame = renderMinimalistFrame({
+    width: previewWidth,
+    editorLines,
+    autocompleteLines,
+    viewport,
+    inputText: EDITOR_PREVIEW_INPUT,
+    metadata: {
+      cwd: "/workspace/zentui/src",
+      projectRoot: "/workspace/zentui",
+      branch: "feat/settings-previews",
+      dirty: true,
+      ahead: 2,
+      behind: 1,
+      costLabel: "$.12",
+      modelLabel,
       thinkingLevel: "high",
-      borderColor,
-    });
-  }
+      sessionName: "Preview",
+      agentDurationMs: 12_000,
+      agentActive: true,
+    },
+    uiTheme: theme,
+    config: safeConfig,
+    borderColor,
+  });
   return boundedRows(frame, previewWidth);
 }