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

package/dist/core/theme/theme-schema.json

@@ -0,0 +1,335 @@
+{
+	"$schema": "http://json-schema.org/draft-07/schema#",
+	"title": "Volt Coding Agent Theme",
+	"description": "Theme schema for Volt coding agent",
+	"type": "object",
+	"required": ["name", "colors"],
+	"properties": {
+		"$schema": {
+			"type": "string",
+			"description": "JSON schema reference"
+		},
+		"name": {
+			"type": "string",
+			"description": "Theme name"
+		},
+		"vars": {
+			"type": "object",
+			"description": "Reusable color variables",
+			"additionalProperties": {
+				"oneOf": [
+					{
+						"type": "string",
+						"description": "Hex color (#RRGGBB), variable reference, or empty string for terminal default"
+					},
+					{
+						"type": "integer",
+						"minimum": 0,
+						"maximum": 255,
+						"description": "256-color palette index (0-255)"
+					}
+				]
+			}
+		},
+		"colors": {
+			"type": "object",
+			"description": "Theme color definitions (all required)",
+			"required": [
+				"accent",
+				"border",
+				"borderAccent",
+				"borderMuted",
+				"success",
+				"error",
+				"warning",
+				"muted",
+				"dim",
+				"text",
+				"thinkingText",
+				"selectedBg",
+				"userMessageBg",
+				"userMessageText",
+				"customMessageBg",
+				"customMessageText",
+				"customMessageLabel",
+				"toolPendingBg",
+				"toolSuccessBg",
+				"toolErrorBg",
+				"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"
+			],
+			"properties": {
+				"accent": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Primary accent color (logo, selected items, cursor)"
+				},
+				"border": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Normal borders"
+				},
+				"borderAccent": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Highlighted borders"
+				},
+				"borderMuted": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Subtle borders"
+				},
+				"success": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Success states"
+				},
+				"error": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Error states"
+				},
+				"warning": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Warning states"
+				},
+				"muted": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Secondary/dimmed text"
+				},
+				"dim": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Very dimmed text (more subtle than muted)"
+				},
+				"text": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Default text color (usually empty string)"
+				},
+				"thinkingText": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking block text color"
+				},
+				"selectedBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Selected item background"
+				},
+				"userMessageBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "User message background"
+				},
+				"userMessageText": {
+					"$ref": "#/$defs/colorValue",
+					"description": "User message text color"
+				},
+				"customMessageBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Custom message background (hook-injected messages)"
+				},
+				"customMessageText": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Custom message text color"
+				},
+				"customMessageLabel": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Custom message type label color"
+				},
+				"toolPendingBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box (pending state)"
+				},
+				"toolSuccessBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box (success state)"
+				},
+				"toolErrorBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box (error state)"
+				},
+				"toolTitle": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box title color"
+				},
+				"toolOutput": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Tool execution box output text color"
+				},
+				"mdHeading": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown heading text"
+				},
+				"mdLink": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown link text"
+				},
+				"mdLinkUrl": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown link URL"
+				},
+				"mdCode": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown inline code"
+				},
+				"mdCodeBlock": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown code block content"
+				},
+				"mdCodeBlockBorder": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown code block fences"
+				},
+				"mdQuote": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown blockquote text"
+				},
+				"mdQuoteBorder": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown blockquote border"
+				},
+				"mdHr": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown horizontal rule"
+				},
+				"mdListBullet": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Markdown list bullets/numbers"
+				},
+				"toolDiffAdded": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Added lines in tool diffs"
+				},
+				"toolDiffRemoved": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Removed lines in tool diffs"
+				},
+				"toolDiffContext": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Context lines in tool diffs"
+				},
+				"syntaxComment": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: comments"
+				},
+				"syntaxKeyword": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: keywords"
+				},
+				"syntaxFunction": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: function names"
+				},
+				"syntaxVariable": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: variable names"
+				},
+				"syntaxString": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: string literals"
+				},
+				"syntaxNumber": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: number literals"
+				},
+				"syntaxType": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: type names"
+				},
+				"syntaxOperator": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: operators"
+				},
+				"syntaxPunctuation": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Syntax highlighting: punctuation"
+				},
+				"thinkingOff": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: off"
+				},
+				"thinkingMinimal": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: minimal"
+				},
+				"thinkingLow": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: low"
+				},
+				"thinkingMedium": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: medium"
+				},
+				"thinkingHigh": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: high"
+				},
+				"thinkingXhigh": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Thinking level border: xhigh and max"
+				},
+				"bashMode": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Editor border color in bash mode"
+				}
+			},
+			"additionalProperties": false
+		},
+		"export": {
+			"type": "object",
+			"description": "Optional colors for HTML export (defaults derived from userMessageBg if not specified)",
+			"properties": {
+				"pageBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Page background color"
+				},
+				"cardBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Card/container background color"
+				},
+				"infoBg": {
+					"$ref": "#/$defs/colorValue",
+					"description": "Info sections background (system prompt, notices)"
+				}
+			},
+			"additionalProperties": false
+		}
+	},
+	"additionalProperties": false,
+	"$defs": {
+		"colorValue": {
+			"oneOf": [
+				{
+					"type": "string",
+					"description": "Hex color (#RRGGBB), variable reference, or empty string for terminal default"
+				},
+				{
+					"type": "integer",
+					"minimum": 0,
+					"maximum": 255,
+					"description": "256-color palette index (0-255)"
+				}
+			]
+		}
+	}
+}

package/dist/core/theme/theme-service.d.ts

@@ -0,0 +1,37 @@
+import { type ThemeDiscoveryDirs } from "./discovery.ts";
+import { Theme } from "./theme.ts";
+import type { ColorMode, ResolvedThemeTokens, ThemeInfo } from "./types.ts";
+export interface ThemeServiceOptions {
+    /** Overrides the built-in and custom theme directories (tests). */
+    dirs?: ThemeDiscoveryDirs;
+    /** Initial theme name; defaults to terminal background detection (dark on failure). */
+    initialTheme?: string;
+    /** Force a color mode instead of detecting terminal capabilities. */
+    colorMode?: ColorMode;
+    /** Called after a successful setTheme with the resolved theme name (persistence hook). */
+    onPersist?: (name: string) => void | Promise<void>;
+}
+export interface ThemeSetResult {
+    success: boolean;
+    error?: string;
+}
+export interface ThemeService {
+    /** Resolved active theme. */
+    readonly current: Theme;
+    /** Name the active theme was loaded under ("<in-memory>" for direct instances). */
+    readonly currentThemeName: string | undefined;
+    getAllThemes(): Theme[];
+    getAvailableThemeInfos(): ThemeInfo[];
+    getTheme(name: string): Theme | undefined;
+    setTheme(theme: string | Theme): Promise<ThemeSetResult>;
+    /** Flat CSS-hex token map for snapshots; defaults to the active theme. */
+    resolveTokens(theme?: Theme): ResolvedThemeTokens;
+    /** Themes registered by extensions/resource loading; they shadow custom-dir themes. */
+    setRegisteredThemes(themes: Theme[]): void;
+    subscribe(cb: (theme: Theme) => void): () => void;
+    /** Hot-reload fs watcher for custom theme files — enabled ONLY by the rendering (TUI) process. */
+    enableHotReload(): void;
+    dispose(): void;
+}
+export declare function createThemeService(options?: ThemeServiceOptions): ThemeService;
+//# sourceMappingURL=theme-service.d.ts.map

package/dist/core/theme/theme-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-service.d.ts","sourceRoot":"","sources":["../../../src/core/theme/theme-service.ts"],"names":[],"mappings":"AAIA,OAAO,EAMN,KAAK,kBAAkB,EACvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IACnC,mEAAmE;IACnE,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,0FAA0F;IAC1F,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC5B,6BAA6B;IAC7B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,mFAAmF;IACnF,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9C,YAAY,IAAI,KAAK,EAAE,CAAC;IACxB,sBAAsB,IAAI,SAAS,EAAE,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACzD,0EAA0E;IAC1E,aAAa,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,mBAAmB,CAAC;IAClD,uFAAuF;IACvF,mBAAmB,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAC3C,SAAS,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAClD,oGAAkG;IAClG,eAAe,IAAI,IAAI,CAAC;IACxB,OAAO,IAAI,IAAI,CAAC;CAChB;AA2OD,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAElF","sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { getCustomThemesDir, getThemesDir } from \"../../config.ts\";\nimport { closeWatcher, watchWithErrorHandler } from \"../../utils/fs-watch.ts\";\nimport {\n\tgetAvailableThemesWithPaths,\n\tgetDefaultTheme,\n\tgetResolvedThemeColors,\n\tloadTheme,\n\tloadThemeFromPath,\n\ttype ThemeDiscoveryDirs,\n} from \"./discovery.ts\";\nimport { Theme } from \"./theme.ts\";\nimport { ansi256ToHex } from \"./tokens.ts\";\nimport type { ColorMode, ResolvedThemeTokens, ThemeInfo } from \"./types.ts\";\n\nexport interface ThemeServiceOptions {\n\t/** Overrides the built-in and custom theme directories (tests). */\n\tdirs?: ThemeDiscoveryDirs;\n\t/** Initial theme name; defaults to terminal background detection (dark on failure). */\n\tinitialTheme?: string;\n\t/** Force a color mode instead of detecting terminal capabilities. */\n\tcolorMode?: ColorMode;\n\t/** Called after a successful setTheme with the resolved theme name (persistence hook). */\n\tonPersist?: (name: string) => void | Promise<void>;\n}\n\nexport interface ThemeSetResult {\n\tsuccess: boolean;\n\terror?: string;\n}\n\nexport interface ThemeService {\n\t/** Resolved active theme. */\n\treadonly current: Theme;\n\t/** Name the active theme was loaded under (\"<in-memory>\" for direct instances). */\n\treadonly currentThemeName: string | undefined;\n\tgetAllThemes(): Theme[];\n\tgetAvailableThemeInfos(): ThemeInfo[];\n\tgetTheme(name: string): Theme | undefined;\n\tsetTheme(theme: string | Theme): Promise<ThemeSetResult>;\n\t/** Flat CSS-hex token map for snapshots; defaults to the active theme. */\n\tresolveTokens(theme?: Theme): ResolvedThemeTokens;\n\t/** Themes registered by extensions/resource loading; they shadow custom-dir themes. */\n\tsetRegisteredThemes(themes: Theme[]): void;\n\tsubscribe(cb: (theme: Theme) => void): () => void;\n\t/** Hot-reload fs watcher for custom theme files — enabled ONLY by the rendering (TUI) process. */\n\tenableHotReload(): void;\n\tdispose(): void;\n}\n\nclass ThemeServiceImpl implements ThemeService {\n\tprivate readonly dirs: { themesDir: string; customThemesDir: string };\n\tprivate readonly colorMode: ColorMode | undefined;\n\tprivate readonly onPersist: ((name: string) => void | Promise<void>) | undefined;\n\tprivate readonly registeredThemes = new Map<string, Theme>();\n\tprivate readonly subscribers = new Set<(theme: Theme) => void>();\n\tprivate currentTheme: Theme;\n\tprivate currentName: string | undefined;\n\tprivate hotReloadEnabled = false;\n\tprivate watcher: fs.FSWatcher | undefined;\n\tprivate reloadTimer: NodeJS.Timeout | undefined;\n\tprivate disposed = false;\n\n\tconstructor(options: ThemeServiceOptions) {\n\t\tthis.dirs = {\n\t\t\tthemesDir: options.dirs?.themesDir ?? getThemesDir(),\n\t\t\tcustomThemesDir: options.dirs?.customThemesDir ?? getCustomThemesDir(),\n\t\t};\n\t\tthis.colorMode = options.colorMode;\n\t\tthis.onPersist = options.onPersist;\n\t\tconst name = options.initialTheme ?? getDefaultTheme();\n\t\tthis.currentName = name;\n\t\ttry {\n\t\t\tthis.currentTheme = this.load(name);\n\t\t} catch {\n\t\t\t// Theme is invalid - fall back to dark theme silently\n\t\t\tthis.currentName = \"dark\";\n\t\t\tthis.currentTheme = this.load(\"dark\");\n\t\t}\n\t}\n\n\tget current(): Theme {\n\t\treturn this.currentTheme;\n\t}\n\n\tget currentThemeName(): string | undefined {\n\t\treturn this.currentName;\n\t}\n\n\tprivate load(name: string): Theme {\n\t\treturn loadTheme(name, this.colorMode, this.registeredThemes, this.dirs);\n\t}\n\n\tgetAvailableThemeInfos(): ThemeInfo[] {\n\t\treturn getAvailableThemesWithPaths(this.registeredThemes, this.dirs);\n\t}\n\n\tgetAllThemes(): Theme[] {\n\t\tconst themes: Theme[] = [];\n\t\tfor (const info of this.getAvailableThemeInfos()) {\n\t\t\tconst theme = this.getTheme(info.name);\n\t\t\tif (theme) {\n\t\t\t\tthemes.push(theme);\n\t\t\t}\n\t\t}\n\t\treturn themes;\n\t}\n\n\tgetTheme(name: string): Theme | undefined {\n\t\ttry {\n\t\t\treturn this.load(name);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tasync setTheme(theme: string | Theme): Promise<ThemeSetResult> {\n\t\tif (theme instanceof Theme) {\n\t\t\tthis.currentTheme = theme;\n\t\t\tthis.currentName = theme.name ?? \"<in-memory>\";\n\t\t\tthis.stopWatcher(); // Can't watch a direct instance\n\t\t\tthis.notify();\n\t\t\treturn { success: true };\n\t\t}\n\t\tthis.currentName = theme;\n\t\ttry {\n\t\t\tthis.currentTheme = this.load(theme);\n\t\t\tthis.restartWatcherIfEnabled();\n\t\t\tthis.notify();\n\t\t\tawait this.onPersist?.(theme);\n\t\t\treturn { success: true };\n\t\t} catch (error) {\n\t\t\t// Theme is invalid - fall back to dark theme\n\t\t\tthis.currentName = \"dark\";\n\t\t\tthis.currentTheme = this.load(\"dark\");\n\t\t\tthis.notify();\n\t\t\treturn {\n\t\t\t\tsuccess: false,\n\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t};\n\t\t}\n\t}\n\n\tresolveTokens(theme?: Theme): ResolvedThemeTokens {\n\t\tconst target = theme ?? this.currentTheme;\n\t\tconst name = theme === undefined ? this.currentName : theme.name;\n\t\tif (name && name !== \"<in-memory>\") {\n\t\t\ttry {\n\t\t\t\treturn getResolvedThemeColors(name, this.registeredThemes, this.dirs);\n\t\t\t} catch {\n\t\t\t\t// Fall through to instance-derived tokens for themes without a loadable source.\n\t\t\t}\n\t\t}\n\t\tconst defaultText = name === \"light\" ? \"#000000\" : \"#e5e5e7\";\n\t\tconst tokens: ResolvedThemeTokens = {};\n\t\tfor (const [key, value] of Object.entries(target.resolvedColors)) {\n\t\t\tif (typeof value === \"number\") {\n\t\t\t\ttokens[key] = ansi256ToHex(value);\n\t\t\t} else if (value === \"\") {\n\t\t\t\ttokens[key] = defaultText;\n\t\t\t} else {\n\t\t\t\ttokens[key] = value;\n\t\t\t}\n\t\t}\n\t\treturn tokens;\n\t}\n\n\tsetRegisteredThemes(themes: Theme[]): void {\n\t\tthis.registeredThemes.clear();\n\t\tfor (const theme of themes) {\n\t\t\tif (theme.name) {\n\t\t\t\tthis.registeredThemes.set(theme.name, theme);\n\t\t\t}\n\t\t}\n\t}\n\n\tsubscribe(cb: (theme: Theme) => void): () => void {\n\t\tthis.subscribers.add(cb);\n\t\treturn () => {\n\t\t\tthis.subscribers.delete(cb);\n\t\t};\n\t}\n\n\tenableHotReload(): void {\n\t\tthis.hotReloadEnabled = true;\n\t\tthis.restartWatcherIfEnabled();\n\t}\n\n\tdispose(): void {\n\t\tthis.disposed = true;\n\t\tthis.stopWatcher();\n\t\tthis.subscribers.clear();\n\t}\n\n\tprivate notify(): void {\n\t\tfor (const cb of Array.from(this.subscribers)) {\n\t\t\tcb(this.currentTheme);\n\t\t}\n\t}\n\n\tprivate restartWatcherIfEnabled(): void {\n\t\tthis.stopWatcher();\n\t\tif (!this.hotReloadEnabled || this.disposed) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Only watch custom themes (not built-in)\n\t\tconst watchedThemeName = this.currentName;\n\t\tif (!watchedThemeName || watchedThemeName === \"dark\" || watchedThemeName === \"light\") {\n\t\t\treturn;\n\t\t}\n\n\t\tconst customThemesDir = this.dirs.customThemesDir;\n\t\tconst watchedFileName = `${watchedThemeName}.json`;\n\t\tconst themeFile = path.join(customThemesDir, watchedFileName);\n\n\t\t// Only watch if the file exists\n\t\tif (!fs.existsSync(themeFile)) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst scheduleReload = () => {\n\t\t\tif (this.reloadTimer) {\n\t\t\t\tclearTimeout(this.reloadTimer);\n\t\t\t}\n\t\t\tthis.reloadTimer = setTimeout(() => {\n\t\t\t\tthis.reloadTimer = undefined;\n\n\t\t\t\t// Ignore stale timers after switching themes or stopping the watcher\n\t\t\t\tif (this.currentName !== watchedThemeName) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Keep the last successfully loaded theme active if the file is temporarily missing\n\t\t\t\tif (!fs.existsSync(themeFile)) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\ttry {\n\t\t\t\t\t// Reload the theme from disk and refresh the registry cache\n\t\t\t\t\tconst reloadedTheme = loadThemeFromPath(themeFile, this.colorMode);\n\t\t\t\t\tthis.registeredThemes.set(watchedThemeName, reloadedTheme);\n\t\t\t\t\tthis.currentTheme = reloadedTheme;\n\t\t\t\t\tthis.notify();\n\t\t\t\t} catch {\n\t\t\t\t\t// Ignore errors (file might be in invalid state while being edited)\n\t\t\t\t}\n\t\t\t}, 100);\n\t\t};\n\n\t\tthis.watcher =\n\t\t\twatchWithErrorHandler(\n\t\t\t\tcustomThemesDir,\n\t\t\t\t(_eventType, filename) => {\n\t\t\t\t\tif (this.currentName !== watchedThemeName) {\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tif (!filename) {\n\t\t\t\t\t\tscheduleReload();\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tif (filename !== watchedFileName) {\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tscheduleReload();\n\t\t\t\t},\n\t\t\t\t() => {\n\t\t\t\t\tcloseWatcher(this.watcher);\n\t\t\t\t\tthis.watcher = undefined;\n\t\t\t\t},\n\t\t\t) ?? undefined;\n\t}\n\n\tprivate stopWatcher(): void {\n\t\tif (this.reloadTimer) {\n\t\t\tclearTimeout(this.reloadTimer);\n\t\t\tthis.reloadTimer = undefined;\n\t\t}\n\t\tcloseWatcher(this.watcher);\n\t\tthis.watcher = undefined;\n\t}\n}\n\nexport function createThemeService(options: ThemeServiceOptions = {}): ThemeService {\n\treturn new ThemeServiceImpl(options);\n}\n"]}

package/dist/core/theme/theme-service.js

@@ -0,0 +1,222 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getCustomThemesDir, getThemesDir } from "../../config.js";
+import { closeWatcher, watchWithErrorHandler } from "../../utils/fs-watch.js";
+import { getAvailableThemesWithPaths, getDefaultTheme, getResolvedThemeColors, loadTheme, loadThemeFromPath, } from "./discovery.js";
+import { Theme } from "./theme.js";
+import { ansi256ToHex } from "./tokens.js";
+class ThemeServiceImpl {
+    dirs;
+    colorMode;
+    onPersist;
+    registeredThemes = new Map();
+    subscribers = new Set();
+    currentTheme;
+    currentName;
+    hotReloadEnabled = false;
+    watcher;
+    reloadTimer;
+    disposed = false;
+    constructor(options) {
+        this.dirs = {
+            themesDir: options.dirs?.themesDir ?? getThemesDir(),
+            customThemesDir: options.dirs?.customThemesDir ?? getCustomThemesDir(),
+        };
+        this.colorMode = options.colorMode;
+        this.onPersist = options.onPersist;
+        const name = options.initialTheme ?? getDefaultTheme();
+        this.currentName = name;
+        try {
+            this.currentTheme = this.load(name);
+        }
+        catch {
+            // Theme is invalid - fall back to dark theme silently
+            this.currentName = "dark";
+            this.currentTheme = this.load("dark");
+        }
+    }
+    get current() {
+        return this.currentTheme;
+    }
+    get currentThemeName() {
+        return this.currentName;
+    }
+    load(name) {
+        return loadTheme(name, this.colorMode, this.registeredThemes, this.dirs);
+    }
+    getAvailableThemeInfos() {
+        return getAvailableThemesWithPaths(this.registeredThemes, this.dirs);
+    }
+    getAllThemes() {
+        const themes = [];
+        for (const info of this.getAvailableThemeInfos()) {
+            const theme = this.getTheme(info.name);
+            if (theme) {
+                themes.push(theme);
+            }
+        }
+        return themes;
+    }
+    getTheme(name) {
+        try {
+            return this.load(name);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async setTheme(theme) {
+        if (theme instanceof Theme) {
+            this.currentTheme = theme;
+            this.currentName = theme.name ?? "<in-memory>";
+            this.stopWatcher(); // Can't watch a direct instance
+            this.notify();
+            return { success: true };
+        }
+        this.currentName = theme;
+        try {
+            this.currentTheme = this.load(theme);
+            this.restartWatcherIfEnabled();
+            this.notify();
+            await this.onPersist?.(theme);
+            return { success: true };
+        }
+        catch (error) {
+            // Theme is invalid - fall back to dark theme
+            this.currentName = "dark";
+            this.currentTheme = this.load("dark");
+            this.notify();
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    resolveTokens(theme) {
+        const target = theme ?? this.currentTheme;
+        const name = theme === undefined ? this.currentName : theme.name;
+        if (name && name !== "<in-memory>") {
+            try {
+                return getResolvedThemeColors(name, this.registeredThemes, this.dirs);
+            }
+            catch {
+                // Fall through to instance-derived tokens for themes without a loadable source.
+            }
+        }
+        const defaultText = name === "light" ? "#000000" : "#e5e5e7";
+        const tokens = {};
+        for (const [key, value] of Object.entries(target.resolvedColors)) {
+            if (typeof value === "number") {
+                tokens[key] = ansi256ToHex(value);
+            }
+            else if (value === "") {
+                tokens[key] = defaultText;
+            }
+            else {
+                tokens[key] = value;
+            }
+        }
+        return tokens;
+    }
+    setRegisteredThemes(themes) {
+        this.registeredThemes.clear();
+        for (const theme of themes) {
+            if (theme.name) {
+                this.registeredThemes.set(theme.name, theme);
+            }
+        }
+    }
+    subscribe(cb) {
+        this.subscribers.add(cb);
+        return () => {
+            this.subscribers.delete(cb);
+        };
+    }
+    enableHotReload() {
+        this.hotReloadEnabled = true;
+        this.restartWatcherIfEnabled();
+    }
+    dispose() {
+        this.disposed = true;
+        this.stopWatcher();
+        this.subscribers.clear();
+    }
+    notify() {
+        for (const cb of Array.from(this.subscribers)) {
+            cb(this.currentTheme);
+        }
+    }
+    restartWatcherIfEnabled() {
+        this.stopWatcher();
+        if (!this.hotReloadEnabled || this.disposed) {
+            return;
+        }
+        // Only watch custom themes (not built-in)
+        const watchedThemeName = this.currentName;
+        if (!watchedThemeName || watchedThemeName === "dark" || watchedThemeName === "light") {
+            return;
+        }
+        const customThemesDir = this.dirs.customThemesDir;
+        const watchedFileName = `${watchedThemeName}.json`;
+        const themeFile = path.join(customThemesDir, watchedFileName);
+        // Only watch if the file exists
+        if (!fs.existsSync(themeFile)) {
+            return;
+        }
+        const scheduleReload = () => {
+            if (this.reloadTimer) {
+                clearTimeout(this.reloadTimer);
+            }
+            this.reloadTimer = setTimeout(() => {
+                this.reloadTimer = undefined;
+                // Ignore stale timers after switching themes or stopping the watcher
+                if (this.currentName !== watchedThemeName) {
+                    return;
+                }
+                // Keep the last successfully loaded theme active if the file is temporarily missing
+                if (!fs.existsSync(themeFile)) {
+                    return;
+                }
+                try {
+                    // Reload the theme from disk and refresh the registry cache
+                    const reloadedTheme = loadThemeFromPath(themeFile, this.colorMode);
+                    this.registeredThemes.set(watchedThemeName, reloadedTheme);
+                    this.currentTheme = reloadedTheme;
+                    this.notify();
+                }
+                catch {
+                    // Ignore errors (file might be in invalid state while being edited)
+                }
+            }, 100);
+        };
+        this.watcher =
+            watchWithErrorHandler(customThemesDir, (_eventType, filename) => {
+                if (this.currentName !== watchedThemeName) {
+                    return;
+                }
+                if (!filename) {
+                    scheduleReload();
+                    return;
+                }
+                if (filename !== watchedFileName) {
+                    return;
+                }
+                scheduleReload();
+            }, () => {
+                closeWatcher(this.watcher);
+                this.watcher = undefined;
+            }) ?? undefined;
+    }
+    stopWatcher() {
+        if (this.reloadTimer) {
+            clearTimeout(this.reloadTimer);
+            this.reloadTimer = undefined;
+        }
+        closeWatcher(this.watcher);
+        this.watcher = undefined;
+    }
+}
+export function createThemeService(options = {}) {
+    return new ThemeServiceImpl(options);
+}
+//# sourceMappingURL=theme-service.js.map

package/dist/core/theme/theme-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-service.js","sourceRoot":"","sources":["../../../src/core/theme/theme-service.ts"],"names":[],"mappings":"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","sourcesContent":["import * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { getCustomThemesDir, getThemesDir } from \"../../config.ts\";\nimport { closeWatcher, watchWithErrorHandler } from \"../../utils/fs-watch.ts\";\nimport {\n\tgetAvailableThemesWithPaths,\n\tgetDefaultTheme,\n\tgetResolvedThemeColors,\n\tloadTheme,\n\tloadThemeFromPath,\n\ttype ThemeDiscoveryDirs,\n} from \"./discovery.ts\";\nimport { Theme } from \"./theme.ts\";\nimport { ansi256ToHex } from \"./tokens.ts\";\nimport type { ColorMode, ResolvedThemeTokens, ThemeInfo } from \"./types.ts\";\n\nexport interface ThemeServiceOptions {\n\t/** Overrides the built-in and custom theme directories (tests). */\n\tdirs?: ThemeDiscoveryDirs;\n\t/** Initial theme name; defaults to terminal background detection (dark on failure). */\n\tinitialTheme?: string;\n\t/** Force a color mode instead of detecting terminal capabilities. */\n\tcolorMode?: ColorMode;\n\t/** Called after a successful setTheme with the resolved theme name (persistence hook). */\n\tonPersist?: (name: string) => void | Promise<void>;\n}\n\nexport interface ThemeSetResult {\n\tsuccess: boolean;\n\terror?: string;\n}\n\nexport interface ThemeService {\n\t/** Resolved active theme. */\n\treadonly current: Theme;\n\t/** Name the active theme was loaded under (\"<in-memory>\" for direct instances). */\n\treadonly currentThemeName: string | undefined;\n\tgetAllThemes(): Theme[];\n\tgetAvailableThemeInfos(): ThemeInfo[];\n\tgetTheme(name: string): Theme | undefined;\n\tsetTheme(theme: string | Theme): Promise<ThemeSetResult>;\n\t/** Flat CSS-hex token map for snapshots; defaults to the active theme. */\n\tresolveTokens(theme?: Theme): ResolvedThemeTokens;\n\t/** Themes registered by extensions/resource loading; they shadow custom-dir themes. */\n\tsetRegisteredThemes(themes: Theme[]): void;\n\tsubscribe(cb: (theme: Theme) => void): () => void;\n\t/** Hot-reload fs watcher for custom theme files — enabled ONLY by the rendering (TUI) process. */\n\tenableHotReload(): void;\n\tdispose(): void;\n}\n\nclass ThemeServiceImpl implements ThemeService {\n\tprivate readonly dirs: { themesDir: string; customThemesDir: string };\n\tprivate readonly colorMode: ColorMode | undefined;\n\tprivate readonly onPersist: ((name: string) => void | Promise<void>) | undefined;\n\tprivate readonly registeredThemes = new Map<string, Theme>();\n\tprivate readonly subscribers = new Set<(theme: Theme) => void>();\n\tprivate currentTheme: Theme;\n\tprivate currentName: string | undefined;\n\tprivate hotReloadEnabled = false;\n\tprivate watcher: fs.FSWatcher | undefined;\n\tprivate reloadTimer: NodeJS.Timeout | undefined;\n\tprivate disposed = false;\n\n\tconstructor(options: ThemeServiceOptions) {\n\t\tthis.dirs = {\n\t\t\tthemesDir: options.dirs?.themesDir ?? getThemesDir(),\n\t\t\tcustomThemesDir: options.dirs?.customThemesDir ?? getCustomThemesDir(),\n\t\t};\n\t\tthis.colorMode = options.colorMode;\n\t\tthis.onPersist = options.onPersist;\n\t\tconst name = options.initialTheme ?? getDefaultTheme();\n\t\tthis.currentName = name;\n\t\ttry {\n\t\t\tthis.currentTheme = this.load(name);\n\t\t} catch {\n\t\t\t// Theme is invalid - fall back to dark theme silently\n\t\t\tthis.currentName = \"dark\";\n\t\t\tthis.currentTheme = this.load(\"dark\");\n\t\t}\n\t}\n\n\tget current(): Theme {\n\t\treturn this.currentTheme;\n\t}\n\n\tget currentThemeName(): string | undefined {\n\t\treturn this.currentName;\n\t}\n\n\tprivate load(name: string): Theme {\n\t\treturn loadTheme(name, this.colorMode, this.registeredThemes, this.dirs);\n\t}\n\n\tgetAvailableThemeInfos(): ThemeInfo[] {\n\t\treturn getAvailableThemesWithPaths(this.registeredThemes, this.dirs);\n\t}\n\n\tgetAllThemes(): Theme[] {\n\t\tconst themes: Theme[] = [];\n\t\tfor (const info of this.getAvailableThemeInfos()) {\n\t\t\tconst theme = this.getTheme(info.name);\n\t\t\tif (theme) {\n\t\t\t\tthemes.push(theme);\n\t\t\t}\n\t\t}\n\t\treturn themes;\n\t}\n\n\tgetTheme(name: string): Theme | undefined {\n\t\ttry {\n\t\t\treturn this.load(name);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\tasync setTheme(theme: string | Theme): Promise<ThemeSetResult> {\n\t\tif (theme instanceof Theme) {\n\t\t\tthis.currentTheme = theme;\n\t\t\tthis.currentName = theme.name ?? \"<in-memory>\";\n\t\t\tthis.stopWatcher(); // Can't watch a direct instance\n\t\t\tthis.notify();\n\t\t\treturn { success: true };\n\t\t}\n\t\tthis.currentName = theme;\n\t\ttry {\n\t\t\tthis.currentTheme = this.load(theme);\n\t\t\tthis.restartWatcherIfEnabled();\n\t\t\tthis.notify();\n\t\t\tawait this.onPersist?.(theme);\n\t\t\treturn { success: true };\n\t\t} catch (error) {\n\t\t\t// Theme is invalid - fall back to dark theme\n\t\t\tthis.currentName = \"dark\";\n\t\t\tthis.currentTheme = this.load(\"dark\");\n\t\t\tthis.notify();\n\t\t\treturn {\n\t\t\t\tsuccess: false,\n\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t};\n\t\t}\n\t}\n\n\tresolveTokens(theme?: Theme): ResolvedThemeTokens {\n\t\tconst target = theme ?? this.currentTheme;\n\t\tconst name = theme === undefined ? this.currentName : theme.name;\n\t\tif (name && name !== \"<in-memory>\") {\n\t\t\ttry {\n\t\t\t\treturn getResolvedThemeColors(name, this.registeredThemes, this.dirs);\n\t\t\t} catch {\n\t\t\t\t// Fall through to instance-derived tokens for themes without a loadable source.\n\t\t\t}\n\t\t}\n\t\tconst defaultText = name === \"light\" ? \"#000000\" : \"#e5e5e7\";\n\t\tconst tokens: ResolvedThemeTokens = {};\n\t\tfor (const [key, value] of Object.entries(target.resolvedColors)) {\n\t\t\tif (typeof value === \"number\") {\n\t\t\t\ttokens[key] = ansi256ToHex(value);\n\t\t\t} else if (value === \"\") {\n\t\t\t\ttokens[key] = defaultText;\n\t\t\t} else {\n\t\t\t\ttokens[key] = value;\n\t\t\t}\n\t\t}\n\t\treturn tokens;\n\t}\n\n\tsetRegisteredThemes(themes: Theme[]): void {\n\t\tthis.registeredThemes.clear();\n\t\tfor (const theme of themes) {\n\t\t\tif (theme.name) {\n\t\t\t\tthis.registeredThemes.set(theme.name, theme);\n\t\t\t}\n\t\t}\n\t}\n\n\tsubscribe(cb: (theme: Theme) => void): () => void {\n\t\tthis.subscribers.add(cb);\n\t\treturn () => {\n\t\t\tthis.subscribers.delete(cb);\n\t\t};\n\t}\n\n\tenableHotReload(): void {\n\t\tthis.hotReloadEnabled = true;\n\t\tthis.restartWatcherIfEnabled();\n\t}\n\n\tdispose(): void {\n\t\tthis.disposed = true;\n\t\tthis.stopWatcher();\n\t\tthis.subscribers.clear();\n\t}\n\n\tprivate notify(): void {\n\t\tfor (const cb of Array.from(this.subscribers)) {\n\t\t\tcb(this.currentTheme);\n\t\t}\n\t}\n\n\tprivate restartWatcherIfEnabled(): void {\n\t\tthis.stopWatcher();\n\t\tif (!this.hotReloadEnabled || this.disposed) {\n\t\t\treturn;\n\t\t}\n\n\t\t// Only watch custom themes (not built-in)\n\t\tconst watchedThemeName = this.currentName;\n\t\tif (!watchedThemeName || watchedThemeName === \"dark\" || watchedThemeName === \"light\") {\n\t\t\treturn;\n\t\t}\n\n\t\tconst customThemesDir = this.dirs.customThemesDir;\n\t\tconst watchedFileName = `${watchedThemeName}.json`;\n\t\tconst themeFile = path.join(customThemesDir, watchedFileName);\n\n\t\t// Only watch if the file exists\n\t\tif (!fs.existsSync(themeFile)) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst scheduleReload = () => {\n\t\t\tif (this.reloadTimer) {\n\t\t\t\tclearTimeout(this.reloadTimer);\n\t\t\t}\n\t\t\tthis.reloadTimer = setTimeout(() => {\n\t\t\t\tthis.reloadTimer = undefined;\n\n\t\t\t\t// Ignore stale timers after switching themes or stopping the watcher\n\t\t\t\tif (this.currentName !== watchedThemeName) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\t// Keep the last successfully loaded theme active if the file is temporarily missing\n\t\t\t\tif (!fs.existsSync(themeFile)) {\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\ttry {\n\t\t\t\t\t// Reload the theme from disk and refresh the registry cache\n\t\t\t\t\tconst reloadedTheme = loadThemeFromPath(themeFile, this.colorMode);\n\t\t\t\t\tthis.registeredThemes.set(watchedThemeName, reloadedTheme);\n\t\t\t\t\tthis.currentTheme = reloadedTheme;\n\t\t\t\t\tthis.notify();\n\t\t\t\t} catch {\n\t\t\t\t\t// Ignore errors (file might be in invalid state while being edited)\n\t\t\t\t}\n\t\t\t}, 100);\n\t\t};\n\n\t\tthis.watcher =\n\t\t\twatchWithErrorHandler(\n\t\t\t\tcustomThemesDir,\n\t\t\t\t(_eventType, filename) => {\n\t\t\t\t\tif (this.currentName !== watchedThemeName) {\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tif (!filename) {\n\t\t\t\t\t\tscheduleReload();\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tif (filename !== watchedFileName) {\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\t\t\t\t\tscheduleReload();\n\t\t\t\t},\n\t\t\t\t() => {\n\t\t\t\t\tcloseWatcher(this.watcher);\n\t\t\t\t\tthis.watcher = undefined;\n\t\t\t\t},\n\t\t\t) ?? undefined;\n\t}\n\n\tprivate stopWatcher(): void {\n\t\tif (this.reloadTimer) {\n\t\t\tclearTimeout(this.reloadTimer);\n\t\t\tthis.reloadTimer = undefined;\n\t\t}\n\t\tcloseWatcher(this.watcher);\n\t\tthis.watcher = undefined;\n\t}\n}\n\nexport function createThemeService(options: ThemeServiceOptions = {}): ThemeService {\n\treturn new ThemeServiceImpl(options);\n}\n"]}