rinco-pi-hud 1.4.0 → 1.5.0

package/README.md

@@ -98,6 +98,8 @@ Variables accept `$name` or `${name}`. The [footer reference](docs/footer.md) li
 
 `/zentui` writes to `~/.pi/agent/rinco-pi-hud.json` and applies changes immediately. It covers the separator style, icon mode (`nerd`, `ascii`, or `auto`), footer colors (Pi theme tokens or terminal palette styles), context rendering (text, gauge, or both), the project refresh interval, and third-party extension statuses with their own placement and color mode.
 
+Footer colors follow the active Pi theme by default, including theme switches and automatic light/dark changes. In `/zentui`, **Footer colors → theme** enables this behavior; **terminal** keeps the original Sakura RGB palette. Explicit custom colors (hex, indexed, or `fg:`/`bg:` styles) remain fixed in either mode. Remove those entries from `colors` to restore automatic theme colors.
+
 See [docs/footer.md](docs/footer.md) for the full variable and segment reference.
 
 ## Project contents
@@ -156,7 +158,7 @@ The footer measures the terminal and wraps at segment boundaries, so narrow wind
 <details>
 <summary>Colors look incorrect</summary>
 
-The default RGB palette follows Pi's detected terminal color mode, with 256-color approximation when needed. Check terminal capability settings and try the theme color source in `/zentui`.
+The default palette follows the active Pi theme. If the footer still uses fixed colors, select **Footer colors → theme** in `/zentui` and remove explicit color overrides from `~/.pi/agent/rinco-pi-hud.json`. Third-party statuses set to `original` retain their own colors. Truecolor and 256-color output follow Pi's detected terminal capabilities.
 </details>
 
 <details>

package/docs/README.zh-CN.md

@@ -98,6 +98,8 @@ Usage 行跟随当前模型的 Provider：
 
 `/zentui` 把配置写入 `~/.pi/agent/rinco-pi-hud.json`，改动立即生效。可配置分隔符样式、图标模式（`nerd`、`ascii`、`auto`）、脚注配色（Pi 主题色或终端调色板样式）、Context 渲染方式（文本、进度条或两者）、项目刷新间隔，以及第三方扩展状态的位置与颜色模式。
 
+脚注默认自动跟随当前 Pi 主题，包括手动切换主题和自动明暗切换。在 `/zentui` 中选择 **Footer colors → theme** 启用跟随，选择 **terminal** 则保留原有 Sakura RGB 配色。显式自定义颜色（十六进制、索引色或 `fg:`/`bg:` 样式）在两种模式下都会保留；删除 `colors` 中的相应配置即可恢复自动配色。
+
 完整的变量与状态段参考见 [docs/footer.md](footer.md)。
 
 ## 仓库结构
@@ -156,7 +158,7 @@ npx tsx assets/readme/source/build-assets.mts /tmp/footer.json
 <details>
 <summary>颜色显示异常</summary>
 
-默认 RGB 配色跟随 Pi 检测到的终端颜色模式，必要时近似为 256 色。请检查终端能力配置，也可以在 `/zentui` 中切换到主题色源。
+默认配色自动跟随当前 Pi 主题。如果脚注仍使用固定颜色，请在 `/zentui` 中选择 **Footer colors → theme**，并删除 `~/.pi/agent/rinco-pi-hud.json` 中的显式颜色覆盖。设为 `original` 的第三方扩展状态会保留自己的颜色。Truecolor 与 256 色输出仍按 Pi 检测到的终端能力选择。
 </details>
 
 <details>

package/docs/footer.md

@@ -26,6 +26,24 @@ Control each default-layout row independently:
 
 The command shape is `/zentui row <project|session|activity|usage> <enable|disable|toggle>`. Values persist under `footerRows`; all four default to `true`. Row switches apply only to the default layout and do not alter a custom single-line `footerFormat`.
 
+## Colors and theme switching
+
+By default, `colorSources.starship` is `"theme"`. Built-in footer colors use semantic Pi theme tokens such as `accent`, `muted`, `success`, `warning`, and `error`; runtime labels also use the active theme. Switching themes, including automatic light/dark switching, recolors the footer without reloading the extension. This applies to both the default rows and custom templates.
+
+To enable theme colors in an existing configuration, use **Footer colors → theme** in `/zentui`, or set:
+
+```json
+{
+  "colorSources": {
+    "starship": "theme"
+  }
+}
+```
+
+Select `"terminal"` to retain the original Sakura RGB defaults and Starship runtime colors. Changing the source does not write a palette into your configuration.
+
+Entries you explicitly set under `colors` override the selected defaults. Semantic tokens (for example, `"cwd": "bold accent"`) follow the theme; hex colors, indexed colors, and explicit `fg:`/`bg:` styles remain fixed. Remove an override to restore the default for that segment. Third-party extension statuses in `original` color mode retain their own ANSI colors; use `zentui` color mode to recolor them with the HUD.
+
 ## Built-in status segments
 
 | Key | Default | Group | Description |

package/extensions/hud/commands/settings.ts

@@ -92,7 +92,7 @@ const colorSettingLabels: Record<ColorSettingId, string> = {
 
 const colorSettingDescriptions: Record<ColorSettingId, string> = {
 	starship:
-		"Choose whether footer runtime/git/context colors use Pi theme tokens or terminal palette styles.",
+		"Follow the active Pi theme automatically (theme), or keep the original Sakura/runtime palette (terminal). Explicit color overrides are preserved.",
 };
 
 const featureSettingLabels: Record<FeatureSettingId, string> = {

package/extensions/hud/config/normalize.ts

@@ -34,6 +34,7 @@ import {
 	type PathDisplayConfig,
 	type PolishedTuiConfig,
 	type SeparatorStyle,
+	terminalDefaultColors,
 	type UiFeaturesConfig,
 } from "./schema.js";
 
@@ -374,7 +375,7 @@ export function mergeConfig(parsed: unknown): PolishedTuiConfig {
 		gitBranch,
 		icons: resolveConfiguredIcons(iconMode, iconOverrides),
 		colors: {
-			...defaultConfig.colors,
+			...(colorSources.starship === "terminal" ? terminalDefaultColors : defaultConfig.colors),
 			...colors,
 		},
 		colorSources: { ...colorSources },

package/extensions/hud/config/schema.ts

@@ -226,6 +226,30 @@ export const FOOTER_FORMAT_ALIASES: Record<string, string> = {
 
 export const configPath = join(getAgentDir(), "rinco-pi-hud.json");
 
+/** Preserve the original Sakura palette for users who explicitly select terminal colors. */
+export const terminalDefaultColors: PolishedTuiConfig["colors"] = {
+	cwd: "bold #F2A7C6",
+	gitBranch: "bold #C7B8F5",
+	gitStatus: "bold #F6BC9A",
+	contextNormal: "#AEE5C5",
+	contextWarning: "bold #F3D98B",
+	contextError: "bold #FF8FA3",
+	tokens: "#A99BAE",
+	cost: "bold #AEE5C5",
+	separator: "#716879",
+	runtimePrefix: "#9FD3F2",
+	extensionStatus: "#EFC3E6",
+	sessionDuration: "#F3D98B",
+	packageVersion: "#F6BC9A",
+	gitCommit: "#AEE5C5",
+	gitMetricsAdded: "#AEE5C5",
+	gitMetricsDeleted: "#FF8FA3",
+	username: "#F3D98B",
+	time: "#F3D98B",
+	os: "#F7EEF8",
+	muted: "#A99BAE",
+};
+
 export const defaultConfig: PolishedTuiConfig = {
 	projectRefreshIntervalMs: DEFAULT_PROJECT_REFRESH_INTERVAL_MS,
 	footerFormat: "",
@@ -239,29 +263,29 @@ export const defaultConfig: PolishedTuiConfig = {
 		...NERD_DEFAULT_ICONS,
 	},
 	colors: {
-		cwd: "bold #F2A7C6",
-		gitBranch: "bold #C7B8F5",
-		gitStatus: "bold #F6BC9A",
-		contextNormal: "#AEE5C5",
-		contextWarning: "bold #F3D98B",
-		contextError: "bold #FF8FA3",
-		tokens: "#A99BAE",
-		cost: "bold #AEE5C5",
-		separator: "#716879",
-		runtimePrefix: "#9FD3F2",
-		extensionStatus: "#EFC3E6",
-		sessionDuration: "#F3D98B",
-		packageVersion: "#F6BC9A",
-		gitCommit: "#AEE5C5",
-		gitMetricsAdded: "#AEE5C5",
-		gitMetricsDeleted: "#FF8FA3",
-		username: "#F3D98B",
-		time: "#F3D98B",
-		os: "#F7EEF8",
-		muted: "#A99BAE",
+		cwd: "bold accent",
+		gitBranch: "bold syntaxVariable",
+		gitStatus: "bold warning",
+		contextNormal: "success",
+		contextWarning: "bold warning",
+		contextError: "bold error",
+		tokens: "muted",
+		cost: "bold success",
+		separator: "dim",
+		runtimePrefix: "syntaxFunction",
+		extensionStatus: "customMessageLabel",
+		sessionDuration: "syntaxNumber",
+		packageVersion: "syntaxType",
+		gitCommit: "success",
+		gitMetricsAdded: "toolDiffAdded",
+		gitMetricsDeleted: "toolDiffRemoved",
+		username: "syntaxNumber",
+		time: "syntaxNumber",
+		os: "text",
+		muted: "muted",
 	},
 	colorSources: {
-		starship: "terminal",
+		starship: "theme",
 	},
 	features: {
 		statusLine: true,

package/extensions/hud/footer/index.ts

@@ -26,10 +26,10 @@ import {
 	formatOsLabel,
 	formatPackageVersionSegment,
 	formatRuntimeSegment,
+	formatRuntimeValue,
 	formatTimeLabel,
 	formatUsernameHostLabel,
 } from "../telemetry/format.js";
-import { resolveRuntimeSymbol } from "../ui/icons.js";
 import type { LiveContextOverride } from "../session/live-context.js";
 import type { FooterState } from "../state/index.js";
 import { renderStyleForSource } from "../ui/style.js";
@@ -180,12 +180,8 @@ export function installFooter(
 							return statusBlock;
 						case "git_state":
 							return gitStateBlock;
-						case "runtime": {
-							if (!safeRuntime) return "";
-							const symbol = resolveRuntimeSymbol(safeRuntime.name, safeRuntime.symbol, iconMode);
-							const label = safeRuntime.version ? `${symbol} ${safeRuntime.version}` : symbol;
-							return renderStyleForSource(theme, colorSource, safeRuntime.style, label);
-						}
+						case "runtime":
+							return formatRuntimeValue(theme, safeRuntime, colorSource, iconMode);
 						case "session_duration":
 							return state.sessionStartEpoch
 								? renderStyleForSource(

package/extensions/hud/footer/render-labels.ts

@@ -13,6 +13,7 @@ import { truncateToWidth } from "@earendil-works/pi-tui";
 import type { ColorSource, PolishedTuiConfig } from "../config/config.js";
 import { formatSkillCounts } from "../segments/skill-activity.js";
 import type { FooterState } from "../state/index.js";
+import type { RuntimeInfo } from "../segments/runtime.js";
 import { getTelemetryStats } from "../state/telemetry.js";
 import { buildSessionDurationLabel, formatCount } from "../telemetry/format.js";
 import { renderStyleForSource, type ThemeLike } from "../ui/style.js";
@@ -25,8 +26,7 @@ export function safeStatusText(value: string | null | undefined, maxLength = 256
 
 export type SanitizedFooterInputs = {
 	safeCwd: string;
-	safeRuntime:
-		{ name: string; symbol: string; style: string; version: string | undefined } | undefined;
+	safeRuntime: RuntimeInfo | undefined;
 	safePackageVersion: { ecosystem: string; version: string } | undefined;
 	safeCommit: { oid: string | null; detached: boolean; tag: string | null } | undefined;
 };

package/extensions/hud/segments/runtime-definitions.ts

@@ -240,6 +240,7 @@ const runtimes: RuntimeDef[] = [
 		name: "php",
 		symbol: "",
 		style: "147 bold",
+		themeStyle: "bold syntaxVariable",
 		priority: PRIORITY_COMMON,
 		detect: { files: ["composer.json"] },
 		version: async () =>
@@ -265,6 +266,7 @@ const runtimes: RuntimeDef[] = [
 		name: "cpp",
 		symbol: "",
 		style: "bold 149",
+		themeStyle: "bold success",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["cpp", "cc", "cxx", "c++", "hpp", "hh", "hxx", "h++", "tcc"] },
 		version: versionFromCommands([
@@ -277,6 +279,7 @@ const runtimes: RuntimeDef[] = [
 		name: "c",
 		symbol: "",
 		style: "bold 149",
+		themeStyle: "bold success",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["c", "h"] },
 		version: versionFromCommands([
@@ -414,6 +417,7 @@ const runtimes: RuntimeDef[] = [
 		name: "gleam",
 		symbol: "",
 		style: "bold #FFAFF3",
+		themeStyle: "bold syntaxKeyword",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["gleam"], files: ["gleam.toml"] },
 		version: versionFromCommands([{ command: "gleam", args: ["--version"] }]),
@@ -438,6 +442,7 @@ const runtimes: RuntimeDef[] = [
 		name: "haxe",
 		symbol: "",
 		style: "bold fg:202",
+		themeStyle: "bold syntaxType",
 		priority: PRIORITY_DEFAULT,
 		detect: {
 			extensions: ["hx", "hxml"],
@@ -482,6 +487,7 @@ const runtimes: RuntimeDef[] = [
 		name: "mojo",
 		symbol: "󰈸",
 		style: "bold 208",
+		themeStyle: "bold syntaxType",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["mojo", "🔥"] },
 		version: versionFromCommands([{ command: "mojo", args: ["--version"] }]),
@@ -534,6 +540,7 @@ const runtimes: RuntimeDef[] = [
 		name: "perl",
 		symbol: "",
 		style: "bold 149",
+		themeStyle: "bold success",
 		priority: PRIORITY_DEFAULT,
 		detect: {
 			extensions: ["pl", "pm", "pod"],
@@ -564,6 +571,7 @@ const runtimes: RuntimeDef[] = [
 		name: "pulumi",
 		symbol: "",
 		style: "bold 5",
+		themeStyle: "bold syntaxKeyword",
 		priority: PRIORITY_DEFAULT,
 		detect: { files: ["Pulumi.yaml", "Pulumi.yml"] },
 		version: versionFromCommands([{ command: "pulumi", args: ["version"] }]),
@@ -580,6 +588,7 @@ const runtimes: RuntimeDef[] = [
 		name: "raku",
 		symbol: "󱖊",
 		style: "bold 149",
+		themeStyle: "bold success",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["p6", "pm6", "pod6", "raku", "rakumod"], files: ["META6.json"] },
 		version: versionFromCommands([{ command: "raku", args: ["--version"] }]),
@@ -636,6 +645,7 @@ const runtimes: RuntimeDef[] = [
 		name: "swift",
 		symbol: "",
 		style: "bold 202",
+		themeStyle: "bold syntaxType",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["swift"], files: ["Package.swift"] },
 		version: versionFromCommands([
@@ -646,6 +656,7 @@ const runtimes: RuntimeDef[] = [
 		name: "terraform",
 		symbol: "",
 		style: "bold 105",
+		themeStyle: "bold syntaxVariable",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["tf", "tfplan", "tfstate"], folders: [".terraform"] },
 		version: versionFromCommands([
@@ -657,6 +668,7 @@ const runtimes: RuntimeDef[] = [
 		name: "typst",
 		symbol: "",
 		style: "bold #0093A7",
+		themeStyle: "bold syntaxFunction",
 		priority: PRIORITY_DEFAULT,
 		detect: { extensions: ["typ"], files: ["template.typ"] },
 		version: versionFromCommands([{ command: "typst", args: ["--version"] }]),

package/extensions/hud/segments/runtime.ts

@@ -7,9 +7,11 @@ export type RuntimeMetadata = {
 	name: string;
 	symbol: string;
 	style: string;
+	/** Semantic alternative for built-in RGB/indexed terminal styles. */
+	themeStyle?: string;
 };
 
-export type RuntimeInfo = Pick<RuntimeMetadata, "name" | "symbol" | "style"> & {
+export type RuntimeInfo = RuntimeMetadata & {
 	version?: string;
 };
 
@@ -114,10 +116,11 @@ function matchesDetection(
 const sortedRuntimes = runtimeDefinitions;
 
 export const runtimeMetadata: RuntimeMetadata[] = runtimeDefinitions.map(
-	({ name, symbol, style }) => ({
+	({ name, symbol, style, themeStyle }) => ({
 		name,
 		symbol,
 		style,
+		themeStyle,
 	}),
 );
 
@@ -170,6 +173,7 @@ export async function readRuntimeInfo(cwd: string): Promise<RuntimeReadResult> {
 					name: runtime.name,
 					symbol: runtime.symbol,
 					style: runtime.style,
+					themeStyle: runtime.themeStyle,
 					version: await runtime.version(cwd),
 				},
 			};

package/extensions/hud/telemetry/format.ts

@@ -304,17 +304,29 @@ export function buildContextLabel(ctx: ExtensionContext): string {
 	return formatContextPercentLabel(usage?.percent, contextWindow);
 }
 
-export function formatRuntimeSegment(
+/** Render just the runtime value for both default rows and custom templates. */
+export function formatRuntimeValue(
 	theme: Pick<Theme, "fg">,
 	runtime: RuntimeInfo | undefined,
-	prefixStyle: ColorSpec,
 	colorSource: ColorSource,
 	mode: IconMode = "auto",
 ): string {
 	if (!runtime) return "";
 	const symbol = resolveRuntimeSymbol(runtime.name, runtime.symbol, mode);
 	const label = runtime.version ? `${symbol} ${runtime.version}` : symbol;
-	return `${renderStyleForSource(theme, colorSource, prefixStyle, "via")} ${renderStyleForSource(theme, colorSource, runtime.style, label)}`;
+	const style = colorSource === "theme" ? (runtime.themeStyle ?? runtime.style) : runtime.style;
+	return renderStyleForSource(theme, colorSource, style, label);
+}
+
+export function formatRuntimeSegment(
+	theme: Pick<Theme, "fg">,
+	runtime: RuntimeInfo | undefined,
+	prefixStyle: ColorSpec,
+	colorSource: ColorSource,
+	mode: IconMode = "auto",
+): string {
+	if (!runtime) return "";
+	return `${renderStyleForSource(theme, colorSource, prefixStyle, "via")} ${formatRuntimeValue(theme, runtime, colorSource, mode)}`;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rinco-pi-hud",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "A dynamic HUD footer for Pi, ported from Sakura Zentui Footer.",
   "type": "module",
   "license": "MIT",