/**

* Interactive terminal theme loader.

*

* Validates theme JSON, resolves color variables, watches custom theme files, and exposes Pi TUI theme adapters.

* Validates theme JSON, resolves color variables, watches custom theme files, and exposes terminal styling helpers.

*/

import * as fs from "node:fs";

import * as path from "node:path";

import {

type EditorTheme,

getCapabilities,

type MarkdownTheme,

type SelectListTheme,

type SettingsListTheme,

} from "@earendil-works/pi-tui";

import { getCapabilities } from "@earendil-works/pi-tui";

import chalk from "chalk";

import { type Static, Type } from "typebox";

import { Compile } from "typebox/compile";

return BUILTIN_THEMES;

}

export function getAvailableThemes(): string[] {

const themes = new Set<string>(Object.keys(getBuiltinThemes()));

const customThemesDir = getCustomThemesDir();

if (fs.existsSync(customThemesDir)) {

const files = fs.readdirSync(customThemesDir);

for (const file of files) {

if (file.endsWith(".json")) {

themes.add(file.slice(0, -5));

}

}

}

for (const name of registeredThemes.keys()) {

themes.add(name);

}

return Array.from(themes).toSorted();

}

export interface ThemeInfo {

name: string;

path: string | undefined;

}

export function getAvailableThemesWithPaths(): ThemeInfo[] {

const themesDir = getThemesDir();

const customThemesDir = getCustomThemesDir();

const result: ThemeInfo[] = [];

// Built-in themes

for (const name of Object.keys(getBuiltinThemes())) {

result.push({ name, path: path.join(themesDir, `${name}.json`) });

}

// Custom themes

if (fs.existsSync(customThemesDir)) {

for (const file of fs.readdirSync(customThemesDir)) {

if (file.endsWith(".json")) {

const name = file.slice(0, -5);

if (!result.some((t) => t.name === name)) {

result.push({ name, path: path.join(customThemesDir, file) });

}

}

}

}

for (const [name, theme] of registeredThemes.entries()) {

if (!result.some((t) => t.name === name)) {

result.push({ name, path: theme.sourcePath });

}

}

return result.toSorted((a, b) => a.name.localeCompare(b.name));

}

function parseThemeJson(label: string, json: unknown): ThemeJson {

if (!validateThemeJson.Check(json)) {

const errors = Array.from(validateThemeJson.Errors(json));

return createTheme(themeJson, mode);

}

export function getThemeByName(name: string): Theme | undefined {

try {

return loadTheme(name);

} catch {

return undefined;

}

}

export type TerminalTheme = "dark" | "light";

export interface RgbColor {

return getRgbColorLuminance(hexToRgb(ansi256ToHex(index)));

}

export function getThemeForRgbColor(rgb: RgbColor): TerminalTheme {

return getRgbColorLuminance(rgb) >= 0.5 ? "light" : "dark";

}

function parseOscHexChannel(channel: string): number | undefined {

if (!/^[0-9a-f]+$/i.test(channel)) {

return undefined;

}

const max = 16 ** channel.length - 1;

if (max <= 0) {

return undefined;

}

return Math.round((Number.parseInt(channel, 16) / max) * 255);

}

export function parseOsc11BackgroundColor(data: string): RgbColor | undefined {

const prefix = "\u001B]11;";

const belSuffix = "\u0007";

const escSuffix = "\u001B\\";

if (!data.startsWith(prefix)) {

return undefined;

}

const suffixLength = data.endsWith(belSuffix)

? belSuffix.length

: data.endsWith(escSuffix)

? escSuffix.length

: 0;

if (suffixLength === 0) {

return undefined;

}

const value = data.slice(prefix.length, -suffixLength).trim();

if (value.includes("\u0007") || value.includes("\u001B")) {

return undefined;

}

if (value.startsWith("#")) {

const hex = value.slice(1);

if (/^[0-9a-f]{6}$/i.test(hex)) {

return hexToRgb(value);

}

if (/^[0-9a-f]{12}$/i.test(hex)) {

const r = parseOscHexChannel(hex.slice(0, 4));

const g = parseOscHexChannel(hex.slice(4, 8));

const b = parseOscHexChannel(hex.slice(8, 12));

return r !== undefined && g !== undefined && b !== undefined ? { r, g, b } : undefined;

}

return undefined;

}

const rgbValue = value.replace(/^rgba?:/i, "");

const [red, green, blue] = rgbValue.split("/");

if (red === undefined || green === undefined || blue === undefined) {

return undefined;

}

const r = parseOscHexChannel(red);

const g = parseOscHexChannel(green);

const b = parseOscHexChannel(blue);

return r !== undefined && g !== undefined && b !== undefined ? { r, g, b } : undefined;

}

export function detectTerminalBackground(

options: TerminalThemeDetectionOptions = {},

): TerminalThemeDetection {

return `#${grayHex}${grayHex}${grayHex}`;

}

/**

* Get resolved theme colors as CSS-compatible hex strings.

* Used by HTML export to generate CSS custom properties.

*/

export function getResolvedThemeColors(themeName?: string): Record<string, string> {

const name = themeName ?? currentThemeName ?? getDefaultTheme();

const isLight = name === "light";

const themeJson = loadThemeJson(name);

const resolved = resolveThemeColors(themeJson.colors, themeJson.vars);

// Default text color for empty values (terminal uses default fg color)

const defaultText = isLight ? "#000000" : "#e5e5e7";

const cssColors: Record<string, string> = {};

for (const [key, value] of Object.entries(resolved)) {

if (typeof value === "number") {

cssColors[key] = ansi256ToHex(value);

} else if (value === "") {

// Empty means default terminal color - use sensible fallback for HTML

cssColors[key] = defaultText;

} else {

cssColors[key] = value;

}

}

return cssColors;

}

/**

* Check if a theme is a "light" theme (for CSS that needs light/dark variants).

*/

export function isLightTheme(themeName?: string): boolean {

// Currently just check the name - could be extended to analyze colors

return themeName === "light";

}

/**

* Get explicit export colors from theme JSON, if specified.

* Returns undefined for each color that isn't explicitly set.

*/

export function getThemeExportColors(themeName?: string): {

pageBg?: string;

cardBg?: string;

infoBg?: string;

} {

const name = themeName ?? currentThemeName ?? getDefaultTheme();

try {

const themeJson = loadThemeJson(name);

const exportSection = themeJson.export;

if (!exportSection) {

return {};

}

const vars = themeJson.vars ?? {};

const resolve = (value: ColorValue | undefined): string | undefined => {

if (value === undefined) {

return undefined;

}

const resolved = resolveVarRefs(value, vars);

if (typeof resolved === "number") {

return ansi256ToHex(resolved);

}

if (resolved === "") {

return undefined;

}

return resolved;

};

return {

pageBg: resolve(exportSection.pageBg),

cardBg: resolve(exportSection.cardBg),

infoBg: resolve(exportSection.infoBg),

};

} catch {

return {};

}

}

// ============================================================================

// TUI Helpers

// ============================================================================

return extToLang[ext];

}

export function getMarkdownTheme(): MarkdownTheme {

return {

heading: (text: string) => theme.fg("mdHeading", text),

link: (text: string) => theme.fg("mdLink", text),

linkUrl: (text: string) => theme.fg("mdLinkUrl", text),

code: (text: string) => theme.fg("mdCode", text),

codeBlock: (text: string) => theme.fg("mdCodeBlock", text),

codeBlockBorder: (text: string) => theme.fg("mdCodeBlockBorder", text),

quote: (text: string) => theme.fg("mdQuote", text),

quoteBorder: (text: string) => theme.fg("mdQuoteBorder", text),

hr: (text: string) => theme.fg("mdHr", text),

listBullet: (text: string) => theme.fg("mdListBullet", text),

bold: (text: string) => theme.bold(text),

italic: (text: string) => theme.italic(text),

underline: (text: string) => theme.underline(text),

strikethrough: (text: string) => chalk.strikethrough(text),

highlightCode: (code: string, lang?: string): string[] => {

// Validate language before highlighting to avoid stderr spam from cli-highlight

const validLang = lang && supportsLanguage(lang) ? lang : undefined;

// Skip highlighting when no valid language is specified. cli-highlight's

// auto-detection is unreliable and can misidentify prose as AppleScript,

// LiveCodeServer, etc., coloring random English words as keywords.

if (!validLang) {

return code.split("\n").map((line) => theme.fg("mdCodeBlock", line));

}

const opts = {

language: validLang,

ignoreIllegals: true,

theme: getCliHighlightTheme(theme),

};

try {

return highlight(code, opts).split("\n");

} catch {

return code.split("\n").map((line) => theme.fg("mdCodeBlock", line));

}

},

};

}

export function getSelectListTheme(): SelectListTheme {

return {

selectedPrefix: (text: string) => theme.fg("accent", text),

selectedText: (text: string) => theme.fg("accent", text),

description: (text: string) => theme.fg("muted", text),

scrollInfo: (text: string) => theme.fg("muted", text),

noMatch: (text: string) => theme.fg("muted", text),

};

}

export function getEditorTheme(): EditorTheme {

return {

borderColor: (text: string) => theme.fg("borderMuted", text),

selectList: getSelectListTheme(),

};

}

export function getSettingsListTheme(): SettingsListTheme {

return {

label: (text: string, selected: boolean) => (selected ? theme.fg("accent", text) : text),

value: (text: string, selected: boolean) =>

selected ? theme.fg("accent", text) : theme.fg("muted", text),

description: (text: string) => theme.fg("dim", text),

cursor: theme.fg("accent", "→ "),

hint: (text: string) => theme.fg("dim", text),

};

}