pi-one-ui 0.6.1 → 0.7.0

package/CHANGELOG.md

@@ -6,6 +6,21 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-09-13
+
+### Added
+
+- Added `components.editor.styles.minimalist.showCwd` to independently show or hide the Editor's working-directory label, including the `/oneui` preview. It defaults to `true`, so existing configurations need no migration. Setting it to `false` preserves `pathDisplay` and leaves Git metadata and Footer directory settings unchanged; edit the JSON configuration and run `/reload` to apply it.
+
+### Fixed
+
+- Restore keyboard focus to the visible Editor after `/oneui` replaces an editor while changing its settings, including native-to-custom transitions, third-party wrappers, and replacement rollback. Closing the panel no longer sends subsequent typing to the detached previous editor in regular or fullscreen mode; existing overlays and later editor owners retain focus.
+
+### Migration
+
+- No configuration migration is required. Existing configurations keep showing the Editor directory; set `components.editor.styles.minimalist.showCwd` to `false` only if you want to hide it. Footer directory settings remain independent.
+- For an unpinned npm installation, run `pi update npm:pi-one-ui`; for an existing version pin, run `pi install npm:pi-one-ui@0.7.0`. Fully exit and restart Pi after updating the package. Subsequent JSON configuration edits can be applied with `/reload`.
+
 ## [0.6.1] - 2026-09-06
 
 ### Added
@@ -115,7 +130,8 @@ 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.6.1...HEAD
+[Unreleased]: https://github.com/kerolt/pi-one-ui/compare/v0.7.0...HEAD
+[0.7.0]: https://github.com/kerolt/pi-one-ui/compare/v0.6.1...v0.7.0
 [0.6.1]: https://github.com/kerolt/pi-one-ui/compare/v0.6.0...v0.6.1
 [0.6.0]: https://github.com/kerolt/pi-one-ui/compare/v0.5.1...v0.6.0
 [0.5.1]: https://github.com/kerolt/pi-one-ui/compare/v0.5.0...v0.5.1

package/README.en.md

@@ -76,6 +76,20 @@ Then open the unified settings panel:
 /oneui
 ```
 
+### Upgrading to 0.7.0
+
+This release adds an Editor working-directory visibility switch and fixes invisible input after changing Editor settings and closing `/oneui`. Existing configurations need no migration; the directory remains visible by default.
+
+For an unpinned npm installation, run:
+
+```bash
+pi update npm:pi-one-ui
+```
+
+If your installation pins a version, run `pi install npm:pi-one-ui@0.7.0` to update the pin. Fully exit and restart Pi after updating the package.
+
+To hide the Editor directory, set `components.editor.styles.minimalist.showCwd: false`; Footer directory visibility is configured independently. See the complete example in the [configuration guide](./docs/configuration.md#隐藏-editor-目录在-footer-左侧显示).
+
 ## Configuration
 
 ### Configuration methods
@@ -132,7 +146,7 @@ Below is a typical v1 configuration structure:
 To keep the configuration section clean and focused, in-depth options, template variables, and color references are organized in dedicated documentation:
 
 - **Component options & layout customization**: see [Editor & Footer Configuration Guide (docs/configuration.md)](./docs/configuration.md)
-  - **Editor**: Configure `style` (`on` for Minimalist decoration / `off` for Pi native), `borderColorMode` (`static` or `adaptive` to thinking effort), `modelLabel`, and granular Minimalist displays (directory path format, session name, timer, cost, Git status, etc.).
+  - **Editor**: Configure `style` (`on` for Minimalist decoration / `off` for Pi native), `borderColorMode` (`static` or `adaptive` to thinking effort), `modelLabel`, and granular Minimalist displays (directory visibility and format, session name, timer, cost, Git status, etc.). `components.editor.styles.minimalist.showCwd` (since 0.7.0, default `true`) can hide the directory independently of the Footer; `pathDisplay` continues to select its format.
   - **Footer**: Starship-style layout powered by format templates (`$cwd`, `$git_branch`, `$tokens`, `$cost`, etc.), individual `segments` toggles, customizable separators, and context-usage indicators (gauge or text).
   - **WorkingLine**: Built-in live output throughput tracking (appends e.g. `⚡12 tok/s` when a model response runs for at least 500ms, reset per turn).
 - **Settings panel (`/oneui`) customization**: the optional top-level `panel` section controls the overlay placement and size (all fields default to the values shown in the example above).

package/README.md

@@ -76,6 +76,20 @@ pi install git:github.com/kerolt/pi-one-ui
 /oneui
 ```
 
+### 升级到 0.7.0
+
+本次新增 Editor 工作目录显示开关，并修复修改 Editor 配置后关闭 `/oneui` 导致输入不可见的问题。现有配置无需迁移，工作目录仍默认显示。
+
+未固定版本的 npm 安装可执行：
+
+```bash
+pi update npm:pi-one-ui
+```
+
+若安装时固定了版本，执行 `pi install npm:pi-one-ui@0.7.0` 更新版本指定。更新安装包后，完整退出并重启 Pi。
+
+如需隐藏 Editor 目录，设置 `components.editor.styles.minimalist.showCwd: false`；Footer 中的目录显示独立配置。完整示例见 [配置指南](./docs/configuration.md#隐藏-editor-目录在-footer-左侧显示)。
+
 ## 配置
 
 ### 配置方式
@@ -132,7 +146,7 @@ pi install git:github.com/kerolt/pi-one-ui
 各项组件开关、模板变量与颜色字段的完整规范拆分收录于独立文档中，便于按需查阅：
 
 - **组件开关与排版定制**：详见 [Editor 与 Footer 配置指南 (docs/configuration.md)](./docs/configuration.md)
-  - **Editor**：支持 `style`（`on` 极简装饰 / `off` 原生）、`borderColorMode`（固定色 / 思考档位自适应）、`modelLabel` 及 Minimalist 装饰细节（目录层级、会话名、耗时、费用、Git 状态等）。
+  - **Editor**：支持 `style`（`on` 极简装饰 / `off` 原生）、`borderColorMode`（固定色 / 思考档位自适应）、`modelLabel` 及 Minimalist 装饰细节（目录显示与格式、会话名、耗时、费用、Git 状态等）。`components.editor.styles.minimalist.showCwd`（0.7.0 起，默认 `true`）可单独隐藏工作目录，不影响 Footer；`pathDisplay` 继续控制目录格式。
   - **Footer**：支持 Starship 风格排版，提供丰富的模板变量（`$cwd`、`$git_branch`、`$tokens`、`$cost` 等），支持通过 `format` 自定义或通过 `segments` 控制各段开关，并可自由配置上下文占用率的展示形式（gauge / text）。
   - **WorkingLine**：内置实时输出速率检测（单次响应持续 >=500ms 自动追加如 `⚡12 tok/s`，按回合独立重置）。
 - **设置面板（`/oneui`）定制**：通过顶层 `panel` 字段控制浮层位置与尺寸，全部字段可省略（缺省值见上文示例）。

package/extensions/app/config/shell.ts

@@ -97,6 +97,8 @@ export type FooterSegmentsConfig = {
 
 export type MinimalistEditorStyleConfig = {
   pathDisplay: MinimalistPathDisplayMode;
+  /** Controls the Editor directory label independently of its format and the Footer. */
+  showCwd: boolean;
   showSessionName: boolean;
   showTimer: boolean;
   showCost: boolean;
@@ -395,6 +397,7 @@ const defaultFooterSegments: FooterSegmentsConfig = {
 
 const defaultMinimalistStyle: MinimalistEditorStyleConfig = {
   pathDisplay: "compact",
+  showCwd: true,
   showSessionName: true,
   showTimer: true,
   showCost: true,
@@ -1001,6 +1004,10 @@ function resolveComponents(config: ConfigRecord): ComponentsConfig {
             minimalist.pathDisplay === "full"
               ? minimalist.pathDisplay
               : defaultMinimalistStyle.pathDisplay,
+          showCwd: parseBoolean(
+            minimalist.showCwd,
+            defaultMinimalistStyle.showCwd,
+          ),
           showSessionName: parseBoolean(
             minimalist.showSessionName,
             defaultMinimalistStyle.showSessionName,
@@ -1386,6 +1393,9 @@ function applyMinimalistStylePatch(
   patch: Partial<MinimalistEditorStyleConfig>,
 ): void {
   if (patch.pathDisplay !== undefined) style.pathDisplay = patch.pathDisplay;
+  if (patch.showCwd !== undefined) {
+    style.showCwd = patch.showCwd;
+  }
   if (patch.showSessionName !== undefined)
     style.showSessionName = patch.showSessionName;
   if (patch.showTimer !== undefined) style.showTimer = patch.showTimer;

package/extensions/app/panel.ts

@@ -1,10 +1,13 @@
 import {
   type ExtensionCommandContext,
   type ExtensionContext,
+  type ExtensionUIContext,
   getSettingsListTheme,
 } from "@earendil-works/pi-coding-agent";
 import {
+  type Component,
   matchesKey,
+  type OverlayHandle,
   type SettingItem,
   SettingsList,
   truncateToWidth,
@@ -609,10 +612,22 @@ export async function showOneUiPanel(
   try {
     // Read fresh on every open so pi-one-ui.json edits apply without /reload.
     const panelOverlay = loadPanelOverlayConfig();
-    let panelHandle: { focus: () => void } | undefined;
+    let panelHandle: Pick<OverlayHandle, "focus" | "unfocus"> | undefined;
     await overlayManager.run(() =>
       ctx.ui.custom(
         (tui, theme, _keybindings, done) => {
+          // Pi's concrete renderers expose focus inspection beyond the narrow TUI port.
+          const focusTui = tui as typeof tui & {
+            getFocusedComponent?: () => Component | null;
+            isOverlayFocused?: () => boolean;
+          };
+          const originalFocus = focusTui.getFocusedComponent?.();
+          let editorFocus:
+            | {
+                component: Component;
+                factory: ReturnType<ExtensionUIContext["getEditorComponent"]>;
+              }
+            | undefined;
           let activeIndex = 0;
           let list: SettingsList;
           const createList = () => {
@@ -621,6 +636,16 @@ export async function showOneUiPanel(
               10,
               getSettingsListTheme(),
               (id, value) => {
+                const updatesEditor =
+                  id === "editorStyle" || id === "editorBorderColorMode";
+                if (updatesEditor && originalFocus !== undefined) {
+                  // Suspend automatic overlay focus restoration while Pi may replace
+                  // and roll back an editor, keeping the final instance observable.
+                  panelHandle?.unfocus?.({
+                    target: editorFocus?.component ?? originalFocus,
+                  });
+                }
+                const previousFocus = focusTui.getFocusedComponent?.();
                 try {
                   updateSetting(id, value, ctx, deps);
                   list.updateValue(id, value);
@@ -629,13 +654,50 @@ export async function showOneUiPanel(
                   createList();
                   list.selectItem(id);
                 } finally {
-                  if (id === "editorStyle") {
+                  if (updatesEditor) {
+                    // Replacements (including rollback) focus the new instance, but the
+                    // overlay still retains its old preFocus. Capture before refocusing.
+                    const nextFocus = focusTui.getFocusedComponent?.();
+                    if (
+                      nextFocus &&
+                      nextFocus !== previousFocus &&
+                      !focusTui.isOverlayFocused?.()
+                    ) {
+                      try {
+                        editorFocus = {
+                          component: nextFocus,
+                          factory: ctx.ui.getEditorComponent(),
+                        };
+                      } catch {
+                        editorFocus = undefined;
+                      }
+                    }
                     panelHandle?.focus();
                   }
                   tui.requestRender();
                 }
               },
-              () => done(undefined),
+              () => {
+                done(undefined);
+                // Only correct this panel's stale return target; other overlays and
+                // later editor owners keep their focus. Stale session contexts may throw.
+                if (
+                  !editorFocus ||
+                  tui.hasOverlay() ||
+                  focusTui.getFocusedComponent?.() !== originalFocus
+                ) {
+                  return;
+                }
+                try {
+                  if (ctx.ui.getEditorComponent() !== editorFocus.factory) {
+                    return;
+                  }
+                } catch {
+                  return;
+                }
+                tui.setFocus(editorFocus.component);
+                tui.requestRender();
+              },
             );
           };
           createList();
@@ -696,7 +758,7 @@ export async function showOneUiPanel(
             maxHeight: panelOverlay.maxHeight,
             margin: panelOverlay.margin,
           },
-          onHandle: (handle: { focus: () => void }) => {
+          onHandle: (handle: OverlayHandle) => {
             panelHandle = handle;
           },
         },

package/extensions/layouts/editor/minimalist-editor.ts

@@ -262,6 +262,9 @@ function renderBottomRight(
   uiTheme: Theme,
   config: ZentuiConfig,
 ): string {
+  if (config.components.editor.styles.minimalist.showCwd === false) {
+    return "";
+  }
   const cwd = sanitizeEditorMetadataText(minimalistCwdLabel(metadata, config));
   return cwd
     ? renderSourceColor(uiTheme, config.colors.cwd, "cwd", "bold cyan", cwd)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-one-ui",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "A single, customizable Pi UI package with layout-oriented Context and Shell rendering for Pi.",
   "type": "module",
   "license": "MIT",