pi-one-ui 0.7.1 → 0.8.0

package/CHANGELOG.md

@@ -6,6 +6,47 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 ## [Unreleased]
 
+## [0.8.0] - 2026-09-30
+
+### Changed
+
+- Require Pi `>= 0.99.0`: the Editor reads a theme's `cwd`, `editorModel`, and `editorBorder` keys from the palette shape Pi exposes since 0.99, and development, tests, and type checking target that version.
+- Simplify color configuration: `colors.*` now accepts Pi official theme tokens defined in a theme file's `colors` field and explicit terminal colors; bare terminal color names are rejected, so write `fg:purple`, `fg:red`, a hex value, or a 256-color index for fixed terminal colors. Pi-one-ui custom keys such as `cwd`, `editorModel`, and `editorBorder` are documented as extensions that the shipped themes define. The reference is updated in both Chinese and English README.
+- Rename the remaining persisted `zentui` values: `components.selectorBorders.style` is now `one-ui`, extension status `colorModes` are `themed` / `original`, and the working-line turn summary entry type is `one-ui-turn-summary`.
+
+### Fixed
+
+- Read Editor theme tokens from the palette field exposed by the running Pi version. Pi 0.99 renamed the theme palette map from `fgColors` to `fgAnsi` and added a resolved `colors` record, so the Editor model label, cwd label, and static border now pick up a theme's `editorModel` / `cwd` / `editorBorder` colors instead of falling back to `syntaxKeyword` / `syntaxFunction` / `borderMuted`.
+
+### Migration
+
+- Install Pi `>= 0.99.0` before updating this package. Earlier Pi releases keep working only through the previous package version.
+- Replace bare terminal color names in `colors.*` with an explicit form: `purple` becomes `fg:purple`, `red` becomes `fg:red`, and fixed colors can also use hex or a 256-color index. Values that no longer validate are dropped at load and fall back to the built-in default, and the file itself is not rewritten.
+- No manual edit is required for the renamed `zentui` values. The next configuration save rewrites `selectorBorders.style` and extension status color modes to the new names, and turn summaries written by older versions continue to render from history.
+- After updating the package, fully exit and restart Pi instead of running `/reload`: the cross-reload patch coordination keys were renamed, so an in-place reload would leave the previous instance's marks unrecognized until the process restarts.
+- 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.8.0`.
+
+## [0.7.2] - 2026-09-28
+
+### Changed
+
+- The Editor completion dropdown now paints the selected row with the editor frame color, so the selection follows the same static/adaptive thinking-level chain as the frame border while unselected rows keep Pi's native styling.
+
+### Fixed
+
+- Keep the pending tool loading animation alive during long-running commands: the updateDisplay render cache now rebuilds pending tool rows so each animation tick re-enters the renderer, preventing the spinner from freezing while a command is still executing.
+
+### Migration
+
+- No configuration migration is required. Existing canonical v1 files and command names remain supported.
+- 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.2`. Fully exit and restart Pi after updating the package.
+
+### Release verification
+
+- Release source: [`67ebac4`](https://github.com/kerolt/pi-one-ui/commit/67ebac41e1aeaaab51e11257de17134fb40ab63e). [CI](https://github.com/kerolt/pi-one-ui/actions/runs/36365224155) and [Publish](https://github.com/kerolt/pi-one-ui/actions/runs/36365227223) completed successfully; local and CI `npm run verify` passed 1,185 tests across 70 files, and `npm run pack:check` confirmed 124 package files.
+- Real Pi regular/fullscreen TUI probes passed, covering settings, Context Inspector, Editor input and focus, presets, reload, session tree, compaction, session replacement, input listeners, and third-party Editor ownership. User-specific terminal, theme, and extension combinations still require manual verification.
+- At publication, npm `latest` resolved to `0.7.2` with the matching release `gitHead` and package SHA-1 `730dc4a0e4713e26cef4ea3b0c83c122f8b83bc6`; the downloaded package file list and contents matched the release commit. The [provenance statement](https://registry.npmjs.org/-/npm/v1/attestations/pi-one-ui@0.7.2) was published at [Sigstore log index 2981051472](https://search.sigstore.dev/?logIndex=2981051472).
+
 ## [0.7.1] - 2026-09-21
 
 ### Changed
@@ -24,6 +65,12 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 - No configuration migration is required. Existing canonical v1 files and command names remain supported.
 - 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.1`. Fully exit and restart Pi after updating the package.
 
+### Release verification
+
+- Release source: [`e4451a2`](https://github.com/kerolt/pi-one-ui/commit/e4451a244838550f0914469bd8ff5ddbaebc1f8f). [CI](https://github.com/kerolt/pi-one-ui/actions/runs/35567977181) and [Publish](https://github.com/kerolt/pi-one-ui/actions/runs/35567977360) completed successfully; local and CI `npm run verify` passed 1,176 tests across 69 files, and `npm run pack:check` confirmed 124 package files.
+- Real Pi regular/fullscreen TUI probes passed, covering settings, Context Inspector, Editor input and focus, presets, reload, session tree, compaction, session replacement, input listeners, and third-party Editor ownership. User-specific terminal, theme, and extension combinations still require manual verification.
+- At publication, npm `latest` resolved to `0.7.1` with the matching release `gitHead` and package SHA-1 `0252f3b21190f56170a96ff8c3a2a1e8df74874f`. The [provenance statement](https://registry.npmjs.org/-/npm/v1/attestations/pi-one-ui@0.7.1) was published at [Sigstore log index 2905054424](https://search.sigstore.dev/?logIndex=2905054424).
+
 ## [0.7.0] - 2026-09-13
 
 ### Added
@@ -153,7 +200,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.7.1...HEAD
+[Unreleased]: https://github.com/kerolt/pi-one-ui/compare/v0.8.0...HEAD
+[0.8.0]: https://github.com/kerolt/pi-one-ui/compare/v0.7.2...v0.8.0
+[0.7.2]: https://github.com/kerolt/pi-one-ui/compare/v0.7.1...v0.7.2
 [0.7.1]: https://github.com/kerolt/pi-one-ui/compare/v0.7.0...v0.7.1
 [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

package/README.en.md

@@ -50,7 +50,7 @@ Header → Context → WorkingLine → Editor → Footer
 ### Requirements
 
 - Node.js `>=22.19.0`
-- Pi and related runtime packages `>=0.84.0`
+- Pi and related runtime packages `>=0.99.0`
 
 ### Install from npm
 
@@ -76,11 +76,9 @@ Then open the unified settings panel:
 /oneui
 ```
 
-### Upgrading to 0.7.1
+### Upgrading to 0.8.0
 
-This release centralizes component composition, settings application, and session lifecycle management. Each preset saves and applies all related component settings in one update, Header settings apply immediately, and session replacement cleans up overlays and input listeners.
-
-Existing canonical v1 configurations and commands remain compatible; no migration is required. Corrupt or unreadable configuration files now produce an explicit error.
+Pi `>= 0.99.0` is now required. The Editor model label, cwd label, and static border read a theme's `editorModel` / `cwd` / `editorBorder` keys through the palette shape the current Pi exposes; `colors.*` accepts Pi official theme tokens and explicit terminal colors only, so bare terminal color names such as `purple` must be written as `fg:purple`; and the legacy `zentui` values in `selectorBorders.style`, extension status `colorModes`, and the turn summary entry type use new names, with legacy values still read for compatibility.
 
 For an unpinned npm installation, run:
 
@@ -88,7 +86,7 @@ For an unpinned npm installation, run:
 pi update npm:pi-one-ui
 ```
 
-If your installation pins a version, run `pi install npm:pi-one-ui@0.7.1` to update the pin. Fully exit and restart Pi after updating the package.
+If your installation pins a version, run `pi install npm:pi-one-ui@0.8.0` to update the pin. Fully exit and restart Pi after updating the package instead of running `/reload`: the cross-reload patch coordination keys were renamed, so an in-place reload would leave the previous instance's marks unrecognized.
 
 ## Configuration
 
@@ -157,8 +155,7 @@ To keep the configuration section clean and focused, in-depth options, template
   - `margin`: distance from the terminal edges — either a single number for all sides, or an object with per-edge `top`/`right`/`bottom`/`left` values.
   - Saved changes apply the next time `/oneui` opens; no `/reload` needed.
 - **Color system & theme customization**: see [Editor Colors Reference (docs/editor-colors.md)](./docs/editor-colors.md)
-  - All colors resolve through unified theme semantics. Configured `colors.*` values resolve as theme tokens (adapting automatically across themes), while ANSI names map to semantic tokens (e.g. `red` to `error`). Fixed terminal colors can be specified using hex codes, 256-color indexes, or `fg:`/`bg:` prefixes.
-  - Full support for adaptive thinking-effort border colors (from Low to Max) and labels.
+  - `colors.*` accepts official Pi theme tokens (from the theme file `colors` field), modifiers, and explicit terminal colors. Terminal color names must use prefixes such as `fg:purple` or `fg:red`; fixed colors can also use hex codes, 256-color indexes, or `fg:`/`bg:` prefixes. The token list and syntax are in [docs/editor-colors.md](<./docs/editor-colors.md#3-configuration-value-syntax>).
 - **Migration from legacy versions**: Field cleanups from 0.5.x/0.6.0 (such as merging `opencode` into `minimalist`, or removing `colorSource`) are covered in [docs/configuration.md: Changes and Migration](./docs/configuration.md#6-变更与迁移).
 
 ## Upstream origins and project evolution

package/README.md

@@ -50,7 +50,7 @@ Header → Context → WorkingLine → Editor → Footer
 ### 环境要求
 
 - Node.js `>=22.19.0`
-- Pi 及其相关运行时包 `>=0.84.0`
+- Pi 及其相关运行时包 `>=0.99.0`
 
 ### 从 npm 安装
 
@@ -76,11 +76,9 @@ pi install git:github.com/kerolt/pi-one-ui
 /oneui
 ```
 
-### 升级到 0.7.1
+### 升级到 0.8.0
 
-本次集中管理组件装配、设置应用与会话生命周期。Preset 会一次保存并应用所有相关组件配置，Header 设置即时生效；会话切换时会清理 Overlay 与输入监听。
-
-现有 canonical v1 配置和命令保持兼容，无需迁移。配置文件损坏或无法读取时会明确报告错误。
+本次要求 Pi `>= 0.99.0`。Editor 的模型名、目录标签与 static 外框改为从当前 Pi 的调色板结构读取主题里的 `editorModel` / `cwd` / `editorBorder` 键；`colors.*` 收敛为 Pi 官方主题 token 与显式终端色两种写法，裸终端色名（如 `purple`）不再接受，需写成 `fg:purple`；`selectorBorders.style`、扩展状态 `colorModes` 与轮次摘要条目类型中的旧 `zentui` 值改为新名称，读取端仍兼容旧值。
 
 未固定版本的 npm 安装可执行：
 
@@ -88,7 +86,7 @@ pi install git:github.com/kerolt/pi-one-ui
 pi update npm:pi-one-ui
 ```
 
-若安装时固定了版本，执行 `pi install npm:pi-one-ui@0.7.1` 更新版本指定。更新安装包后，完整退出并重启 Pi。
+若安装时固定了版本，执行 `pi install npm:pi-one-ui@0.8.0` 更新版本指定。更新安装包后，完整退出并重启 Pi，不要使用 `/reload`：跨 reload 的补丁协调键已改名，直接重载会让旧实例留下的标记无法被识别。
 
 ## 配置
 
@@ -157,8 +155,9 @@ pi update npm:pi-one-ui
   - `margin`：距终端边缘的外边距，可以是四边统一数字，也可以是按 `top`/`right`/`bottom`/`left` 分别配置的对象。
   - 修改保存后下次打开 `/oneui` 即生效，无需 `/reload`。
 - **颜色体系与主题定制**：详见 [Editor 颜色配置说明 (docs/editor-colors.md)](./docs/editor-colors.md)
-  - 所有颜色统一按 Theme 语义解释，优先解析为当前主题语义 Token（随主题自动切换），ANSI 色名自动映射为语义色（如 `red` 对应 `error`）；如需固定色彩，可直接指定 Hex、256 色索引或 `fg:`/`bg:` 前缀。
-  - 支持完整的 Thinking 思考档位（Low 至 Max）自适应边框与标签分级配色。
+  - `colors.*` 只接受 Pi 官方主题 token（主题文件 `colors` 字段里的官方颜色键）、修饰符和显式终端色；终端色名必须写成 `fg:purple`、`fg:red` 等形式，固定色彩也可以使用 Hex、256 色索引或 `fg:`/`bg:` 前缀。
+  - Editor 的 `cwd`、`editorModel`、`editorBorder` 是 pi-one-ui 自定义的扩展颜色键（主题文件 `colors` 可以写这些键），缺少时回落到 Pi 官方 theme token；`cc-dark` 和 `cc-light` 已支持这些键。
+  - 支持完整的 Thinking 思考档位（Low 至 Max）自适应边框与标签分级配色，补全下拉选中项与编辑器外框同色，跟随同一条颜色链。
 - **历史版本迁移**：旧版升级带来的字段收敛（如 `opencode` 样式统一合并入 `minimalist`、`colorSource` 双模式移除等）参见 [docs/configuration.md 变更与迁移节](./docs/configuration.md#6-变更与迁移)。
 
 ## 上游来源与项目演进

package/extensions/app/config/footer.ts

@@ -20,7 +20,7 @@ export type GitMetricsConfig = {
   ignoreSubmodules: boolean;
 };
 export type ExtensionStatusPlacement = "off" | "left" | "middle" | "right";
-export type ExtensionStatusColorMode = "zentui" | "original";
+export type ExtensionStatusColorMode = "themed" | "original";
 export type ExtensionStatusesConfig = {
   defaultPlacement: ExtensionStatusPlacement;
   placements: Record<string, ExtensionStatusPlacement>;
@@ -185,7 +185,21 @@ export function isExtensionStatusPlacement(
 export function isExtensionStatusColorMode(
   value: unknown,
 ): value is ExtensionStatusColorMode {
-  return value === "zentui" || value === "original";
+  return value === "themed" || value === "original";
+}
+
+/**
+ * Parses an extension status color mode. The historical `zentui` value is read
+ * as its `themed` replacement so existing configuration files keep working.
+ *
+ * @param value Raw configuration value.
+ * @returns The canonical color mode, or undefined when unsupported.
+ */
+export function parseExtensionStatusColorMode(
+  value: unknown,
+): ExtensionStatusColorMode | undefined {
+  if (value === "zentui") return "themed";
+  return isExtensionStatusColorMode(value) ? value : undefined;
 }
 
 function thresholds(value: unknown): ContextThresholds {
@@ -279,9 +293,11 @@ export function normalizeFooter(value: unknown): FooterComponentConfig {
             ),
           ),
           colorModes: Object.fromEntries(
-            Object.entries(recordValue(statuses.colorModes)).filter(
-              (entry): entry is [string, ExtensionStatusColorMode] =>
-                isExtensionStatusColorMode(entry[1]),
+            Object.entries(recordValue(statuses.colorModes)).flatMap(
+              (entry): Array<[string, ExtensionStatusColorMode]> => {
+                const mode = parseExtensionStatusColorMode(entry[1]);
+                return mode ? [[entry[0], mode]] : [];
+              },
             ),
           ),
         },

package/extensions/app/config/renderer.ts

@@ -35,7 +35,7 @@ export const DEFAULT_TOOL_DISPLAY_CONFIG: ToolDisplayConfig = {
   /**
    * Expanded tool/diff body cap. 40 ≈ one screen of content after title,
    * Input section, editor, and status — keeps the TUI compact.
-   * Raise via /ccstyle → Diff → Expanded max lines when reviewing large dumps.
+   * Raise via /oneui → Diff → Expanded max lines when reviewing large dumps.
    */
   expandedPreviewMaxLines: 40,
 };

package/extensions/app/config/shell.ts

@@ -44,6 +44,7 @@ import {
   type PathDisplayConfig,
   parseCompactFooterMaxLines,
   parseContextStyle,
+  parseExtensionStatusColorMode,
   parseSeparatorStyle,
   type SeparatorStyle,
   type StarshipFooterStyleConfig,
@@ -68,7 +69,8 @@ export * from "./editor.ts";
 export * from "./footer.ts";
 export * from "./working-line.ts";
 export type ColorSpec = string;
-export type SelectorBorderStyle = "zentui";
+/** 选择框边框样式：`one-ui` 是唯一实现，旧配置里的 `zentui` 按同一样式读取。 */
+export type SelectorBorderStyle = "one-ui" | "zentui";
 export type SelectorBordersComponentConfig = {
   enabled: boolean;
   style: SelectorBorderStyle;
@@ -127,44 +129,43 @@ export type PolishedTuiColors = {
   workingLineMid?: ColorSpec;
   workingLineHigh?: ColorSpec;
 };
-export type ZentuiConfig = {
+export type PolishedTuiConfig = {
   projectRefreshIntervalMs: number;
   icons: ResolvedIcons;
   colors: PolishedTuiColors;
   components: ComponentsConfig;
 };
-export type PolishedTuiConfig = ZentuiConfig;
 export const configPath = defaultConfigPath;
 
-export const defaultConfig: ZentuiConfig = {
+export const defaultConfig: PolishedTuiConfig = {
   projectRefreshIntervalMs: 30_000,
   icons: { mode: "auto", ...NERD_DEFAULT_ICONS },
   colors: {
-    sessionName: "bold green",
-    gitBranch: "bold purple",
-    gitStatus: "bold red",
-    contextNormal: "bright-black",
-    contextWarning: "bold yellow",
-    contextError: "bold red",
-    tokens: "bright-black",
-    cost: "bold green",
-    separator: "bright-black",
+    sessionName: "bold success",
+    gitBranch: "bold syntaxKeyword",
+    gitStatus: "bold error",
+    contextNormal: "muted",
+    contextWarning: "bold warning",
+    contextError: "bold error",
+    tokens: "muted",
+    cost: "bold success",
+    separator: "muted",
     runtimePrefix: "",
-    extensionStatus: "bright-black",
-    sessionDuration: "yellow",
+    extensionStatus: "muted",
+    sessionDuration: "warning",
     packageVersion: "208",
-    gitCommit: "bold green",
-    gitMetricsAdded: "bold green",
-    gitMetricsDeleted: "bold red",
-    username: "bold yellow",
-    time: "bold yellow",
-    os: "bold white",
+    gitCommit: "bold success",
+    gitMetricsAdded: "bold success",
+    gitMetricsDeleted: "bold error",
+    username: "bold warning",
+    time: "bold warning",
+    os: "bold text",
   },
   components: {
     editor: defaultEditor,
     userMessages: normalizeUserMessages(undefined),
     workingLine: defaultWorkingLine,
-    selectorBorders: { enabled: true, style: "zentui" },
+    selectorBorders: { enabled: true, style: "one-ui" },
     footer: defaultFooter,
   },
 };
@@ -217,7 +218,7 @@ const knownComponentStyleIds: Record<
     "compact",
     "labeled",
   ]),
-  selectorBorders: new Set(["zentui"]),
+  selectorBorders: new Set(["one-ui", "zentui"]),
   footer: new Set(["native", "starship", "hidden"]),
 };
 const retiredEditorStyleIds = new Set([
@@ -226,7 +227,7 @@ const retiredEditorStyleIds = new Set([
   "accent-rail",
 ]);
 const unsupportedComponentStyles = new WeakMap<
-  ZentuiConfig,
+  PolishedTuiConfig,
   ReadonlySet<ComponentStyleOwner>
 >();
 const styleOwners = Object.keys(
@@ -247,7 +248,7 @@ function unsupportedSelectedStyleId(
 }
 
 export function hasUnsupportedComponentStyle(
-  config: ZentuiConfig,
+  config: PolishedTuiConfig,
   owner: ComponentStyleOwner,
 ): boolean {
   return unsupportedComponentStyles.get(config)?.has(owner) ?? false;
@@ -262,19 +263,20 @@ function resolveComponents(value: unknown): ComponentsConfig {
     workingLine: normalizeWorkingLine(source.workingLine),
     selectorBorders: {
       enabled: booleanValue(selector.enabled, true),
-      style: "zentui",
+      // 只有一种样式；旧配置里的 `zentui` 一律按 `one-ui` 读取。
+      style: "one-ui",
     },
     footer: normalizeFooter(source.footer),
   };
 }
 
 /** 各配置领域在此组合，运行时仅使用 canonical 结构。 */
-export function mergeConfig(parsed: unknown): ZentuiConfig {
+export function mergeConfig(parsed: unknown): PolishedTuiConfig {
   const record = recordValue(parsed);
   const icons = recordValue(record.icons);
   const colors = recordValue(record.colors);
   const interval = record.projectRefreshIntervalMs;
-  const config: ZentuiConfig = {
+  const config: PolishedTuiConfig = {
     projectRefreshIntervalMs:
       typeof interval === "number" && Number.isFinite(interval)
         ? Math.round(interval) <= 0
@@ -314,12 +316,12 @@ export function mergeConfig(parsed: unknown): ZentuiConfig {
   return config;
 }
 
-export function loadConfig(): ZentuiConfig {
+export function loadConfig(): PolishedTuiConfig {
   return mergeConfig(configStore.read());
 }
 
 export function getExtensionStatusPlacement(
-  config: ZentuiConfig,
+  config: PolishedTuiConfig,
   key: string,
 ): ExtensionStatusPlacement {
   const statuses = config.components.footer.styles.starship.extensionStatuses;
@@ -335,14 +337,14 @@ export function getExtensionStatusPlacement(
 }
 
 export function getExtensionStatusColorMode(
-  config: ZentuiConfig,
+  config: PolishedTuiConfig,
   key: string,
 ): ExtensionStatusColorMode {
   const modes =
     config.components.footer.styles.starship.extensionStatuses.colorModes;
   return Object.hasOwn(modes, key) && isExtensionStatusColorMode(modes[key])
     ? modes[key]
-    : "zentui";
+    : "themed";
 }
 
 /** 纯配置修改可在一次 ConfigStore.update 中组合成 Preset。 */
@@ -371,7 +373,7 @@ export function mutateComponentsRecord(
 function mutateConfig(
   path: string,
   update: (record: ConfigRecord) => void,
-): ZentuiConfig {
+): PolishedTuiConfig {
   const mutate = (record: ConfigRecord) => {
     record.version = 1;
     update(record);
@@ -387,7 +389,7 @@ function saveComponentsMutation(
   update: (components: ComponentsConfig) => void,
   path: string,
   replacedStyle?: ComponentStyleOwner,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return mutateConfig(path, (record) =>
     mutateComponentsRecord(
       record,
@@ -405,7 +407,7 @@ export function saveEditorComponentPatch(
     >
   >,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveComponentsMutation(
     (components) => {
       components.editor = overlayKnown(
@@ -420,7 +422,7 @@ export function saveEditorComponentPatch(
 export function saveMinimalistEditorStylePatch(
   patch: Partial<MinimalistEditorStyleConfig>,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveComponentsMutation((components) => {
     components.editor.styles.minimalist = overlayKnown(
       components.editor.styles.minimalist,
@@ -431,7 +433,7 @@ export function saveMinimalistEditorStylePatch(
 export function saveUserMessagesComponentPatch(
   patch: Partial<Pick<UserMessagesComponentConfig, "enabled" | "style">>,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveComponentsMutation(
     (components) => {
       components.userMessages = overlayKnown(
@@ -446,7 +448,7 @@ export function saveUserMessagesComponentPatch(
 export function saveWorkingLineComponentPatch(
   patch: WorkingLineComponentPatch,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveComponentsMutation((components) => {
     components.workingLine = overlayKnown(
       components.workingLine,
@@ -457,7 +459,7 @@ export function saveWorkingLineComponentPatch(
 export function saveSelectorBordersComponentPatch(
   patch: Partial<SelectorBordersComponentConfig>,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveComponentsMutation(
     (components) => {
       components.selectorBorders = overlayKnown(
@@ -472,7 +474,7 @@ export function saveSelectorBordersComponentPatch(
 export function saveFooterComponentPatch(
   patch: Partial<Pick<FooterComponentConfig, "style" | "modelLabel">>,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveComponentsMutation(
     (components) => {
       components.footer = overlayKnown(
@@ -506,7 +508,7 @@ export type StarshipFooterStylePatch = Partial<
 export function saveStarshipFooterStylePatch(
   patch: StarshipFooterStylePatch,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveComponentsMutation((components) => {
     components.footer.styles.starship = overlayKnown(
       components.footer.styles.starship,
@@ -517,7 +519,7 @@ export function saveStarshipFooterStylePatch(
 export function saveUiFeaturesPatch(
   patch: Partial<UiFeaturesConfig>,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveComponentsMutation(
     (components) => {
       if (typeof patch.editor === "boolean") {
@@ -539,7 +541,7 @@ export function saveUiFeaturesPatch(
 export function saveFooterSegmentsPatch(
   patch: Partial<FooterSegmentsConfig>,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   const segments = Object.fromEntries(
     Object.entries(patch).filter(
       ([key, value]) =>
@@ -551,7 +553,7 @@ export function saveFooterSegmentsPatch(
 export function saveFooterFormatPatch(
   value: string,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveStarshipFooterStylePatch(
     { format: typeof value === "string" ? value : "" },
     path,
@@ -564,7 +566,7 @@ export function saveResponsiveFooterPatch(
     compactFooterMaxLines?: CompactFooterMaxLines;
   },
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   const canonical: Partial<StarshipFooterStyleConfig> = {};
   if (typeof patch.responsiveFooter === "boolean") {
     canonical.responsive = patch.responsiveFooter;
@@ -582,7 +584,7 @@ export function saveResponsiveFooterPatch(
 export function saveIconsModePatch(
   mode: IconMode,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return mutateConfig(path, (record) => {
     record.icons = {
       ...recordValue(record.icons),
@@ -593,7 +595,7 @@ export function saveIconsModePatch(
 export function saveContextStylePatch(
   style: ContextStyle,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveStarshipFooterStylePatch(
     { contextStyle: parseContextStyle(style) },
     path,
@@ -602,7 +604,7 @@ export function saveContextStylePatch(
 export function saveSeparatorPatch(
   separator: SeparatorStyle,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveStarshipFooterStylePatch(
     { separator: parseSeparatorStyle(separator) },
     path,
@@ -611,7 +613,7 @@ export function saveSeparatorPatch(
 export function saveContextThresholdsPatch(
   patch: Partial<ContextThresholds>,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   if (typeof patch.warning === "bigint" || typeof patch.error === "bigint") {
     throw new TypeError("Context thresholds must be JSON-serializable numbers");
   }
@@ -620,19 +622,19 @@ export function saveContextThresholdsPatch(
 export function savePathDisplayPatch(
   patch: Partial<PathDisplayConfig>,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveStarshipFooterStylePatch({ pathDisplay: patch }, path);
 }
 export function saveGitBranchPatch(
   patch: Partial<GitBranchConfig>,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveStarshipFooterStylePatch({ gitBranch: patch }, path);
 }
 export function saveEditorModelLabel(
   value: ModelLabelSource,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveComponentsMutation((components) => {
     components.editor.modelLabel = parseEditorModelLabel(value);
     components.footer.modelLabel = parseEditorModelLabel(value);
@@ -641,19 +643,19 @@ export function saveEditorModelLabel(
 export function saveEditorStyle(
   value: EditorStyle,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveEditorComponentPatch({ style: parseEditorStyle(value) }, path);
 }
 export function saveMinimalistPatch(
   patch: Partial<MinimalistConfig>,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveMinimalistEditorStylePatch(patch, path);
 }
 export function saveEditorBorderColorMode(
   value: EditorBorderColorMode,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveEditorComponentPatch(
     { borderColorMode: parseEditorBorderColorMode(value) },
     path,
@@ -662,7 +664,7 @@ export function saveEditorBorderColorMode(
 export function saveGitCommitPatch(
   patch: Partial<Pick<GitCommitConfig, "onlyDetached" | "showTag">>,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   const valid = Object.fromEntries(
     Object.entries(patch).filter(
       ([key, value]) =>
@@ -675,7 +677,7 @@ export function saveGitCommitPatch(
 export function saveGitMetricsPatch(
   patch: Partial<GitMetricsConfig>,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   const valid = Object.fromEntries(
     Object.entries(patch).filter(
       ([key, value]) =>
@@ -688,7 +690,7 @@ export function saveGitMetricsPatch(
 export function saveExtensionStatusDefaultPlacement(
   placement: ExtensionStatusPlacement,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveComponentsMutation((components) => {
     components.footer.styles.starship.extensionStatuses.defaultPlacement =
       isExtensionStatusPlacement(placement) ? placement : "right";
@@ -698,7 +700,7 @@ export function saveExtensionStatusPlacement(
   key: string,
   placement: ExtensionStatusPlacement,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveComponentsMutation((components) => {
     Object.defineProperty(
       components.footer.styles.starship.extensionStatuses.placements,
@@ -716,7 +718,7 @@ export function saveExtensionStatusColorMode(
   key: string,
   colorMode: ExtensionStatusColorMode,
   path = configPath,
-): ZentuiConfig {
+): PolishedTuiConfig {
   return saveComponentsMutation((components) => {
     Object.defineProperty(
       components.footer.styles.starship.extensionStatuses.colorModes,