pi-one-ui 0.7.2 → 0.8.0

package/CHANGELOG.md

@@ -6,6 +6,26 @@ 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
@@ -21,6 +41,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.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
@@ -174,7 +200,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.7.2...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

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.2
+### Upgrading to 0.8.0
 
-This release paints the Editor completion dropdown selection with the editor frame color so it follows the adaptive thinking-level chain, and keeps the tool loading animation alive during long-running commands.
-
-Existing canonical v1 configurations and commands remain compatible; no migration is required.
+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.2` 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. The completion menu selection shares the editor frame color and follows the same chain.
+  - `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.2
+### 升级到 0.8.0
 
-本次统一编辑器补全下拉选中项与编辑器外框的颜色，选中项随 thinking 档位自适应变化；同时修复长时间命令执行期间工具加载动画停止刷新的问题。
-
-现有 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.2` 更新版本指定。更新安装包后，完整退出并重启 Pi。
+若安装时固定了版本，执行 `pi install npm:pi-one-ui@0.8.0` 更新版本指定。更新安装包后，完整退出并重启 Pi，不要使用 `/reload`：跨 reload 的补丁协调键已改名，直接重载会让旧实例留下的标记无法被识别。
 
 ## 配置
 
@@ -157,7 +155,8 @@ 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:` 前缀。
+  - `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,

package/extensions/app/runtime/prototype-patch-registry.ts

@@ -1,5 +1,9 @@
-export const ZENTUI_PROTOTYPE_PATCH_REGISTRY = Symbol.for(
-  "pi-zentui.prototype-patch-registry",
+/**
+ * Global registry slot for prototype patches. The key is only shared by module
+ * instances of the same process, so it has to stay stable across `/reload`.
+ */
+export const POLISHED_PROTOTYPE_PATCH_REGISTRY = Symbol.for(
+  "pi-one-ui.prototype-patch-registry",
 );
 
 type PrototypePatchAdapter =
@@ -35,7 +39,7 @@ type PatchRegistry = Map<PrototypePatchAdapter, PatchRecord>;
 type PatchTarget = Record<PropertyKey, unknown>;
 
 function existingRegistry(target: PatchTarget): PatchRegistry | undefined {
-  const existing = target[ZENTUI_PROTOTYPE_PATCH_REGISTRY];
+  const existing = target[POLISHED_PROTOTYPE_PATCH_REGISTRY];
   return existing instanceof Map ? (existing as PatchRegistry) : undefined;
 }
 
@@ -43,7 +47,7 @@ function registryFor(target: PatchTarget): PatchRegistry {
   const existing = existingRegistry(target);
   if (existing) return existing;
   const registry: PatchRegistry = new Map();
-  Object.defineProperty(target, ZENTUI_PROTOTYPE_PATCH_REGISTRY, {
+  Object.defineProperty(target, POLISHED_PROTOTYPE_PATCH_REGISTRY, {
     value: registry,
     configurable: true,
   });
@@ -100,7 +104,7 @@ function createCleanup(
     if (current !== record) return;
     restorePredecessor(target, record);
     registry.delete(adapter);
-    if (registry.size === 0) delete target[ZENTUI_PROTOTYPE_PATCH_REGISTRY];
+    if (registry.size === 0) delete target[POLISHED_PROTOTYPE_PATCH_REGISTRY];
   };
 }
 
@@ -124,7 +128,7 @@ export function installPrototypePatch(
     );
     const predecessor = target[method];
     if (typeof predecessor !== "function") {
-      if (registry.size === 0) delete target[ZENTUI_PROTOTYPE_PATCH_REGISTRY];
+      if (registry.size === 0) delete target[POLISHED_PROTOTYPE_PATCH_REGISTRY];
       throw new TypeError(
         `Cannot patch ${method}: predecessor is not a function`,
       );
@@ -135,7 +139,7 @@ export function installPrototypePatch(
       predecessorDescriptor,
       wrapper: () => undefined,
     };
-    const wrapper: PrototypeMethod = function zentuiPrototypeWrapper(
+    const wrapper: PrototypeMethod = function polishedPrototypeWrapper(
       this: unknown,
       ...args: unknown[]
     ): unknown {
@@ -152,7 +156,7 @@ export function installPrototypePatch(
     try {
       installWrapper(target, nextRecord);
     } catch (error) {
-      if (registry.size === 0) delete target[ZENTUI_PROTOTYPE_PATCH_REGISTRY];
+      if (registry.size === 0) delete target[POLISHED_PROTOTYPE_PATCH_REGISTRY];
       throw error;
     }
     record = nextRecord;
@@ -179,5 +183,5 @@ export function removePrototypePatch(
   deactivateRecord(record);
   restorePredecessor(target, record);
   registry.delete(adapter);
-  if (registry.size === 0) delete target[ZENTUI_PROTOTYPE_PATCH_REGISTRY];
+  if (registry.size === 0) delete target[POLISHED_PROTOTYPE_PATCH_REGISTRY];
 }