rinco-pi-hud 1.0.0

package/extensions/hud/ui/icons.ts

@@ -0,0 +1,239 @@
+/**
+ * Icon mode defaults and resolvers.
+ *
+ * Nerd defaults must stay byte-identical to historical `defaultConfig.icons`,
+ * except where intentionally changed to match the Starship Nerd Font preset.
+ * User string overrides always win over mode defaults.
+ */
+
+export type IconMode = "auto" | "nerd" | "ascii";
+
+export type IconGlyphs = {
+	cwd: string;
+	git: string;
+	ahead: string;
+	behind: string;
+	diverged: string;
+	conflicted: string;
+	untracked: string;
+	stashed: string;
+	modified: string;
+	staged: string;
+	renamed: string;
+	deleted: string;
+	typechanged: string;
+	cacheHit: string;
+	username: string;
+	time: string;
+	os: string;
+	package: string;
+};
+
+export type ResolvedIcons = IconGlyphs & { mode: IconMode };
+
+export const ICON_GLYPH_KEYS = [
+	"cwd",
+	"git",
+	"ahead",
+	"behind",
+	"diverged",
+	"conflicted",
+	"untracked",
+	"stashed",
+	"modified",
+	"staged",
+	"renamed",
+	"deleted",
+	"typechanged",
+	"cacheHit",
+	"username",
+	"time",
+	"os",
+	"package",
+] as const satisfies readonly (keyof IconGlyphs)[];
+
+/**
+ * Nerd Font defaults.
+ *
+ * The `cwd` icon is intentionally empty — Starship's `directory` module
+ * has no default symbol. Other defaults match historical values; new
+ * additions (e.g. `package`) come from the Starship Nerd Font preset
+ * (https://starship.rs/presets/nerd-font).
+ */
+export const NERD_DEFAULT_ICONS: IconGlyphs = {
+	cwd: "",
+	git: "",
+	ahead: "↑",
+	behind: "↓",
+	diverged: "⇕",
+	conflicted: "=",
+	untracked: "?",
+	stashed: "$",
+	modified: "!",
+	staged: "+",
+	renamed: "»",
+	deleted: "✘",
+	typechanged: "T",
+	cacheHit: "󰆼",
+	username: "",
+	time: "",
+	os: "",
+	// Starship Nerd Font preset — `package` module glyph.
+	package: "",
+};
+
+export const ASCII_DEFAULT_ICONS: IconGlyphs = {
+	cwd: "",
+	git: "*",
+	ahead: "^",
+	behind: "v",
+	diverged: "^v",
+	conflicted: "=",
+	untracked: "?",
+	stashed: "$",
+	modified: "!",
+	staged: "+",
+	renamed: ">",
+	deleted: "x",
+	typechanged: "T",
+	cacheHit: "c",
+	username: "@",
+	time: "t",
+	os: "o",
+	package: "pkg",
+};
+
+export const OS_PLATFORM_ICONS_NERD: Record<string, string> = {
+	darwin: "\uf179",
+	linux: "\uf17c",
+	win32: "\uf17a",
+};
+
+export const OS_PLATFORM_ICONS_ASCII: Record<string, string> = {
+	darwin: "mac",
+	linux: "linux",
+	win32: "win",
+};
+
+/** Short ASCII labels keyed by runtime `name`. */
+export const RUNTIME_ASCII_SYMBOLS: Record<string, string> = {
+	xmake: "xm",
+	maven: "mvn",
+	gradle: "grd",
+	bun: "bun",
+	deno: "deno",
+	lua: "lua",
+	nodejs: "node",
+	python: "py",
+	golang: "go",
+	rust: "rs",
+	java: "java",
+	ruby: "rb",
+	php: "php",
+	buf: "buf",
+	cmake: "cmake",
+	cpp: "c++",
+	c: "c",
+	cobol: "cob",
+	conda: "conda",
+	crystal: "cr",
+	dart: "dart",
+	dotnet: ".net",
+	elixir: "ex",
+	elm: "elm",
+	erlang: "erl",
+	fennel: "fnl",
+	fortran: "f90",
+	gleam: "glm",
+	guix_shell: "guix",
+	haskell: "hs",
+	haxe: "hx",
+	helm: "helm",
+	julia: "jl",
+	kotlin: "kt",
+	meson: "meson",
+	mojo: "mojo",
+	nim: "nim",
+	nix_shell: "nix",
+	ocaml: "ml",
+	odin: "odin",
+	opa: "opa",
+	perl: "pl",
+	pixi: "pixi",
+	pulumi: "pul",
+	purescript: "purs",
+	raku: "raku",
+	red: "red",
+	rlang: "R",
+	scala: "scala",
+	solidity: "sol",
+	spack: "spack",
+	swift: "swift",
+	terraform: "tf",
+	typst: "typ",
+	vagrant: "vag",
+	vlang: "v",
+	zig: "zig",
+};
+
+export function isIconMode(value: unknown): value is IconMode {
+	return value === "auto" || value === "nerd" || value === "ascii";
+}
+
+export function normalizeIconMode(value: unknown): IconMode {
+	return isIconMode(value) ? value : "auto";
+}
+
+export function modeDefaultIcons(mode: IconMode): IconGlyphs {
+	return mode === "ascii" ? { ...ASCII_DEFAULT_ICONS } : { ...NERD_DEFAULT_ICONS };
+}
+
+export function resolveConfiguredIcons(
+	mode: IconMode,
+	overrides: Partial<IconGlyphs> = {},
+): ResolvedIcons {
+	const base = modeDefaultIcons(mode);
+	return {
+		mode,
+		...base,
+		...overrides,
+	};
+}
+
+/**
+ * Honor a custom `icons.os` when it differs from the mode default.
+ * Otherwise map by platform for the active mode.
+ */
+export function resolveOsIcon(
+	configuredOsIcon: string,
+	mode: IconMode = "auto",
+	platform: string = process.platform,
+): string {
+	const modeDefault = modeDefaultIcons(mode).os;
+	if (configuredOsIcon !== modeDefault) return configuredOsIcon;
+	const platformMap = mode === "ascii" ? OS_PLATFORM_ICONS_ASCII : OS_PLATFORM_ICONS_NERD;
+	return platformMap[platform] ?? configuredOsIcon;
+}
+
+export function resolveRuntimeSymbol(
+	name: string,
+	nerdSymbol: string,
+	mode: IconMode = "auto",
+): string {
+	if (mode !== "ascii") return nerdSymbol;
+	return RUNTIME_ASCII_SYMBOLS[name] ?? (name.slice(0, 3) || "*");
+}
+
+/**
+ * Resolve the package-version segment icon for the active mode.
+ *
+ * Honors a configured `icons.package` override; otherwise falls back to the
+ * mode default (Nerd Font preset / ASCII label).
+ */
+export function resolvePackageIcon(configuredPackageIcon: string, mode: IconMode = "auto"): string {
+	const modeDefault = modeDefaultIcons(mode).package;
+	if (typeof configuredPackageIcon === "string" && configuredPackageIcon.length > 0) {
+		return configuredPackageIcon;
+	}
+	return modeDefault;
+}

package/extensions/hud/ui/style.ts

@@ -0,0 +1,276 @@
+import type { ThemeColor } from "@earendil-works/pi-coding-agent";
+import type { ColorSource, ColorSpec } from "../config/config.js";
+
+type ThemeLike = {
+	fg(color: string, text: string): string;
+	bold?: (text: string) => string;
+	italic?: (text: string) => string;
+	underline?: (text: string) => string;
+};
+
+export type { ThemeLike };
+
+function isHexColor(value: string): boolean {
+	return /^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(value);
+}
+
+function expandHexColor(hex: string): string {
+	const body = hex.slice(1);
+	if (body.length === 3) {
+		return body
+			.split("")
+			.map((ch) => ch + ch)
+			.join("");
+	}
+	return body;
+}
+
+function hexToAnsi(hex: string, isBackground = false): string {
+	const normalized = expandHexColor(hex);
+	const r = Number.parseInt(normalized.slice(0, 2), 16);
+	const g = Number.parseInt(normalized.slice(2, 4), 16);
+	const b = Number.parseInt(normalized.slice(4, 6), 16);
+	return `\x1b[${isBackground ? 48 : 38};2;${r};${g};${b}m`;
+}
+
+const terminalColorCodes = new Map([
+	["black", 30],
+	["red", 31],
+	["green", 32],
+	["yellow", 33],
+	["blue", 34],
+	["purple", 35],
+	["cyan", 36],
+	["white", 37],
+	["bright-black", 90],
+	["bright-red", 91],
+	["bright-green", 92],
+	["bright-yellow", 93],
+	["bright-blue", 94],
+	["bright-purple", 95],
+	["bright-cyan", 96],
+	["bright-white", 97],
+]);
+
+const terminalStyleModifiers = new Map([
+	["bold", 1],
+	["dim", 2],
+	["dimmed", 2],
+	["italic", 3],
+	["underline", 4],
+]);
+
+const themeColorNameMap = new Map([
+	["red", "error"],
+	["bright-red", "error"],
+	["green", "success"],
+	["bright-green", "success"],
+	["yellow", "warning"],
+	["bright-yellow", "warning"],
+	["blue", "syntaxFunction"],
+	["bright-blue", "syntaxFunction"],
+	["cyan", "syntaxFunction"],
+	["bright-cyan", "syntaxFunction"],
+	["purple", "syntaxKeyword"],
+	["bright-purple", "syntaxKeyword"],
+	["black", "muted"],
+	["bright-black", "muted"],
+	["white", "text"],
+	["bright-white", "text"],
+]);
+
+const themeStyleModifiers = new Set(["bold", "italic", "underline"]);
+
+const themeColorTokens = new Set<ThemeColor>([
+	"accent",
+	"border",
+	"borderAccent",
+	"borderMuted",
+	"success",
+	"error",
+	"warning",
+	"muted",
+	"dim",
+	"text",
+	"thinkingText",
+	"userMessageText",
+	"customMessageText",
+	"customMessageLabel",
+	"toolTitle",
+	"toolOutput",
+	"mdHeading",
+	"mdLink",
+	"mdLinkUrl",
+	"mdCode",
+	"mdCodeBlock",
+	"mdCodeBlockBorder",
+	"mdQuote",
+	"mdQuoteBorder",
+	"mdHr",
+	"mdListBullet",
+	"toolDiffAdded",
+	"toolDiffRemoved",
+	"toolDiffContext",
+	"syntaxComment",
+	"syntaxKeyword",
+	"syntaxFunction",
+	"syntaxVariable",
+	"syntaxString",
+	"syntaxNumber",
+	"syntaxType",
+	"syntaxOperator",
+	"syntaxPunctuation",
+	"thinkingOff",
+	"thinkingMinimal",
+	"thinkingLow",
+	"thinkingMedium",
+	"thinkingHigh",
+	"thinkingXhigh",
+	"bashMode",
+]);
+
+function terminalColorToAnsi(color: string, isBackground = false): string | undefined {
+	const normalized = color.toLowerCase();
+	const colorCode = terminalColorCodes.get(normalized);
+	if (colorCode !== undefined) return `${isBackground ? colorCode + 10 : colorCode}`;
+
+	if (/^(?:[0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$/.test(normalized)) {
+		return `${isBackground ? 48 : 38};5;${normalized}`;
+	}
+
+	if (isHexColor(normalized)) return hexToAnsi(normalized, isBackground).slice(2, -1);
+	return undefined;
+}
+
+function isExplicitTerminalColorToken(token: string): boolean {
+	const normalized = token.toLowerCase();
+	if (normalized.startsWith("fg:") || normalized.startsWith("bg:")) return true;
+	if (isHexColor(normalized)) return true;
+	return /^(?:[0-9]|[1-9][0-9]|1[0-9]{2}|2[0-4][0-9]|25[0-5])$/.test(normalized);
+}
+
+function isSupportedStyleToken(token: string): boolean {
+	const normalized = token.toLowerCase();
+	if (terminalStyleModifiers.has(normalized)) return true;
+	if (terminalColorToAnsi(normalized) !== undefined) return true;
+
+	const isForeground = normalized.startsWith("fg:");
+	const isBackground = normalized.startsWith("bg:");
+	if (isForeground || isBackground) {
+		return terminalColorToAnsi(normalized.slice(3), isBackground) !== undefined;
+	}
+
+	return themeColorTokens.has(token as ThemeColor);
+}
+
+export function isSupportedColorSpec(style: ColorSpec): boolean {
+	const trimmed = style.trim();
+	if (trimmed === "") return true;
+	return trimmed.split(/\s+/).every(isSupportedStyleToken);
+}
+
+function applyThemeModifiers(theme: ThemeLike, styleTokens: string[], text: string): string {
+	let rendered = text;
+	for (const token of styleTokens) {
+		const normalized = token.toLowerCase();
+		if (normalized === "bold") rendered = theme.bold?.(rendered) ?? rendered;
+		if (normalized === "italic") rendered = theme.italic?.(rendered) ?? rendered;
+		if (normalized === "underline") rendered = theme.underline?.(rendered) ?? rendered;
+	}
+	return rendered;
+}
+
+export function safeThemeFg(theme: ThemeLike, color: string, text: string): string {
+	try {
+		return theme.fg(color, text);
+	} catch {
+		return text;
+	}
+}
+
+function mapThemeColor(styleTokens: string[]): string | undefined {
+	let fallback: string | undefined;
+	for (const token of styleTokens) {
+		const normalized = token.toLowerCase();
+		if (themeStyleModifiers.has(normalized)) continue;
+		if (normalized === "dim" || normalized === "dimmed") {
+			fallback = "muted";
+			continue;
+		}
+
+		const mapped = themeColorNameMap.get(normalized);
+		if (mapped) return mapped;
+		return token;
+	}
+	return fallback;
+}
+
+/**
+ * Colorize text using a theme color token or hex color.
+ * Non-hex values are passed directly to `theme.fg()`; invalid tokens fall back
+ * to unstyled text so a config typo does not break rendering.
+ */
+export function colorize(theme: ThemeLike, color: ColorSpec, text: string): string {
+	if (isHexColor(color)) {
+		return `${hexToAnsi(color)}${text}\x1b[39m`;
+	}
+	return safeThemeFg(theme, color, text);
+}
+
+/**
+ * Render text with Starship-style terminal styling strings (e.g. "bold red", "fg:202",
+ * "bg:blue", "underline bg:#bf5700").
+ */
+export function renderTerminalStyle(style: string, text: string): string {
+	const codes: string[] = [];
+	for (const token of style.trim().split(/\s+/)) {
+		if (!token) continue;
+
+		const normalized = token.toLowerCase();
+		const modifier = terminalStyleModifiers.get(normalized);
+		if (modifier !== undefined) {
+			codes.push(`${modifier}`);
+			continue;
+		}
+
+		const isForeground = normalized.startsWith("fg:");
+		const isBackground = normalized.startsWith("bg:");
+		const colorName = isForeground || isBackground ? normalized.slice(3) : normalized;
+		const color = terminalColorToAnsi(colorName, isBackground);
+		if (color) codes.push(color);
+	}
+
+	return codes.length ? `\x1b[${codes.join(";")}m${text}\x1b[0m` : text;
+}
+
+/**
+ * Apply Starship-style terminal styling first, falling back to Pi theme tokens for
+ * legacy config values such as "accent" or "syntaxKeyword".
+ */
+export function renderStyle(theme: ThemeLike, style: ColorSpec, text: string): string {
+	if (style.trim() === "") return text;
+	const styled = renderTerminalStyle(style, text);
+	return styled === text ? colorize(theme, style, text) : styled;
+}
+
+export function renderThemeStyle(theme: ThemeLike, style: ColorSpec, text: string): string {
+	const trimmed = style.trim();
+	if (trimmed === "") return text;
+
+	const tokens = trimmed.split(/\s+/).filter(Boolean);
+	if (tokens.some(isExplicitTerminalColorToken)) return renderTerminalStyle(style, text);
+
+	const color = mapThemeColor(tokens) ?? "text";
+	return safeThemeFg(theme, color, applyThemeModifiers(theme, tokens, text));
+}
+
+export function renderStyleForSource(
+	theme: ThemeLike,
+	source: ColorSource,
+	style: ColorSpec,
+	text: string,
+): string {
+	return source === "terminal"
+		? renderStyle(theme, style, text)
+		: renderThemeStyle(theme, style, text);
+}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "rinco-pi-hud",
+  "version": "1.0.0",
+  "description": "A dynamic HUD footer for Pi, ported from Sakura Zentui Footer.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Rinisnotarobot/rinco-pi-hud.git"
+  },
+  "homepage": "https://github.com/Rinisnotarobot/rinco-pi-hud#readme",
+  "bugs": {
+    "url": "https://github.com/Rinisnotarobot/rinco-pi-hud/issues"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "tui",
+    "hud",
+    "sakura"
+  ],
+  "files": [
+    "extensions",
+    "docs",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint --write .",
+    "format:check": "biome format .",
+    "format": "biome format --write .",
+    "verify": "npm run typecheck && npm run lint && npm run test",
+    "pack:check": "npm pack --dry-run"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "pi": {
+    "extensions": [
+      "./extensions/hud/index.ts"
+    ]
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.7",
+    "@earendil-works/pi-ai": "^0.83.0",
+    "@types/node": "^24.12.4",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.9"
+  }
+}