@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/core/theme/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/core/theme/discovery.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAA8C,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAEpG,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,sBAAsB,EAAmB,SAAS,EAAE,MAAM,YAAY,CAAC;AAE/G,MAAM,WAAW,kBAAkB;IAClC,gGAAgG;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AA2BD,wBAAgB,2BAA2B,CAC1C,gBAAgB,GAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAwB,EACnE,IAAI,CAAC,EAAE,kBAAkB,GACvB,SAAS,EAAE,CA2Bb;AA0BD,wBAAgB,aAAa,CAC5B,IAAI,EAAE,MAAM,EACZ,gBAAgB,GAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAwB,EACnE,IAAI,CAAC,EAAE,kBAAkB,GACvB,SAAS,CAoBX;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,CAI5E;AAED,wBAAgB,SAAS,CACxB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,SAAS,EAChB,gBAAgB,GAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAwB,EACnE,IAAI,CAAC,EAAE,kBAAkB,GACvB,KAAK,CAOP;AAMD,MAAM,WAAW,6BAA6B;IAC7C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,+BAA+B;IAC/C,4BAA4B,CAAC,EAAE,SAAS,EAAE,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC;CAClG;AAED,MAAM,WAAW,uCAAwC,SAAQ,6BAA6B;IAC7F,EAAE,EAAE,+BAA+B,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CAClB;AAyBD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,QAAQ,GAAG,aAAa,CAEhE;AAED,wBAAgB,+BAA+B,CAAC,OAAO,GAAE,6BAAkC,GAAG,sBAAsB,CAmBnH;AAED,wBAAsB,6BAA6B,CAAC,EACnD,EAAE,EACF,SAAS,EACT,GAAG,EACH,EAAE,uCAAuC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAgB3E;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,MAAM,EACZ,gBAAgB,GAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAwB,EACnE,IAAI,CAAC,EAAE,kBAAkB,GACvB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBxB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CACnC,IAAI,EAAE,MAAM,EACZ,gBAAgB,GAAE,WAAW,CAAC,MAAM,EAAE,KAAK,CAAwB,EACnE,IAAI,CAAC,EAAE,kBAAkB,GACvB;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAuBA","sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { RgbColor } from \"@hansjm10/volt-tui\";\nimport { getCustomThemesDir, getThemesDir } from \"../../config.ts\";\nimport { createThemeFromJson, parseThemeJsonContent, type Theme, type ThemeJson } from \"./theme.ts\";\nimport { ansi256ToHex, hexToRgb, resolveVarRefs } from \"./tokens.ts\";\nimport type { ColorMode, TerminalTheme, TerminalThemeDetection, ThemeColorValue, ThemeInfo } from \"./types.ts\";\n\nexport interface ThemeDiscoveryDirs {\n\t/** Directory holding the built-in dark.json/light.json. Defaults to the packaged themes dir. */\n\tthemesDir?: string;\n\t/** Directory holding user custom themes. Defaults to <agentDir>/themes. */\n\tcustomThemesDir?: string;\n}\n\nfunction resolveDirs(dirs: ThemeDiscoveryDirs = {}): { themesDir: string; customThemesDir: string } {\n\treturn {\n\t\tthemesDir: dirs.themesDir ?? getThemesDir(),\n\t\tcustomThemesDir: dirs.customThemesDir ?? getCustomThemesDir(),\n\t};\n}\n\nconst builtinThemesCache = new Map<string, Record<string, ThemeJson>>();\n\nfunction getBuiltinThemes(themesDir: string): Record<string, ThemeJson> {\n\tlet builtin = builtinThemesCache.get(themesDir);\n\tif (!builtin) {\n\t\tconst darkPath = path.join(themesDir, \"dark.json\");\n\t\tconst lightPath = path.join(themesDir, \"light.json\");\n\t\tbuiltin = {\n\t\t\tdark: JSON.parse(fs.readFileSync(darkPath, \"utf-8\")) as ThemeJson,\n\t\t\tlight: JSON.parse(fs.readFileSync(lightPath, \"utf-8\")) as ThemeJson,\n\t\t};\n\t\tbuiltinThemesCache.set(themesDir, builtin);\n\t}\n\treturn builtin;\n}\n\nconst NO_REGISTERED_THEMES: ReadonlyMap<string, Theme> = new Map();\n\nexport function getAvailableThemesWithPaths(\n\tregisteredThemes: ReadonlyMap<string, Theme> = NO_REGISTERED_THEMES,\n\tdirs?: ThemeDiscoveryDirs,\n): ThemeInfo[] {\n\tconst { themesDir, customThemesDir } = resolveDirs(dirs);\n\tconst result: ThemeInfo[] = [];\n\tconst seen = new Set<string>();\n\tconst addTheme = (themeInfo: ThemeInfo) => {\n\t\tif (seen.has(themeInfo.name)) {\n\t\t\treturn;\n\t\t}\n\t\tseen.add(themeInfo.name);\n\t\tresult.push(themeInfo);\n\t};\n\n\t// Built-in themes\n\tfor (const name of Object.keys(getBuiltinThemes(themesDir))) {\n\t\taddTheme({ name, path: path.join(themesDir, `${name}.json`) });\n\t}\n\n\t// Custom themes\n\tfor (const themeInfo of getCustomThemeInfos(customThemesDir)) {\n\t\taddTheme(themeInfo);\n\t}\n\n\tfor (const [name, theme] of registeredThemes.entries()) {\n\t\taddTheme({ name, path: theme.sourcePath });\n\t}\n\n\treturn result.sort((a, b) => a.name.localeCompare(b.name));\n}\n\nfunction getCustomThemeInfos(customThemesDir: string): ThemeInfo[] {\n\tconst result: ThemeInfo[] = [];\n\tif (!fs.existsSync(customThemesDir)) {\n\t\treturn result;\n\t}\n\n\tfor (const file of fs.readdirSync(customThemesDir)) {\n\t\tif (!file.endsWith(\".json\")) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst themePath = path.join(customThemesDir, file);\n\t\ttry {\n\t\t\tconst customTheme = loadThemeFromPath(themePath);\n\t\t\tif (customTheme.name) {\n\t\t\t\tresult.push({ name: customTheme.name, path: themePath });\n\t\t\t}\n\t\t} catch {\n\t\t\t// Invalid themes are ignored here; the resource loader reports them\n\t\t\t// during normal startup/reload.\n\t\t}\n\t}\n\treturn result;\n}\n\nexport function loadThemeJson(\n\tname: string,\n\tregisteredThemes: ReadonlyMap<string, Theme> = NO_REGISTERED_THEMES,\n\tdirs?: ThemeDiscoveryDirs,\n): ThemeJson {\n\tconst { themesDir, customThemesDir } = resolveDirs(dirs);\n\tconst builtinThemes = getBuiltinThemes(themesDir);\n\tif (name in builtinThemes) {\n\t\treturn builtinThemes[name];\n\t}\n\tconst registeredTheme = registeredThemes.get(name);\n\tif (registeredTheme?.sourcePath) {\n\t\tconst content = fs.readFileSync(registeredTheme.sourcePath, \"utf-8\");\n\t\treturn parseThemeJsonContent(registeredTheme.sourcePath, content);\n\t}\n\tif (registeredTheme) {\n\t\tthrow new Error(`Theme \"${name}\" does not have a source path for export`);\n\t}\n\tconst themePath = path.join(customThemesDir, `${name}.json`);\n\tif (!fs.existsSync(themePath)) {\n\t\tthrow new Error(`Theme not found: ${name}`);\n\t}\n\tconst content = fs.readFileSync(themePath, \"utf-8\");\n\treturn parseThemeJsonContent(name, content);\n}\n\nexport function loadThemeFromPath(themePath: string, mode?: ColorMode): Theme {\n\tconst content = fs.readFileSync(themePath, \"utf-8\");\n\tconst themeJson = parseThemeJsonContent(themePath, content);\n\treturn createThemeFromJson(themeJson, mode, themePath);\n}\n\nexport function loadTheme(\n\tname: string,\n\tmode?: ColorMode,\n\tregisteredThemes: ReadonlyMap<string, Theme> = NO_REGISTERED_THEMES,\n\tdirs?: ThemeDiscoveryDirs,\n): Theme {\n\tconst registeredTheme = registeredThemes.get(name);\n\tif (registeredTheme) {\n\t\treturn registeredTheme;\n\t}\n\tconst themeJson = loadThemeJson(name, registeredThemes, dirs);\n\treturn createThemeFromJson(themeJson, mode);\n}\n\n// ============================================================================\n// Terminal background detection\n// ============================================================================\n\nexport interface TerminalThemeDetectionOptions {\n\tenv?: NodeJS.ProcessEnv;\n}\n\nexport interface TerminalBackgroundThemeDetector {\n\tqueryTerminalBackgroundColor({ timeoutMs }: { timeoutMs: number }): Promise<RgbColor | undefined>;\n}\n\nexport interface TerminalBackgroundThemeDetectionOptions extends TerminalThemeDetectionOptions {\n\tui: TerminalBackgroundThemeDetector;\n\ttimeoutMs: number;\n}\n\nfunction getColorFgBgBackgroundIndex(colorfgbg: string): number | undefined {\n\tconst parts = colorfgbg.split(\";\");\n\tfor (let i = parts.length - 1; i >= 0; i--) {\n\t\tconst bg = parseInt(parts[i].trim(), 10);\n\t\tif (Number.isInteger(bg) && bg >= 0 && bg <= 255) {\n\t\t\treturn bg;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction getRgbColorLuminance({ r, g, b }: RgbColor): number {\n\tconst toLinear = (channel: number) => {\n\t\tconst value = channel / 255;\n\t\treturn value <= 0.03928 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;\n\t};\n\treturn 0.2126 * toLinear(r) + 0.7152 * toLinear(g) + 0.0722 * toLinear(b);\n}\n\nfunction getAnsiColorLuminance(index: number): number {\n\treturn getRgbColorLuminance(hexToRgb(ansi256ToHex(index)));\n}\n\nexport function getThemeForRgbColor(rgb: RgbColor): TerminalTheme {\n\treturn getRgbColorLuminance(rgb) >= 0.5 ? \"light\" : \"dark\";\n}\n\nexport function detectTerminalBackgroundFromEnv(options: TerminalThemeDetectionOptions = {}): TerminalThemeDetection {\n\tconst env = options.env ?? process.env;\n\tconst colorfgbg = env.COLORFGBG || \"\";\n\tconst bg = getColorFgBgBackgroundIndex(colorfgbg);\n\tif (bg !== undefined) {\n\t\treturn {\n\t\t\ttheme: getAnsiColorLuminance(bg) >= 0.5 ? \"light\" : \"dark\",\n\t\t\tsource: \"COLORFGBG\",\n\t\t\tdetail: `background color index ${bg}`,\n\t\t\tconfidence: \"high\",\n\t\t};\n\t}\n\n\treturn {\n\t\ttheme: \"dark\",\n\t\tsource: \"fallback\",\n\t\tdetail: \"no terminal background hint found\",\n\t\tconfidence: \"low\",\n\t};\n}\n\nexport async function detectTerminalBackgroundTheme({\n\tui,\n\ttimeoutMs,\n\tenv,\n}: TerminalBackgroundThemeDetectionOptions): Promise<TerminalThemeDetection> {\n\ttry {\n\t\tconst rgb = await ui.queryTerminalBackgroundColor({ timeoutMs });\n\t\tif (rgb) {\n\t\t\treturn {\n\t\t\t\ttheme: getThemeForRgbColor(rgb),\n\t\t\t\tsource: \"terminal background\",\n\t\t\t\tdetail: `OSC 11 background rgb(${rgb.r}, ${rgb.g}, ${rgb.b})`,\n\t\t\t\tconfidence: \"high\",\n\t\t\t};\n\t\t}\n\t} catch {\n\t\t// Fall back to environment-based detection when the terminal query fails.\n\t}\n\n\treturn detectTerminalBackgroundFromEnv({ env });\n}\n\nexport function getDefaultTheme(): string {\n\treturn detectTerminalBackgroundFromEnv().theme;\n}\n\n// ============================================================================\n// Token snapshots / HTML export helpers\n// ============================================================================\n\n/**\n * Get resolved theme colors as CSS-compatible hex strings.\n * Used by HTML export and token snapshots to generate CSS custom properties.\n */\nexport function getResolvedThemeColors(\n\tname: string,\n\tregisteredThemes: ReadonlyMap<string, Theme> = NO_REGISTERED_THEMES,\n\tdirs?: ThemeDiscoveryDirs,\n): Record<string, string> {\n\tconst isLight = name === \"light\";\n\tconst themeJson = loadThemeJson(name, registeredThemes, dirs);\n\tconst resolved: Record<string, string | number> = {};\n\tfor (const [key, value] of Object.entries(themeJson.colors)) {\n\t\tresolved[key] = resolveVarRefs(value, themeJson.vars ?? {});\n\t}\n\n\t// Default text color for empty values (terminal uses default fg color)\n\tconst defaultText = isLight ? \"#000000\" : \"#e5e5e7\";\n\n\tconst cssColors: Record<string, string> = {};\n\tfor (const [key, value] of Object.entries(resolved)) {\n\t\tif (typeof value === \"number\") {\n\t\t\tcssColors[key] = ansi256ToHex(value);\n\t\t} else if (value === \"\") {\n\t\t\t// Empty means default terminal color - use sensible fallback for HTML\n\t\t\tcssColors[key] = defaultText;\n\t\t} else {\n\t\t\tcssColors[key] = value;\n\t\t}\n\t}\n\treturn cssColors;\n}\n\n/**\n * Check if a theme is a \"light\" theme (for CSS that needs light/dark variants).\n */\nexport function isLightTheme(themeName?: string): boolean {\n\t// Currently just check the name - could be extended to analyze colors\n\treturn themeName === \"light\";\n}\n\n/**\n * Get explicit export colors from theme JSON, if specified.\n * Returns undefined for each color that isn't explicitly set.\n */\nexport function getThemeExportColors(\n\tname: string,\n\tregisteredThemes: ReadonlyMap<string, Theme> = NO_REGISTERED_THEMES,\n\tdirs?: ThemeDiscoveryDirs,\n): {\n\tpageBg?: string;\n\tcardBg?: string;\n\tinfoBg?: string;\n} {\n\ttry {\n\t\tconst themeJson = loadThemeJson(name, registeredThemes, dirs);\n\t\tconst exportSection = themeJson.export;\n\t\tif (!exportSection) return {};\n\n\t\tconst vars = themeJson.vars ?? {};\n\t\tconst resolve = (value: ThemeColorValue | undefined): string | undefined => {\n\t\t\tif (value === undefined) return undefined;\n\t\t\tconst resolved = resolveVarRefs(value, vars);\n\t\t\tif (typeof resolved === \"number\") return ansi256ToHex(resolved);\n\t\t\tif (resolved === \"\") return undefined;\n\t\t\treturn resolved;\n\t\t};\n\n\t\treturn {\n\t\t\tpageBg: resolve(exportSection.pageBg),\n\t\t\tcardBg: resolve(exportSection.cardBg),\n\t\t\tinfoBg: resolve(exportSection.infoBg),\n\t\t};\n\t} catch {\n\t\treturn {};\n\t}\n}\n"]}

package/dist/core/theme/discovery.js

@@ -0,0 +1,239 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getCustomThemesDir, getThemesDir } from "../../config.js";
+import { createThemeFromJson, parseThemeJsonContent } from "./theme.js";
+import { ansi256ToHex, hexToRgb, resolveVarRefs } from "./tokens.js";
+function resolveDirs(dirs = {}) {
+    return {
+        themesDir: dirs.themesDir ?? getThemesDir(),
+        customThemesDir: dirs.customThemesDir ?? getCustomThemesDir(),
+    };
+}
+const builtinThemesCache = new Map();
+function getBuiltinThemes(themesDir) {
+    let builtin = builtinThemesCache.get(themesDir);
+    if (!builtin) {
+        const darkPath = path.join(themesDir, "dark.json");
+        const lightPath = path.join(themesDir, "light.json");
+        builtin = {
+            dark: JSON.parse(fs.readFileSync(darkPath, "utf-8")),
+            light: JSON.parse(fs.readFileSync(lightPath, "utf-8")),
+        };
+        builtinThemesCache.set(themesDir, builtin);
+    }
+    return builtin;
+}
+const NO_REGISTERED_THEMES = new Map();
+export function getAvailableThemesWithPaths(registeredThemes = NO_REGISTERED_THEMES, dirs) {
+    const { themesDir, customThemesDir } = resolveDirs(dirs);
+    const result = [];
+    const seen = new Set();
+    const addTheme = (themeInfo) => {
+        if (seen.has(themeInfo.name)) {
+            return;
+        }
+        seen.add(themeInfo.name);
+        result.push(themeInfo);
+    };
+    // Built-in themes
+    for (const name of Object.keys(getBuiltinThemes(themesDir))) {
+        addTheme({ name, path: path.join(themesDir, `${name}.json`) });
+    }
+    // Custom themes
+    for (const themeInfo of getCustomThemeInfos(customThemesDir)) {
+        addTheme(themeInfo);
+    }
+    for (const [name, theme] of registeredThemes.entries()) {
+        addTheme({ name, path: theme.sourcePath });
+    }
+    return result.sort((a, b) => a.name.localeCompare(b.name));
+}
+function getCustomThemeInfos(customThemesDir) {
+    const result = [];
+    if (!fs.existsSync(customThemesDir)) {
+        return result;
+    }
+    for (const file of fs.readdirSync(customThemesDir)) {
+        if (!file.endsWith(".json")) {
+            continue;
+        }
+        const themePath = path.join(customThemesDir, file);
+        try {
+            const customTheme = loadThemeFromPath(themePath);
+            if (customTheme.name) {
+                result.push({ name: customTheme.name, path: themePath });
+            }
+        }
+        catch {
+            // Invalid themes are ignored here; the resource loader reports them
+            // during normal startup/reload.
+        }
+    }
+    return result;
+}
+export function loadThemeJson(name, registeredThemes = NO_REGISTERED_THEMES, dirs) {
+    const { themesDir, customThemesDir } = resolveDirs(dirs);
+    const builtinThemes = getBuiltinThemes(themesDir);
+    if (name in builtinThemes) {
+        return builtinThemes[name];
+    }
+    const registeredTheme = registeredThemes.get(name);
+    if (registeredTheme?.sourcePath) {
+        const content = fs.readFileSync(registeredTheme.sourcePath, "utf-8");
+        return parseThemeJsonContent(registeredTheme.sourcePath, content);
+    }
+    if (registeredTheme) {
+        throw new Error(`Theme "${name}" does not have a source path for export`);
+    }
+    const themePath = path.join(customThemesDir, `${name}.json`);
+    if (!fs.existsSync(themePath)) {
+        throw new Error(`Theme not found: ${name}`);
+    }
+    const content = fs.readFileSync(themePath, "utf-8");
+    return parseThemeJsonContent(name, content);
+}
+export function loadThemeFromPath(themePath, mode) {
+    const content = fs.readFileSync(themePath, "utf-8");
+    const themeJson = parseThemeJsonContent(themePath, content);
+    return createThemeFromJson(themeJson, mode, themePath);
+}
+export function loadTheme(name, mode, registeredThemes = NO_REGISTERED_THEMES, dirs) {
+    const registeredTheme = registeredThemes.get(name);
+    if (registeredTheme) {
+        return registeredTheme;
+    }
+    const themeJson = loadThemeJson(name, registeredThemes, dirs);
+    return createThemeFromJson(themeJson, mode);
+}
+function getColorFgBgBackgroundIndex(colorfgbg) {
+    const parts = colorfgbg.split(";");
+    for (let i = parts.length - 1; i >= 0; i--) {
+        const bg = parseInt(parts[i].trim(), 10);
+        if (Number.isInteger(bg) && bg >= 0 && bg <= 255) {
+            return bg;
+        }
+    }
+    return undefined;
+}
+function getRgbColorLuminance({ r, g, b }) {
+    const toLinear = (channel) => {
+        const value = channel / 255;
+        return value <= 0.03928 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
+    };
+    return 0.2126 * toLinear(r) + 0.7152 * toLinear(g) + 0.0722 * toLinear(b);
+}
+function getAnsiColorLuminance(index) {
+    return getRgbColorLuminance(hexToRgb(ansi256ToHex(index)));
+}
+export function getThemeForRgbColor(rgb) {
+    return getRgbColorLuminance(rgb) >= 0.5 ? "light" : "dark";
+}
+export function detectTerminalBackgroundFromEnv(options = {}) {
+    const env = options.env ?? process.env;
+    const colorfgbg = env.COLORFGBG || "";
+    const bg = getColorFgBgBackgroundIndex(colorfgbg);
+    if (bg !== undefined) {
+        return {
+            theme: getAnsiColorLuminance(bg) >= 0.5 ? "light" : "dark",
+            source: "COLORFGBG",
+            detail: `background color index ${bg}`,
+            confidence: "high",
+        };
+    }
+    return {
+        theme: "dark",
+        source: "fallback",
+        detail: "no terminal background hint found",
+        confidence: "low",
+    };
+}
+export async function detectTerminalBackgroundTheme({ ui, timeoutMs, env, }) {
+    try {
+        const rgb = await ui.queryTerminalBackgroundColor({ timeoutMs });
+        if (rgb) {
+            return {
+                theme: getThemeForRgbColor(rgb),
+                source: "terminal background",
+                detail: `OSC 11 background rgb(${rgb.r}, ${rgb.g}, ${rgb.b})`,
+                confidence: "high",
+            };
+        }
+    }
+    catch {
+        // Fall back to environment-based detection when the terminal query fails.
+    }
+    return detectTerminalBackgroundFromEnv({ env });
+}
+export function getDefaultTheme() {
+    return detectTerminalBackgroundFromEnv().theme;
+}
+// ============================================================================
+// Token snapshots / HTML export helpers
+// ============================================================================
+/**
+ * Get resolved theme colors as CSS-compatible hex strings.
+ * Used by HTML export and token snapshots to generate CSS custom properties.
+ */
+export function getResolvedThemeColors(name, registeredThemes = NO_REGISTERED_THEMES, dirs) {
+    const isLight = name === "light";
+    const themeJson = loadThemeJson(name, registeredThemes, dirs);
+    const resolved = {};
+    for (const [key, value] of Object.entries(themeJson.colors)) {
+        resolved[key] = resolveVarRefs(value, themeJson.vars ?? {});
+    }
+    // Default text color for empty values (terminal uses default fg color)
+    const defaultText = isLight ? "#000000" : "#e5e5e7";
+    const cssColors = {};
+    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) {
+    // 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(name, registeredThemes = NO_REGISTERED_THEMES, dirs) {
+    try {
+        const themeJson = loadThemeJson(name, registeredThemes, dirs);
+        const exportSection = themeJson.export;
+        if (!exportSection)
+            return {};
+        const vars = themeJson.vars ?? {};
+        const resolve = (value) => {
+            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 {};
+    }
+}
+//# sourceMappingURL=discovery.js.map

package/dist/core/theme/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/core/theme/discovery.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { RgbColor } from \"@hansjm10/volt-tui\";\nimport { getCustomThemesDir, getThemesDir } from \"../../config.ts\";\nimport { createThemeFromJson, parseThemeJsonContent, type Theme, type ThemeJson } from \"./theme.ts\";\nimport { ansi256ToHex, hexToRgb, resolveVarRefs } from \"./tokens.ts\";\nimport type { ColorMode, TerminalTheme, TerminalThemeDetection, ThemeColorValue, ThemeInfo } from \"./types.ts\";\n\nexport interface ThemeDiscoveryDirs {\n\t/** Directory holding the built-in dark.json/light.json. Defaults to the packaged themes dir. */\n\tthemesDir?: string;\n\t/** Directory holding user custom themes. Defaults to <agentDir>/themes. */\n\tcustomThemesDir?: string;\n}\n\nfunction resolveDirs(dirs: ThemeDiscoveryDirs = {}): { themesDir: string; customThemesDir: string } {\n\treturn {\n\t\tthemesDir: dirs.themesDir ?? getThemesDir(),\n\t\tcustomThemesDir: dirs.customThemesDir ?? getCustomThemesDir(),\n\t};\n}\n\nconst builtinThemesCache = new Map<string, Record<string, ThemeJson>>();\n\nfunction getBuiltinThemes(themesDir: string): Record<string, ThemeJson> {\n\tlet builtin = builtinThemesCache.get(themesDir);\n\tif (!builtin) {\n\t\tconst darkPath = path.join(themesDir, \"dark.json\");\n\t\tconst lightPath = path.join(themesDir, \"light.json\");\n\t\tbuiltin = {\n\t\t\tdark: JSON.parse(fs.readFileSync(darkPath, \"utf-8\")) as ThemeJson,\n\t\t\tlight: JSON.parse(fs.readFileSync(lightPath, \"utf-8\")) as ThemeJson,\n\t\t};\n\t\tbuiltinThemesCache.set(themesDir, builtin);\n\t}\n\treturn builtin;\n}\n\nconst NO_REGISTERED_THEMES: ReadonlyMap<string, Theme> = new Map();\n\nexport function getAvailableThemesWithPaths(\n\tregisteredThemes: ReadonlyMap<string, Theme> = NO_REGISTERED_THEMES,\n\tdirs?: ThemeDiscoveryDirs,\n): ThemeInfo[] {\n\tconst { themesDir, customThemesDir } = resolveDirs(dirs);\n\tconst result: ThemeInfo[] = [];\n\tconst seen = new Set<string>();\n\tconst addTheme = (themeInfo: ThemeInfo) => {\n\t\tif (seen.has(themeInfo.name)) {\n\t\t\treturn;\n\t\t}\n\t\tseen.add(themeInfo.name);\n\t\tresult.push(themeInfo);\n\t};\n\n\t// Built-in themes\n\tfor (const name of Object.keys(getBuiltinThemes(themesDir))) {\n\t\taddTheme({ name, path: path.join(themesDir, `${name}.json`) });\n\t}\n\n\t// Custom themes\n\tfor (const themeInfo of getCustomThemeInfos(customThemesDir)) {\n\t\taddTheme(themeInfo);\n\t}\n\n\tfor (const [name, theme] of registeredThemes.entries()) {\n\t\taddTheme({ name, path: theme.sourcePath });\n\t}\n\n\treturn result.sort((a, b) => a.name.localeCompare(b.name));\n}\n\nfunction getCustomThemeInfos(customThemesDir: string): ThemeInfo[] {\n\tconst result: ThemeInfo[] = [];\n\tif (!fs.existsSync(customThemesDir)) {\n\t\treturn result;\n\t}\n\n\tfor (const file of fs.readdirSync(customThemesDir)) {\n\t\tif (!file.endsWith(\".json\")) {\n\t\t\tcontinue;\n\t\t}\n\t\tconst themePath = path.join(customThemesDir, file);\n\t\ttry {\n\t\t\tconst customTheme = loadThemeFromPath(themePath);\n\t\t\tif (customTheme.name) {\n\t\t\t\tresult.push({ name: customTheme.name, path: themePath });\n\t\t\t}\n\t\t} catch {\n\t\t\t// Invalid themes are ignored here; the resource loader reports them\n\t\t\t// during normal startup/reload.\n\t\t}\n\t}\n\treturn result;\n}\n\nexport function loadThemeJson(\n\tname: string,\n\tregisteredThemes: ReadonlyMap<string, Theme> = NO_REGISTERED_THEMES,\n\tdirs?: ThemeDiscoveryDirs,\n): ThemeJson {\n\tconst { themesDir, customThemesDir } = resolveDirs(dirs);\n\tconst builtinThemes = getBuiltinThemes(themesDir);\n\tif (name in builtinThemes) {\n\t\treturn builtinThemes[name];\n\t}\n\tconst registeredTheme = registeredThemes.get(name);\n\tif (registeredTheme?.sourcePath) {\n\t\tconst content = fs.readFileSync(registeredTheme.sourcePath, \"utf-8\");\n\t\treturn parseThemeJsonContent(registeredTheme.sourcePath, content);\n\t}\n\tif (registeredTheme) {\n\t\tthrow new Error(`Theme \"${name}\" does not have a source path for export`);\n\t}\n\tconst themePath = path.join(customThemesDir, `${name}.json`);\n\tif (!fs.existsSync(themePath)) {\n\t\tthrow new Error(`Theme not found: ${name}`);\n\t}\n\tconst content = fs.readFileSync(themePath, \"utf-8\");\n\treturn parseThemeJsonContent(name, content);\n}\n\nexport function loadThemeFromPath(themePath: string, mode?: ColorMode): Theme {\n\tconst content = fs.readFileSync(themePath, \"utf-8\");\n\tconst themeJson = parseThemeJsonContent(themePath, content);\n\treturn createThemeFromJson(themeJson, mode, themePath);\n}\n\nexport function loadTheme(\n\tname: string,\n\tmode?: ColorMode,\n\tregisteredThemes: ReadonlyMap<string, Theme> = NO_REGISTERED_THEMES,\n\tdirs?: ThemeDiscoveryDirs,\n): Theme {\n\tconst registeredTheme = registeredThemes.get(name);\n\tif (registeredTheme) {\n\t\treturn registeredTheme;\n\t}\n\tconst themeJson = loadThemeJson(name, registeredThemes, dirs);\n\treturn createThemeFromJson(themeJson, mode);\n}\n\n// ============================================================================\n// Terminal background detection\n// ============================================================================\n\nexport interface TerminalThemeDetectionOptions {\n\tenv?: NodeJS.ProcessEnv;\n}\n\nexport interface TerminalBackgroundThemeDetector {\n\tqueryTerminalBackgroundColor({ timeoutMs }: { timeoutMs: number }): Promise<RgbColor | undefined>;\n}\n\nexport interface TerminalBackgroundThemeDetectionOptions extends TerminalThemeDetectionOptions {\n\tui: TerminalBackgroundThemeDetector;\n\ttimeoutMs: number;\n}\n\nfunction getColorFgBgBackgroundIndex(colorfgbg: string): number | undefined {\n\tconst parts = colorfgbg.split(\";\");\n\tfor (let i = parts.length - 1; i >= 0; i--) {\n\t\tconst bg = parseInt(parts[i].trim(), 10);\n\t\tif (Number.isInteger(bg) && bg >= 0 && bg <= 255) {\n\t\t\treturn bg;\n\t\t}\n\t}\n\treturn undefined;\n}\n\nfunction getRgbColorLuminance({ r, g, b }: RgbColor): number {\n\tconst toLinear = (channel: number) => {\n\t\tconst value = channel / 255;\n\t\treturn value <= 0.03928 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;\n\t};\n\treturn 0.2126 * toLinear(r) + 0.7152 * toLinear(g) + 0.0722 * toLinear(b);\n}\n\nfunction getAnsiColorLuminance(index: number): number {\n\treturn getRgbColorLuminance(hexToRgb(ansi256ToHex(index)));\n}\n\nexport function getThemeForRgbColor(rgb: RgbColor): TerminalTheme {\n\treturn getRgbColorLuminance(rgb) >= 0.5 ? \"light\" : \"dark\";\n}\n\nexport function detectTerminalBackgroundFromEnv(options: TerminalThemeDetectionOptions = {}): TerminalThemeDetection {\n\tconst env = options.env ?? process.env;\n\tconst colorfgbg = env.COLORFGBG || \"\";\n\tconst bg = getColorFgBgBackgroundIndex(colorfgbg);\n\tif (bg !== undefined) {\n\t\treturn {\n\t\t\ttheme: getAnsiColorLuminance(bg) >= 0.5 ? \"light\" : \"dark\",\n\t\t\tsource: \"COLORFGBG\",\n\t\t\tdetail: `background color index ${bg}`,\n\t\t\tconfidence: \"high\",\n\t\t};\n\t}\n\n\treturn {\n\t\ttheme: \"dark\",\n\t\tsource: \"fallback\",\n\t\tdetail: \"no terminal background hint found\",\n\t\tconfidence: \"low\",\n\t};\n}\n\nexport async function detectTerminalBackgroundTheme({\n\tui,\n\ttimeoutMs,\n\tenv,\n}: TerminalBackgroundThemeDetectionOptions): Promise<TerminalThemeDetection> {\n\ttry {\n\t\tconst rgb = await ui.queryTerminalBackgroundColor({ timeoutMs });\n\t\tif (rgb) {\n\t\t\treturn {\n\t\t\t\ttheme: getThemeForRgbColor(rgb),\n\t\t\t\tsource: \"terminal background\",\n\t\t\t\tdetail: `OSC 11 background rgb(${rgb.r}, ${rgb.g}, ${rgb.b})`,\n\t\t\t\tconfidence: \"high\",\n\t\t\t};\n\t\t}\n\t} catch {\n\t\t// Fall back to environment-based detection when the terminal query fails.\n\t}\n\n\treturn detectTerminalBackgroundFromEnv({ env });\n}\n\nexport function getDefaultTheme(): string {\n\treturn detectTerminalBackgroundFromEnv().theme;\n}\n\n// ============================================================================\n// Token snapshots / HTML export helpers\n// ============================================================================\n\n/**\n * Get resolved theme colors as CSS-compatible hex strings.\n * Used by HTML export and token snapshots to generate CSS custom properties.\n */\nexport function getResolvedThemeColors(\n\tname: string,\n\tregisteredThemes: ReadonlyMap<string, Theme> = NO_REGISTERED_THEMES,\n\tdirs?: ThemeDiscoveryDirs,\n): Record<string, string> {\n\tconst isLight = name === \"light\";\n\tconst themeJson = loadThemeJson(name, registeredThemes, dirs);\n\tconst resolved: Record<string, string | number> = {};\n\tfor (const [key, value] of Object.entries(themeJson.colors)) {\n\t\tresolved[key] = resolveVarRefs(value, themeJson.vars ?? {});\n\t}\n\n\t// Default text color for empty values (terminal uses default fg color)\n\tconst defaultText = isLight ? \"#000000\" : \"#e5e5e7\";\n\n\tconst cssColors: Record<string, string> = {};\n\tfor (const [key, value] of Object.entries(resolved)) {\n\t\tif (typeof value === \"number\") {\n\t\t\tcssColors[key] = ansi256ToHex(value);\n\t\t} else if (value === \"\") {\n\t\t\t// Empty means default terminal color - use sensible fallback for HTML\n\t\t\tcssColors[key] = defaultText;\n\t\t} else {\n\t\t\tcssColors[key] = value;\n\t\t}\n\t}\n\treturn cssColors;\n}\n\n/**\n * Check if a theme is a \"light\" theme (for CSS that needs light/dark variants).\n */\nexport function isLightTheme(themeName?: string): boolean {\n\t// Currently just check the name - could be extended to analyze colors\n\treturn themeName === \"light\";\n}\n\n/**\n * Get explicit export colors from theme JSON, if specified.\n * Returns undefined for each color that isn't explicitly set.\n */\nexport function getThemeExportColors(\n\tname: string,\n\tregisteredThemes: ReadonlyMap<string, Theme> = NO_REGISTERED_THEMES,\n\tdirs?: ThemeDiscoveryDirs,\n): {\n\tpageBg?: string;\n\tcardBg?: string;\n\tinfoBg?: string;\n} {\n\ttry {\n\t\tconst themeJson = loadThemeJson(name, registeredThemes, dirs);\n\t\tconst exportSection = themeJson.export;\n\t\tif (!exportSection) return {};\n\n\t\tconst vars = themeJson.vars ?? {};\n\t\tconst resolve = (value: ThemeColorValue | undefined): string | undefined => {\n\t\t\tif (value === undefined) return undefined;\n\t\t\tconst resolved = resolveVarRefs(value, vars);\n\t\t\tif (typeof resolved === \"number\") return ansi256ToHex(resolved);\n\t\t\tif (resolved === \"\") return undefined;\n\t\t\treturn resolved;\n\t\t};\n\n\t\treturn {\n\t\t\tpageBg: resolve(exportSection.pageBg),\n\t\t\tcardBg: resolve(exportSection.cardBg),\n\t\t\tinfoBg: resolve(exportSection.infoBg),\n\t\t};\n\t} catch {\n\t\treturn {};\n\t}\n}\n"]}

package/dist/core/theme/index.d.ts

@@ -0,0 +1,6 @@
+export { detectTerminalBackgroundFromEnv, detectTerminalBackgroundTheme, getAvailableThemesWithPaths, getDefaultTheme, getResolvedThemeColors, getThemeExportColors, getThemeForRgbColor, isLightTheme, loadTheme, loadThemeFromPath, loadThemeJson, type TerminalBackgroundThemeDetectionOptions, type TerminalBackgroundThemeDetector, type TerminalThemeDetectionOptions, type ThemeDiscoveryDirs, } from "./discovery.ts";
+export { createThemeFromJson, getDefaultColorMode, parseThemeJson, parseThemeJsonContent, THEME_BG_COLOR_KEYS, Theme, type ThemeJson, ThemeJsonSchema, } from "./theme.ts";
+export { createThemeService, type ThemeService, type ThemeServiceOptions, type ThemeSetResult, } from "./theme-service.ts";
+export { ansi256ToHex, bgAnsi, fgAnsi, hexTo256, hexToRgb, resolveThemeColors, resolveVarRefs, rgbTo256, } from "./tokens.ts";
+export type { ColorMode, ResolvedThemeTokens, TerminalTheme, TerminalThemeDetection, ThemeBg, ThemeColor, ThemeColorValue, ThemeInfo, ThemeName, } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/theme/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,+BAA+B,EAC/B,6BAA6B,EAC7B,2BAA2B,EAC3B,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,KAAK,uCAAuC,EAC5C,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,EAClC,KAAK,kBAAkB,GACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,EACL,KAAK,SAAS,EACd,eAAe,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,cAAc,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,YAAY,EACZ,MAAM,EACN,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,kBAAkB,EAClB,cAAc,EACd,QAAQ,GACR,MAAM,aAAa,CAAC;AACrB,YAAY,EACX,SAAS,EACT,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,OAAO,EACP,UAAU,EACV,eAAe,EACf,SAAS,EACT,SAAS,GACT,MAAM,YAAY,CAAC","sourcesContent":["export {\n\tdetectTerminalBackgroundFromEnv,\n\tdetectTerminalBackgroundTheme,\n\tgetAvailableThemesWithPaths,\n\tgetDefaultTheme,\n\tgetResolvedThemeColors,\n\tgetThemeExportColors,\n\tgetThemeForRgbColor,\n\tisLightTheme,\n\tloadTheme,\n\tloadThemeFromPath,\n\tloadThemeJson,\n\ttype TerminalBackgroundThemeDetectionOptions,\n\ttype TerminalBackgroundThemeDetector,\n\ttype TerminalThemeDetectionOptions,\n\ttype ThemeDiscoveryDirs,\n} from \"./discovery.ts\";\nexport {\n\tcreateThemeFromJson,\n\tgetDefaultColorMode,\n\tparseThemeJson,\n\tparseThemeJsonContent,\n\tTHEME_BG_COLOR_KEYS,\n\tTheme,\n\ttype ThemeJson,\n\tThemeJsonSchema,\n} from \"./theme.ts\";\nexport {\n\tcreateThemeService,\n\ttype ThemeService,\n\ttype ThemeServiceOptions,\n\ttype ThemeSetResult,\n} from \"./theme-service.ts\";\nexport {\n\tansi256ToHex,\n\tbgAnsi,\n\tfgAnsi,\n\thexTo256,\n\thexToRgb,\n\tresolveThemeColors,\n\tresolveVarRefs,\n\trgbTo256,\n} from \"./tokens.ts\";\nexport type {\n\tColorMode,\n\tResolvedThemeTokens,\n\tTerminalTheme,\n\tTerminalThemeDetection,\n\tThemeBg,\n\tThemeColor,\n\tThemeColorValue,\n\tThemeInfo,\n\tThemeName,\n} from \"./types.ts\";\n"]}

package/dist/core/theme/index.js

@@ -0,0 +1,5 @@
+export { detectTerminalBackgroundFromEnv, detectTerminalBackgroundTheme, getAvailableThemesWithPaths, getDefaultTheme, getResolvedThemeColors, getThemeExportColors, getThemeForRgbColor, isLightTheme, loadTheme, loadThemeFromPath, loadThemeJson, } from "./discovery.js";
+export { createThemeFromJson, getDefaultColorMode, parseThemeJson, parseThemeJsonContent, THEME_BG_COLOR_KEYS, Theme, ThemeJsonSchema, } from "./theme.js";
+export { createThemeService, } from "./theme-service.js";
+export { ansi256ToHex, bgAnsi, fgAnsi, hexTo256, hexToRgb, resolveThemeColors, resolveVarRefs, rgbTo256, } from "./tokens.js";
+//# sourceMappingURL=index.js.map

package/dist/core/theme/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/theme/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,+BAA+B,EAC/B,6BAA6B,EAC7B,2BAA2B,EAC3B,eAAe,EACf,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,aAAa,GAKb,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACN,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,KAAK,EAEL,eAAe,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACN,kBAAkB,GAIlB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,YAAY,EACZ,MAAM,EACN,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,kBAAkB,EAClB,cAAc,EACd,QAAQ,GACR,MAAM,aAAa,CAAC","sourcesContent":["export {\n\tdetectTerminalBackgroundFromEnv,\n\tdetectTerminalBackgroundTheme,\n\tgetAvailableThemesWithPaths,\n\tgetDefaultTheme,\n\tgetResolvedThemeColors,\n\tgetThemeExportColors,\n\tgetThemeForRgbColor,\n\tisLightTheme,\n\tloadTheme,\n\tloadThemeFromPath,\n\tloadThemeJson,\n\ttype TerminalBackgroundThemeDetectionOptions,\n\ttype TerminalBackgroundThemeDetector,\n\ttype TerminalThemeDetectionOptions,\n\ttype ThemeDiscoveryDirs,\n} from \"./discovery.ts\";\nexport {\n\tcreateThemeFromJson,\n\tgetDefaultColorMode,\n\tparseThemeJson,\n\tparseThemeJsonContent,\n\tTHEME_BG_COLOR_KEYS,\n\tTheme,\n\ttype ThemeJson,\n\tThemeJsonSchema,\n} from \"./theme.ts\";\nexport {\n\tcreateThemeService,\n\ttype ThemeService,\n\ttype ThemeServiceOptions,\n\ttype ThemeSetResult,\n} from \"./theme-service.ts\";\nexport {\n\tansi256ToHex,\n\tbgAnsi,\n\tfgAnsi,\n\thexTo256,\n\thexToRgb,\n\tresolveThemeColors,\n\tresolveVarRefs,\n\trgbTo256,\n} from \"./tokens.ts\";\nexport type {\n\tColorMode,\n\tResolvedThemeTokens,\n\tTerminalTheme,\n\tTerminalThemeDetection,\n\tThemeBg,\n\tThemeColor,\n\tThemeColorValue,\n\tThemeInfo,\n\tThemeName,\n} from \"./types.ts\";\n"]}

package/dist/core/theme/light.json

@@ -0,0 +1,85 @@
+{
+	"$schema": "./theme-schema.json",
+	"name": "light",
+	"vars": {
+		"purple": "#7c3aed",
+		"violet": "#6a54c7",
+		"green": "#3f6f3f",
+		"red": "#8a3f3f",
+		"yellow": "#765500",
+		"text": "#1f2328",
+		"mediumGray": "#5f6368",
+		"dimGray": "#666666",
+		"lightGray": "#767676",
+		"selectedBg": "#ebe2f5",
+		"userMsgBg": "#e8e8e8",
+		"toolPendingBg": "#eae6f2",
+		"toolSuccessBg": "#e8f0e8",
+		"toolErrorBg": "#f0e8e8",
+		"customMsgBg": "#ede7f6"
+	},
+	"colors": {
+		"accent": "purple",
+		"border": "violet",
+		"borderAccent": "purple",
+		"borderMuted": "lightGray",
+		"success": "green",
+		"error": "red",
+		"warning": "yellow",
+		"muted": "mediumGray",
+		"dim": "dimGray",
+		"text": "text",
+		"thinkingText": "mediumGray",
+
+		"selectedBg": "selectedBg",
+		"userMessageBg": "userMsgBg",
+		"userMessageText": "text",
+		"customMessageBg": "customMsgBg",
+		"customMessageText": "text",
+		"customMessageLabel": "#6b4db2",
+		"toolPendingBg": "toolPendingBg",
+		"toolSuccessBg": "toolSuccessBg",
+		"toolErrorBg": "toolErrorBg",
+		"toolTitle": "text",
+		"toolOutput": "mediumGray",
+
+		"mdHeading": "yellow",
+		"mdLink": "violet",
+		"mdLinkUrl": "dimGray",
+		"mdCode": "purple",
+		"mdCodeBlock": "green",
+		"mdCodeBlockBorder": "mediumGray",
+		"mdQuote": "mediumGray",
+		"mdQuoteBorder": "mediumGray",
+		"mdHr": "mediumGray",
+		"mdListBullet": "purple",
+
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "mediumGray",
+
+		"syntaxComment": "#008000",
+		"syntaxKeyword": "#0000FF",
+		"syntaxFunction": "#795E26",
+		"syntaxVariable": "#001080",
+		"syntaxString": "#A31515",
+		"syntaxNumber": "#098658",
+		"syntaxType": "#267F99",
+		"syntaxOperator": "#000000",
+		"syntaxPunctuation": "#000000",
+
+		"thinkingOff": "lightGray",
+		"thinkingMinimal": "#767676",
+		"thinkingLow": "violet",
+		"thinkingMedium": "#7e57c2",
+		"thinkingHigh": "purple",
+		"thinkingXhigh": "#8b008b",
+
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "#f8f8f8",
+		"cardBg": "#ffffff",
+		"infoBg": "#fffae6"
+	}
+}

package/dist/core/theme/runtime.d.ts

@@ -0,0 +1,55 @@
+import type { EditorTheme, MarkdownTheme, SelectListTheme, SettingsListTheme } from "@hansjm10/volt-tui";
+import type { Theme } from "./theme.ts";
+import type { ThemeColor, ThemeInfo } from "./types.ts";
+export { detectTerminalBackgroundFromEnv, detectTerminalBackgroundTheme, getDefaultTheme, getThemeForRgbColor, loadThemeFromPath, type TerminalBackgroundThemeDetectionOptions, type TerminalBackgroundThemeDetector, type TerminalThemeDetectionOptions, } from "./discovery.ts";
+export { Theme } from "./theme.ts";
+export type { TerminalTheme, TerminalThemeDetection, ThemeBg, ThemeColor, ThemeInfo, } from "./types.ts";
+export declare function getAvailableThemes(): string[];
+export declare function getAvailableThemesWithPaths(): ThemeInfo[];
+export declare function getThemeByName(name: string): Theme | undefined;
+export declare const theme: Theme;
+/** Name of the theme most recently applied via initTheme/setTheme ("<in-memory>" for direct instances). */
+export declare function getCurrentThemeName(): string | undefined;
+export declare function setRegisteredThemes(themes: Theme[]): void;
+export declare function initTheme(themeName?: string, enableWatcher?: boolean): void;
+export declare function setTheme(name: string, enableWatcher?: boolean): {
+    success: boolean;
+    error?: string;
+};
+export declare function setThemeInstance(themeInstance: Theme): void;
+export declare function onThemeChange(callback: () => void): void;
+export declare function stopThemeWatcher(): void;
+/**
+ * Get resolved theme colors as CSS-compatible hex strings.
+ * Used by HTML export to generate CSS custom properties.
+ */
+export declare function getResolvedThemeColors(themeName?: string): Record<string, string>;
+/**
+ * Check if a theme is a "light" theme (for CSS that needs light/dark variants).
+ */
+export declare function isLightTheme(themeName?: string): boolean;
+/**
+ * Get explicit export colors from theme JSON, if specified.
+ * Returns undefined for each color that isn't explicitly set.
+ */
+export declare function getThemeExportColors(themeName?: string): {
+    pageBg?: string;
+    cardBg?: string;
+    infoBg?: string;
+};
+/**
+ * Highlight code with syntax coloring based on file extension or language.
+ * Returns array of highlighted lines.
+ */
+export declare function highlightCode(code: string, lang?: string): string[];
+/** Highlight Bash syntax, with a conservative command-name overlay for arbitrary executables. */
+export declare function highlightShellCommand(command: string, baseColor?: ThemeColor): string[];
+/**
+ * Get language identifier from file path extension.
+ */
+export declare function getLanguageFromPath(filePath: string): string | undefined;
+export declare function getMarkdownTheme(): MarkdownTheme;
+export declare function getSelectListTheme(): SelectListTheme;
+export declare function getEditorTheme(): EditorTheme;
+export declare function getSettingsListTheme(): SettingsListTheme;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/core/theme/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/core/theme/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAYzG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EACN,+BAA+B,EAC/B,6BAA6B,EAC7B,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,uCAAuC,EAC5C,KAAK,+BAA+B,EACpC,KAAK,6BAA6B,GAClC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,YAAY,EACX,aAAa,EACb,sBAAsB,EACtB,OAAO,EACP,UAAU,EACV,SAAS,GACT,MAAM,YAAY,CAAC;AAQpB,wBAAgB,kBAAkB,IAAI,MAAM,EAAE,CAE7C;AAED,wBAAgB,2BAA2B,IAAI,SAAS,EAAE,CAEzD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAM9D;AAYD,eAAO,MAAM,KAAK,EAAE,KAMlB,CAAC;AAaH,2GAA2G;AAC3G,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,SAAS,CAExD;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAOzD;AAED,wBAAgB,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,GAAE,OAAe,GAAG,IAAI,CAclF;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,GAAE,OAAe,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAqB3G;AAED,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,KAAK,GAAG,IAAI,CAO3D;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAExD;AA2ED,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGjF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAGxD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,CAGA;AAiDD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBnE;AAsID,iGAAiG;AACjG,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,UAAwB,GAAG,MAAM,EAAE,CAkBpG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkExE;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CAqChD;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CAQpD;AAED,wBAAgB,cAAc,IAAI,WAAW,CAM5C;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CASxD","sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport type { EditorTheme, MarkdownTheme, SelectListTheme, SettingsListTheme } from \"@hansjm10/volt-tui\";\nimport chalk from \"chalk\";\nimport { getCustomThemesDir } from \"../../config.ts\";\nimport { closeWatcher, watchWithErrorHandler } from \"../../utils/fs-watch.ts\";\nimport { highlight, supportsLanguage } from \"../../utils/syntax-highlight.ts\";\nimport {\n\tgetAvailableThemesWithPaths as coreGetAvailableThemesWithPaths,\n\tgetResolvedThemeColors as coreGetResolvedThemeColors,\n\tgetThemeExportColors as coreGetThemeExportColors,\n\tloadTheme,\n\tloadThemeFromPath,\n} from \"./discovery.ts\";\nimport type { Theme } from \"./theme.ts\";\nimport type { ThemeColor, ThemeInfo } from \"./types.ts\";\n\nexport {\n\tdetectTerminalBackgroundFromEnv,\n\tdetectTerminalBackgroundTheme,\n\tgetDefaultTheme,\n\tgetThemeForRgbColor,\n\tloadThemeFromPath,\n\ttype TerminalBackgroundThemeDetectionOptions,\n\ttype TerminalBackgroundThemeDetector,\n\ttype TerminalThemeDetectionOptions,\n} from \"./discovery.ts\";\nexport { Theme } from \"./theme.ts\";\nexport type {\n\tTerminalTheme,\n\tTerminalThemeDetection,\n\tThemeBg,\n\tThemeColor,\n\tThemeInfo,\n} from \"./types.ts\";\n\nimport { getDefaultTheme } from \"./discovery.ts\";\n\n// ============================================================================\n// Theme Discovery (module-level registry view)\n// ============================================================================\n\nexport function getAvailableThemes(): string[] {\n\treturn getAvailableThemesWithPaths().map(({ name }) => name);\n}\n\nexport function getAvailableThemesWithPaths(): ThemeInfo[] {\n\treturn coreGetAvailableThemesWithPaths(registeredThemes);\n}\n\nexport function getThemeByName(name: string): Theme | undefined {\n\ttry {\n\t\treturn loadTheme(name, undefined, registeredThemes);\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\n// ============================================================================\n// Global Theme Instance\n// ============================================================================\n\n// Use globalThis to share theme across module loaders (tsx + jiti in dev mode)\nconst THEME_KEY = Symbol.for(\"@hansjm10/volt-coding-agent:theme\");\nconst THEME_KEY_OLD = Symbol.for(\"@hansjm10/volt-coding-agent:theme\");\n\n// Export theme as a getter that reads from globalThis\n// This ensures all module instances (tsx, jiti) see the same theme\nexport const theme: Theme = new Proxy({} as Theme, {\n\tget(_target, prop) {\n\t\tconst t = (globalThis as Record<symbol, Theme>)[THEME_KEY];\n\t\tif (!t) throw new Error(\"Theme not initialized. Call initTheme() first.\");\n\t\treturn (t as unknown as Record<string | symbol, unknown>)[prop];\n\t},\n});\n\nfunction setGlobalTheme(t: Theme): void {\n\t(globalThis as Record<symbol, Theme>)[THEME_KEY] = t;\n\t(globalThis as Record<symbol, Theme>)[THEME_KEY_OLD] = t;\n}\n\nlet currentThemeName: string | undefined;\nlet themeWatcher: fs.FSWatcher | undefined;\nlet themeReloadTimer: NodeJS.Timeout | undefined;\nlet onThemeChangeCallback: (() => void) | undefined;\nconst registeredThemes = new Map<string, Theme>();\n\n/** Name of the theme most recently applied via initTheme/setTheme (\"<in-memory>\" for direct instances). */\nexport function getCurrentThemeName(): string | undefined {\n\treturn currentThemeName;\n}\n\nexport function setRegisteredThemes(themes: Theme[]): void {\n\tregisteredThemes.clear();\n\tfor (const theme of themes) {\n\t\tif (theme.name) {\n\t\t\tregisteredThemes.set(theme.name, theme);\n\t\t}\n\t}\n}\n\nexport function initTheme(themeName?: string, enableWatcher: boolean = false): void {\n\tconst name = themeName ?? getDefaultTheme();\n\tcurrentThemeName = name;\n\ttry {\n\t\tsetGlobalTheme(loadTheme(name, undefined, registeredThemes));\n\t\tif (enableWatcher) {\n\t\t\tstartThemeWatcher();\n\t\t}\n\t} catch (_error) {\n\t\t// Theme is invalid - fall back to dark theme silently\n\t\tcurrentThemeName = \"dark\";\n\t\tsetGlobalTheme(loadTheme(\"dark\", undefined, registeredThemes));\n\t\t// Don't start watcher for fallback theme\n\t}\n}\n\nexport function setTheme(name: string, enableWatcher: boolean = false): { success: boolean; error?: string } {\n\tcurrentThemeName = name;\n\ttry {\n\t\tsetGlobalTheme(loadTheme(name, undefined, registeredThemes));\n\t\tif (enableWatcher) {\n\t\t\tstartThemeWatcher();\n\t\t}\n\t\tif (onThemeChangeCallback) {\n\t\t\tonThemeChangeCallback();\n\t\t}\n\t\treturn { success: true };\n\t} catch (error) {\n\t\t// Theme is invalid - fall back to dark theme\n\t\tcurrentThemeName = \"dark\";\n\t\tsetGlobalTheme(loadTheme(\"dark\", undefined, registeredThemes));\n\t\t// Don't start watcher for fallback theme\n\t\treturn {\n\t\t\tsuccess: false,\n\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t};\n\t}\n}\n\nexport function setThemeInstance(themeInstance: Theme): void {\n\tsetGlobalTheme(themeInstance);\n\tcurrentThemeName = \"<in-memory>\";\n\tstopThemeWatcher(); // Can't watch a direct instance\n\tif (onThemeChangeCallback) {\n\t\tonThemeChangeCallback();\n\t}\n}\n\nexport function onThemeChange(callback: () => void): void {\n\tonThemeChangeCallback = callback;\n}\n\nfunction startThemeWatcher(): void {\n\tstopThemeWatcher();\n\n\t// Only watch if it's a custom theme (not built-in)\n\tif (!currentThemeName || currentThemeName === \"dark\" || currentThemeName === \"light\") {\n\t\treturn;\n\t}\n\n\tconst customThemesDir = getCustomThemesDir();\n\tconst watchedThemeName = currentThemeName;\n\tconst watchedFileName = `${watchedThemeName}.json`;\n\tconst themeFile = path.join(customThemesDir, watchedFileName);\n\n\t// Only watch if the file exists\n\tif (!fs.existsSync(themeFile)) {\n\t\treturn;\n\t}\n\n\tconst scheduleReload = () => {\n\t\tif (themeReloadTimer) {\n\t\t\tclearTimeout(themeReloadTimer);\n\t\t}\n\t\tthemeReloadTimer = setTimeout(() => {\n\t\t\tthemeReloadTimer = undefined;\n\n\t\t\t// Ignore stale timers after switching themes or stopping the watcher\n\t\t\tif (currentThemeName !== watchedThemeName) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Keep the last successfully loaded theme active if the file is temporarily missing\n\t\t\tif (!fs.existsSync(themeFile)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\t// Reload the theme from disk and refresh the registry cache\n\t\t\t\tconst reloadedTheme = loadThemeFromPath(themeFile);\n\t\t\t\tregisteredThemes.set(watchedThemeName, reloadedTheme);\n\t\t\t\tsetGlobalTheme(reloadedTheme);\n\t\t\t\t// Notify callback (to invalidate UI)\n\t\t\t\tif (onThemeChangeCallback) {\n\t\t\t\t\tonThemeChangeCallback();\n\t\t\t\t}\n\t\t\t} catch (_error) {\n\t\t\t\t// Ignore errors (file might be in invalid state while being edited)\n\t\t\t}\n\t\t}, 100);\n\t};\n\n\tthemeWatcher =\n\t\twatchWithErrorHandler(\n\t\t\tcustomThemesDir,\n\t\t\t(_eventType, filename) => {\n\t\t\t\tif (currentThemeName !== watchedThemeName) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (!filename) {\n\t\t\t\t\tscheduleReload();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tif (filename !== watchedFileName) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tscheduleReload();\n\t\t\t},\n\t\t\t() => {\n\t\t\t\tcloseWatcher(themeWatcher);\n\t\t\t\tthemeWatcher = undefined;\n\t\t\t},\n\t\t) ?? undefined;\n}\n\nexport function stopThemeWatcher(): void {\n\tif (themeReloadTimer) {\n\t\tclearTimeout(themeReloadTimer);\n\t\tthemeReloadTimer = undefined;\n\t}\n\tcloseWatcher(themeWatcher);\n\tthemeWatcher = undefined;\n}\n\n// ============================================================================\n// HTML Export Helpers\n// ============================================================================\n\n/**\n * Get resolved theme colors as CSS-compatible hex strings.\n * Used by HTML export to generate CSS custom properties.\n */\nexport function getResolvedThemeColors(themeName?: string): Record<string, string> {\n\tconst name = themeName ?? currentThemeName ?? getDefaultTheme();\n\treturn coreGetResolvedThemeColors(name, registeredThemes);\n}\n\n/**\n * Check if a theme is a \"light\" theme (for CSS that needs light/dark variants).\n */\nexport function isLightTheme(themeName?: string): boolean {\n\t// Currently just check the name - could be extended to analyze colors\n\treturn themeName === \"light\";\n}\n\n/**\n * Get explicit export colors from theme JSON, if specified.\n * Returns undefined for each color that isn't explicitly set.\n */\nexport function getThemeExportColors(themeName?: string): {\n\tpageBg?: string;\n\tcardBg?: string;\n\tinfoBg?: string;\n} {\n\tconst name = themeName ?? currentThemeName ?? getDefaultTheme();\n\treturn coreGetThemeExportColors(name, registeredThemes);\n}\n\n// ============================================================================\n// TUI Helpers\n// ============================================================================\n\ntype CliHighlightTheme = Record<string, (s: string) => string>;\n\nlet cachedHighlightThemeFor: Theme | undefined;\nlet cachedCliHighlightTheme: CliHighlightTheme | undefined;\n\nfunction buildCliHighlightTheme(t: Theme): CliHighlightTheme {\n\treturn {\n\t\tkeyword: (s: string) => t.fg(\"syntaxKeyword\", s),\n\t\tbuilt_in: (s: string) => t.fg(\"syntaxType\", s),\n\t\tliteral: (s: string) => t.fg(\"syntaxNumber\", s),\n\t\tnumber: (s: string) => t.fg(\"syntaxNumber\", s),\n\t\tregexp: (s: string) => t.fg(\"syntaxString\", s),\n\t\tstring: (s: string) => t.fg(\"syntaxString\", s),\n\t\tcomment: (s: string) => t.fg(\"syntaxComment\", s),\n\t\tdoctag: (s: string) => t.fg(\"syntaxComment\", s),\n\t\tmeta: (s: string) => t.fg(\"muted\", s),\n\t\tfunction: (s: string) => t.fg(\"syntaxFunction\", s),\n\t\ttitle: (s: string) => t.fg(\"syntaxFunction\", s),\n\t\tclass: (s: string) => t.fg(\"syntaxType\", s),\n\t\ttype: (s: string) => t.fg(\"syntaxType\", s),\n\t\ttag: (s: string) => t.fg(\"syntaxPunctuation\", s),\n\t\tname: (s: string) => t.fg(\"syntaxKeyword\", s),\n\t\tattr: (s: string) => t.fg(\"syntaxVariable\", s),\n\t\tvariable: (s: string) => t.fg(\"syntaxVariable\", s),\n\t\tparams: (s: string) => t.fg(\"syntaxVariable\", s),\n\t\toperator: (s: string) => t.fg(\"syntaxOperator\", s),\n\t\tpunctuation: (s: string) => t.fg(\"syntaxPunctuation\", s),\n\t\temphasis: (s: string) => t.italic(s),\n\t\tstrong: (s: string) => t.bold(s),\n\t\tlink: (s: string) => t.underline(s),\n\t\taddition: (s: string) => t.fg(\"toolDiffAdded\", s),\n\t\tdeletion: (s: string) => t.fg(\"toolDiffRemoved\", s),\n\t};\n}\n\nfunction getCliHighlightTheme(t: Theme): CliHighlightTheme {\n\tif (cachedHighlightThemeFor !== t || !cachedCliHighlightTheme) {\n\t\tcachedHighlightThemeFor = t;\n\t\tcachedCliHighlightTheme = buildCliHighlightTheme(t);\n\t}\n\treturn cachedCliHighlightTheme;\n}\n\n/**\n * Highlight code with syntax coloring based on file extension or language.\n * Returns array of highlighted lines.\n */\nexport function highlightCode(code: string, lang?: string): string[] {\n\t// Validate language before highlighting to avoid stderr spam from cli-highlight\n\tconst validLang = lang && supportsLanguage(lang) ? lang : undefined;\n\t// Skip highlighting when no valid language is specified. cli-highlight's\n\t// auto-detection is unreliable and can misidentify prose as AppleScript,\n\t// LiveCodeServer, etc., coloring random English words as keywords.\n\tif (!validLang) {\n\t\treturn code.split(\"\\n\").map((line) => theme.fg(\"mdCodeBlock\", line));\n\t}\n\tconst opts = {\n\t\tlanguage: validLang,\n\t\tignoreIllegals: true,\n\t\ttheme: getCliHighlightTheme(theme),\n\t};\n\ttry {\n\t\treturn highlight(code, opts).split(\"\\n\");\n\t} catch {\n\t\treturn code.split(\"\\n\");\n\t}\n}\n\nconst SHELL_CONTROL_WORDS = new Set([\n\t\"case\",\n\t\"coproc\",\n\t\"do\",\n\t\"done\",\n\t\"elif\",\n\t\"else\",\n\t\"esac\",\n\t\"fi\",\n\t\"for\",\n\t\"function\",\n\t\"if\",\n\t\"in\",\n\t\"select\",\n\t\"then\",\n\t\"time\",\n\t\"until\",\n\t\"while\",\n]);\nconst SHELL_LIST_OPERATORS = new Set([\"&\", \"&&\", \";\", \";&\", \";;&\", \";;\", \"|\", \"|&\", \"||\"]);\nconst SHELL_REDIRECTION_PATTERN = /^(?:\\d+)?(?:<<<|<<-|<<|>>|<>|>&|<&|>\\||&>|>|<)/;\n\ntype ShellHighlightToken = {\n\tkind: \"newline\" | \"operator\" | \"word\";\n\tstart: number;\n\tend: number;\n\tvalue: string;\n};\n\nfunction tokenizeShellCommand(command: string): ShellHighlightToken[] | undefined {\n\tconst tokens: ShellHighlightToken[] = [];\n\tlet index = 0;\n\n\twhile (index < command.length) {\n\t\tconst char = command[index]!;\n\t\tif (char === \"\\n\") {\n\t\t\ttokens.push({ kind: \"newline\", start: index, end: index + 1, value: char });\n\t\t\tindex++;\n\t\t\tcontinue;\n\t\t}\n\t\tif (/\\s/.test(char)) {\n\t\t\tindex++;\n\t\t\tcontinue;\n\t\t}\n\t\tif (char === \"#\") {\n\t\t\tconst newline = command.indexOf(\"\\n\", index);\n\t\t\tindex = newline === -1 ? command.length : newline;\n\t\t\tcontinue;\n\t\t}\n\t\tif (char === \"`\" || \"(){}\".includes(char) || command.startsWith(\"$(\", index)) return undefined;\n\t\tif ((char === \"<\" || char === \">\") && command[index + 1] === \"(\") return undefined;\n\n\t\tconst redirection = SHELL_REDIRECTION_PATTERN.exec(command.slice(index))?.[0];\n\t\tif (redirection) {\n\t\t\tif (redirection.includes(\"<<\")) return undefined;\n\t\t\ttokens.push({ kind: \"operator\", start: index, end: index + redirection.length, value: redirection });\n\t\t\tindex += redirection.length;\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst listOperator = [\";;&\", \"&&\", \"||\", \"|&\", \";;\", \";&\", \";\", \"|\", \"&\"].find((operator) =>\n\t\t\tcommand.startsWith(operator, index),\n\t\t);\n\t\tconst negationOperator = char === \"!\" && (index + 1 === command.length || /\\s/.test(command[index + 1]!));\n\t\tif (listOperator || negationOperator) {\n\t\t\tconst operator = listOperator ?? \"!\";\n\t\t\ttokens.push({ kind: \"operator\", start: index, end: index + operator.length, value: operator });\n\t\t\tindex += operator.length;\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst start = index;\n\t\tlet quote: \"'\" | '\"' | undefined;\n\t\twhile (index < command.length) {\n\t\t\tconst current = command[index]!;\n\t\t\tif (current === \"\\\\\" && quote !== \"'\") {\n\t\t\t\tindex += Math.min(2, command.length - index);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (quote) {\n\t\t\t\tif (quote === '\"' && (current === \"`\" || command.startsWith(\"$(\", index))) return undefined;\n\t\t\t\tif (current === quote) quote = undefined;\n\t\t\t\tindex++;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (current === \"'\" || current === '\"') {\n\t\t\t\tquote = current;\n\t\t\t\tindex++;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (current === \"`\" || \"(){}\".includes(current) || command.startsWith(\"$(\", index)) return undefined;\n\t\t\tif (/\\s/.test(current) || SHELL_REDIRECTION_PATTERN.test(command.slice(index))) break;\n\t\t\tif ([\";\", \"|\", \"&\"].includes(current)) break;\n\t\t\tindex++;\n\t\t}\n\t\tif (quote) return undefined;\n\t\ttokens.push({ kind: \"word\", start, end: index, value: command.slice(start, index) });\n\t}\n\n\treturn tokens;\n}\n\nfunction findShellCommandRanges(command: string): Array<{ start: number; end: number }> {\n\tconst tokens = tokenizeShellCommand(command);\n\tif (!tokens) return [];\n\n\tconst ranges: Array<{ start: number; end: number }> = [];\n\tlet expectsCommand = true;\n\tlet expectsRedirectionTarget = false;\n\tfor (const token of tokens) {\n\t\tif (token.kind === \"newline\" || (token.kind === \"operator\" && SHELL_LIST_OPERATORS.has(token.value))) {\n\t\t\texpectsCommand = true;\n\t\t\texpectsRedirectionTarget = false;\n\t\t\tcontinue;\n\t\t}\n\t\tif (token.kind === \"operator\") {\n\t\t\tif (token.value === \"!\") continue;\n\t\t\texpectsRedirectionTarget = true;\n\t\t\tcontinue;\n\t\t}\n\t\tif (expectsRedirectionTarget) {\n\t\t\texpectsRedirectionTarget = false;\n\t\t\tcontinue;\n\t\t}\n\t\tif (!expectsCommand || /^[A-Za-z_][A-Za-z0-9_]*\\+?=/.test(token.value)) continue;\n\t\tif (SHELL_CONTROL_WORDS.has(token.value) || token.value.startsWith(\"-\")) return [];\n\t\tranges.push({ start: token.start, end: token.end });\n\t\texpectsCommand = false;\n\t}\n\treturn ranges;\n}\n\n/** Highlight Bash syntax, with a conservative command-name overlay for arbitrary executables. */\nexport function highlightShellCommand(command: string, baseColor: ThemeColor = \"toolTitle\"): string[] {\n\ttry {\n\t\treturn highlight(command, {\n\t\t\tlanguage: \"bash\",\n\t\t\tignoreIllegals: true,\n\t\t\tstyleOverlays: findShellCommandRanges(command).map(({ start, end }) => ({\n\t\t\t\tstart,\n\t\t\t\tend,\n\t\t\t\tformatter: (text) => theme.fg(\"syntaxFunction\", text),\n\t\t\t})),\n\t\t\ttheme: {\n\t\t\t\t...getCliHighlightTheme(theme),\n\t\t\t\tdefault: (text) => theme.fg(baseColor, text),\n\t\t\t},\n\t\t}).split(\"\\n\");\n\t} catch {\n\t\treturn command.split(\"\\n\").map((line) => theme.fg(baseColor, line));\n\t}\n}\n\n/**\n * Get language identifier from file path extension.\n */\nexport function getLanguageFromPath(filePath: string): string | undefined {\n\tconst ext = filePath.split(\".\").pop()?.toLowerCase();\n\tif (!ext) return undefined;\n\n\tconst extToLang: Record<string, string> = {\n\t\tts: \"typescript\",\n\t\ttsx: \"typescript\",\n\t\tjs: \"javascript\",\n\t\tjsx: \"javascript\",\n\t\tmjs: \"javascript\",\n\t\tcjs: \"javascript\",\n\t\tpy: \"python\",\n\t\trb: \"ruby\",\n\t\trs: \"rust\",\n\t\tgo: \"go\",\n\t\tjava: \"java\",\n\t\tkt: \"kotlin\",\n\t\tswift: \"swift\",\n\t\tc: \"c\",\n\t\th: \"c\",\n\t\tcpp: \"cpp\",\n\t\tcc: \"cpp\",\n\t\tcxx: \"cpp\",\n\t\thpp: \"cpp\",\n\t\tcs: \"csharp\",\n\t\tphp: \"php\",\n\t\tsh: \"bash\",\n\t\tbash: \"bash\",\n\t\tzsh: \"bash\",\n\t\tfish: \"fish\",\n\t\tps1: \"powershell\",\n\t\tsql: \"sql\",\n\t\thtml: \"html\",\n\t\thtm: \"html\",\n\t\tcss: \"css\",\n\t\tscss: \"scss\",\n\t\tsass: \"sass\",\n\t\tless: \"less\",\n\t\tjson: \"json\",\n\t\tyaml: \"yaml\",\n\t\tyml: \"yaml\",\n\t\ttoml: \"toml\",\n\t\txml: \"xml\",\n\t\tmd: \"markdown\",\n\t\tmarkdown: \"markdown\",\n\t\tdockerfile: \"dockerfile\",\n\t\tmakefile: \"makefile\",\n\t\tcmake: \"cmake\",\n\t\tlua: \"lua\",\n\t\tperl: \"perl\",\n\t\tr: \"r\",\n\t\tscala: \"scala\",\n\t\tclj: \"clojure\",\n\t\tex: \"elixir\",\n\t\texs: \"elixir\",\n\t\terl: \"erlang\",\n\t\ths: \"haskell\",\n\t\tml: \"ocaml\",\n\t\tvim: \"vim\",\n\t\tgraphql: \"graphql\",\n\t\tproto: \"protobuf\",\n\t\ttf: \"hcl\",\n\t\thcl: \"hcl\",\n\t};\n\n\treturn extToLang[ext];\n}\n\nexport function getMarkdownTheme(): MarkdownTheme {\n\treturn {\n\t\theading: (text: string) => theme.fg(\"mdHeading\", text),\n\t\tlink: (text: string) => theme.fg(\"mdLink\", text),\n\t\tlinkUrl: (text: string) => theme.fg(\"mdLinkUrl\", text),\n\t\tcode: (text: string) => theme.fg(\"mdCode\", text),\n\t\tcodeBlock: (text: string) => theme.fg(\"mdCodeBlock\", text),\n\t\tcodeBlockBorder: (text: string) => theme.fg(\"mdCodeBlockBorder\", text),\n\t\tquote: (text: string) => theme.fg(\"mdQuote\", text),\n\t\tquoteBorder: (text: string) => theme.fg(\"mdQuoteBorder\", text),\n\t\thr: (text: string) => theme.fg(\"mdHr\", text),\n\t\tlistBullet: (text: string) => theme.fg(\"mdListBullet\", text),\n\t\tbold: (text: string) => theme.bold(text),\n\t\titalic: (text: string) => theme.italic(text),\n\t\tunderline: (text: string) => theme.underline(text),\n\t\tstrikethrough: (text: string) => chalk.strikethrough(text),\n\t\thighlightCode: (code: string, lang?: string): string[] => {\n\t\t\t// Validate language before highlighting to avoid stderr spam from cli-highlight\n\t\t\tconst validLang = lang && supportsLanguage(lang) ? lang : undefined;\n\t\t\t// Skip highlighting when no valid language is specified. cli-highlight's\n\t\t\t// auto-detection is unreliable and can misidentify prose as AppleScript,\n\t\t\t// LiveCodeServer, etc., coloring random English words as keywords.\n\t\t\tif (!validLang) {\n\t\t\t\treturn code.split(\"\\n\").map((line) => theme.fg(\"mdCodeBlock\", line));\n\t\t\t}\n\t\t\tconst opts = {\n\t\t\t\tlanguage: validLang,\n\t\t\t\tignoreIllegals: true,\n\t\t\t\ttheme: getCliHighlightTheme(theme),\n\t\t\t};\n\t\t\ttry {\n\t\t\t\treturn highlight(code, opts).split(\"\\n\");\n\t\t\t} catch {\n\t\t\t\treturn code.split(\"\\n\").map((line) => theme.fg(\"mdCodeBlock\", line));\n\t\t\t}\n\t\t},\n\t};\n}\n\nexport function getSelectListTheme(): SelectListTheme {\n\treturn {\n\t\tselectedPrefix: (text: string) => theme.fg(\"accent\", text),\n\t\tselectedText: (text: string) => theme.fg(\"accent\", text),\n\t\tdescription: (text: string) => theme.fg(\"muted\", text),\n\t\tscrollInfo: (text: string) => theme.fg(\"muted\", text),\n\t\tnoMatch: (text: string) => theme.fg(\"muted\", text),\n\t};\n}\n\nexport function getEditorTheme(): EditorTheme {\n\treturn {\n\t\tborderColor: (text: string) => theme.fg(\"borderMuted\", text),\n\t\tselectList: getSelectListTheme(),\n\t\tplaceholder: (text: string) => theme.fg(\"dim\", text),\n\t};\n}\n\nexport function getSettingsListTheme(): SettingsListTheme {\n\treturn {\n\t\tlabel: (text: string, selected: boolean) => (selected ? theme.fg(\"accent\", text) : text),\n\t\tvalue: (text: string, selected: boolean) => (selected ? theme.fg(\"accent\", text) : theme.fg(\"muted\", text)),\n\t\tdescription: (text: string) => theme.fg(\"dim\", text),\n\t\tcursor: theme.fg(\"accent\", \"→ \"),\n\t\thint: (text: string) => theme.fg(\"dim\", text),\n\t\tsection: (text: string) => theme.bold(theme.fg(\"muted\", text)),\n\t};\n}\n"]}