@zgsm/costrict-cli 0.0.1

package/dist/src/ui/themes/theme-manager.test.js

@@ -0,0 +1,143 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+// Patch: Unset NO_COLOR at the very top before any imports
+if (process.env['NO_COLOR'] !== undefined) {
+    delete process.env['NO_COLOR'];
+}
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { themeManager, DEFAULT_THEME } from './theme-manager.js';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import { debugLogger } from '@google/gemini-cli-core';
+vi.mock('node:fs');
+vi.mock('node:os', async (importOriginal) => {
+    const actualOs = await importOriginal();
+    return {
+        ...actualOs,
+        homedir: vi.fn(),
+        platform: vi.fn(() => 'linux'),
+    };
+});
+const validCustomTheme = {
+    type: 'custom',
+    name: 'MyCustomTheme',
+    Background: '#000000',
+    Foreground: '#ffffff',
+    LightBlue: '#89BDCD',
+    AccentBlue: '#3B82F6',
+    AccentPurple: '#8B5CF6',
+    AccentCyan: '#06B6D4',
+    AccentGreen: '#3CA84B',
+    AccentYellow: 'yellow',
+    AccentRed: 'red',
+    DiffAdded: 'green',
+    DiffRemoved: 'red',
+    Comment: 'gray',
+    Gray: 'gray',
+};
+describe('ThemeManager', () => {
+    beforeEach(() => {
+        // Reset themeManager state
+        themeManager.loadCustomThemes({});
+        themeManager.setActiveTheme(DEFAULT_THEME.name);
+    });
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('should load valid custom themes', () => {
+        themeManager.loadCustomThemes({ MyCustomTheme: validCustomTheme });
+        expect(themeManager.getCustomThemeNames()).toContain('MyCustomTheme');
+        expect(themeManager.isCustomTheme('MyCustomTheme')).toBe(true);
+    });
+    it('should set and get the active theme', () => {
+        expect(themeManager.getActiveTheme().name).toBe(DEFAULT_THEME.name);
+        themeManager.setActiveTheme('Ayu');
+        expect(themeManager.getActiveTheme().name).toBe('Ayu');
+    });
+    it('should set and get a custom active theme', () => {
+        themeManager.loadCustomThemes({ MyCustomTheme: validCustomTheme });
+        themeManager.setActiveTheme('MyCustomTheme');
+        expect(themeManager.getActiveTheme().name).toBe('MyCustomTheme');
+    });
+    it('should return false when setting a non-existent theme', () => {
+        expect(themeManager.setActiveTheme('NonExistentTheme')).toBe(false);
+        expect(themeManager.getActiveTheme().name).toBe(DEFAULT_THEME.name);
+    });
+    it('should list available themes including custom themes', () => {
+        themeManager.loadCustomThemes({ MyCustomTheme: validCustomTheme });
+        const available = themeManager.getAvailableThemes();
+        expect(available.some((t) => t.name === 'MyCustomTheme' && t.isCustom)).toBe(true);
+    });
+    it('should get a theme by name', () => {
+        expect(themeManager.getTheme('Ayu')).toBeDefined();
+        themeManager.loadCustomThemes({ MyCustomTheme: validCustomTheme });
+        expect(themeManager.getTheme('MyCustomTheme')).toBeDefined();
+    });
+    it('should fall back to default theme if active theme is invalid', () => {
+        themeManager.activeTheme = {
+            name: 'NonExistent',
+            type: 'custom',
+        };
+        expect(themeManager.getActiveTheme().name).toBe(DEFAULT_THEME.name);
+    });
+    it('should return NoColorTheme if NO_COLOR is set', () => {
+        const original = process.env['NO_COLOR'];
+        process.env['NO_COLOR'] = '1';
+        expect(themeManager.getActiveTheme().name).toBe('NoColor');
+        if (original === undefined) {
+            delete process.env['NO_COLOR'];
+        }
+        else {
+            process.env['NO_COLOR'] = original;
+        }
+    });
+    describe('when loading a theme from a file', () => {
+        const mockThemePath = './my-theme.json';
+        const mockTheme = {
+            ...validCustomTheme,
+            name: 'My File Theme',
+        };
+        beforeEach(() => {
+            vi.mocked(os.homedir).mockReturnValue('/home/user');
+            vi.spyOn(fs, 'realpathSync').mockImplementation((p) => p);
+        });
+        it('should load a theme from a valid file path', () => {
+            vi.spyOn(fs, 'existsSync').mockReturnValue(true);
+            vi.spyOn(fs, 'readFileSync').mockReturnValue(JSON.stringify(mockTheme));
+            const result = themeManager.setActiveTheme('/home/user/my-theme.json');
+            expect(result).toBe(true);
+            const activeTheme = themeManager.getActiveTheme();
+            expect(activeTheme.name).toBe('My File Theme');
+            expect(fs.readFileSync).toHaveBeenCalledWith(expect.stringContaining('my-theme.json'), 'utf-8');
+        });
+        it('should not load a theme if the file does not exist', () => {
+            vi.spyOn(fs, 'existsSync').mockReturnValue(false);
+            const result = themeManager.setActiveTheme(mockThemePath);
+            expect(result).toBe(false);
+            expect(themeManager.getActiveTheme().name).toBe(DEFAULT_THEME.name);
+        });
+        it('should not load a theme from a file with invalid JSON', () => {
+            vi.spyOn(fs, 'existsSync').mockReturnValue(true);
+            vi.spyOn(fs, 'readFileSync').mockReturnValue('invalid json');
+            const result = themeManager.setActiveTheme(mockThemePath);
+            expect(result).toBe(false);
+            expect(themeManager.getActiveTheme().name).toBe(DEFAULT_THEME.name);
+        });
+        it('should not load a theme from an untrusted file path and log a message', () => {
+            vi.spyOn(fs, 'existsSync').mockReturnValue(true);
+            vi.spyOn(fs, 'readFileSync').mockReturnValue(JSON.stringify(mockTheme));
+            const consoleWarnSpy = vi
+                .spyOn(debugLogger, 'warn')
+                .mockImplementation(() => { });
+            const result = themeManager.setActiveTheme('/untrusted/my-theme.json');
+            expect(result).toBe(false);
+            expect(themeManager.getActiveTheme().name).toBe(DEFAULT_THEME.name);
+            expect(consoleWarnSpy).toHaveBeenCalledWith(expect.stringContaining('is outside your home directory'));
+            consoleWarnSpy.mockRestore();
+        });
+    });
+});
+//# sourceMappingURL=theme-manager.test.js.map

package/dist/src/ui/themes/theme-manager.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-manager.test.js","sourceRoot":"","sources":["../../../../src/ui/themes/theme-manager.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2DAA2D;AAC3D,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,SAAS,EAAE,CAAC;IAC1C,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC;AAED,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEjE,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACnB,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;IAC1C,MAAM,QAAQ,GAAG,MAAM,cAAc,EAAmB,CAAC;IACzD,OAAO;QACL,GAAG,QAAQ;QACX,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;QAChB,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC;KAC/B,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAgB;IACpC,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,eAAe;IACrB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,SAAS;IACrB,YAAY,EAAE,SAAS;IACvB,UAAU,EAAE,SAAS;IACrB,WAAW,EAAE,SAAS;IACtB,YAAY,EAAE,QAAQ;IACtB,SAAS,EAAE,KAAK;IAChB,SAAS,EAAE,OAAO;IAClB,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,UAAU,CAAC,GAAG,EAAE;QACd,2BAA2B;QAC3B,YAAY,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAClC,YAAY,CAAC,cAAc,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,YAAY,CAAC,gBAAgB,CAAC,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,YAAY,CAAC,mBAAmB,EAAE,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACtE,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACpE,YAAY,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACnC,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,YAAY,CAAC,gBAAgB,CAAC,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACnE,YAAY,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QAC7C,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,YAAY,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpE,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;QAC9D,YAAY,CAAC,gBAAgB,CAAC,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACnE,MAAM,SAAS,GAAG,YAAY,CAAC,kBAAkB,EAAE,CAAC;QACpD,MAAM,CACJ,SAAS,CAAC,IAAI,CACZ,CAAC,CAAuC,EAAE,EAAE,CAC1C,CAAC,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,CAAC,QAAQ,CAC3C,CACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACnD,YAAY,CAAC,gBAAgB,CAAC,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8DAA8D,EAAE,GAAG,EAAE;QACrE,YAAoD,CAAC,WAAW,GAAG;YAClE,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,QAAQ;SACf,CAAC;QACF,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC;QAC9B,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,QAAQ,CAAC;QACrC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAChD,MAAM,aAAa,GAAG,iBAAiB,CAAC;QACxC,MAAM,SAAS,GAAgB;YAC7B,GAAG,gBAAgB;YACnB,IAAI,EAAE,eAAe;SACtB,CAAC;QAEF,UAAU,CAAC,GAAG,EAAE;YACd,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;YACpD,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAW,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACjD,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;YAExE,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,0BAA0B,CAAC,CAAC;YAEvE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,MAAM,WAAW,GAAG,YAAY,CAAC,cAAc,EAAE,CAAC;YAClD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YAC/C,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,oBAAoB,CAC1C,MAAM,CAAC,gBAAgB,CAAC,eAAe,CAAC,EACxC,OAAO,CACR,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC5D,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAElD,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;YAE1D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC/D,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACjD,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;YAE7D,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;YAE1D,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uEAAuE,EAAE,GAAG,EAAE;YAC/E,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,YAAY,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YACjD,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;YACxE,MAAM,cAAc,GAAG,EAAE;iBACtB,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC;iBAC1B,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEhC,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,0BAA0B,CAAC,CAAC;YAEvE,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3B,MAAM,CAAC,YAAY,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YACpE,MAAM,CAAC,cAAc,CAAC,CAAC,oBAAoB,CACzC,MAAM,CAAC,gBAAgB,CAAC,gCAAgC,CAAC,CAC1D,CAAC;YAEF,cAAc,CAAC,WAAW,EAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/ui/themes/theme.d.ts

@@ -0,0 +1,133 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { CSSProperties } from 'react';
+import type { SemanticColors } from './semantic-tokens.js';
+export type ThemeType = 'light' | 'dark' | 'ansi' | 'custom';
+export interface ColorsTheme {
+    type: ThemeType;
+    Background: string;
+    Foreground: string;
+    LightBlue: string;
+    AccentBlue: string;
+    AccentPurple: string;
+    AccentCyan: string;
+    AccentGreen: string;
+    AccentYellow: string;
+    AccentRed: string;
+    DiffAdded: string;
+    DiffRemoved: string;
+    Comment: string;
+    Gray: string;
+    DarkGray: string;
+    GradientColors?: string[];
+}
+export interface CustomTheme {
+    type: 'custom';
+    name: string;
+    text?: {
+        primary?: string;
+        secondary?: string;
+        link?: string;
+        accent?: string;
+        response?: string;
+    };
+    background?: {
+        primary?: string;
+        diff?: {
+            added?: string;
+            removed?: string;
+        };
+    };
+    border?: {
+        default?: string;
+        focused?: string;
+    };
+    ui?: {
+        comment?: string;
+        symbol?: string;
+        gradient?: string[];
+    };
+    status?: {
+        error?: string;
+        success?: string;
+        warning?: string;
+    };
+    Background?: string;
+    Foreground?: string;
+    LightBlue?: string;
+    AccentBlue?: string;
+    AccentPurple?: string;
+    AccentCyan?: string;
+    AccentGreen?: string;
+    AccentYellow?: string;
+    AccentRed?: string;
+    DiffAdded?: string;
+    DiffRemoved?: string;
+    Comment?: string;
+    Gray?: string;
+    DarkGray?: string;
+    GradientColors?: string[];
+}
+export declare const lightTheme: ColorsTheme;
+export declare const darkTheme: ColorsTheme;
+export declare const ansiTheme: ColorsTheme;
+export declare class Theme {
+    readonly name: string;
+    readonly type: ThemeType;
+    readonly colors: ColorsTheme;
+    /**
+     * The default foreground color for text when no specific highlight rule applies.
+     * This is an Ink-compatible color string (hex or name).
+     */
+    readonly defaultColor: string;
+    /**
+     * Stores the mapping from highlight.js class names (e.g., 'hljs-keyword')
+     * to Ink-compatible color strings (hex or name).
+     */
+    protected readonly _colorMap: Readonly<Record<string, string>>;
+    readonly semanticColors: SemanticColors;
+    /**
+     * Creates a new Theme instance.
+     * @param name The name of the theme.
+     * @param rawMappings The raw CSSProperties mappings from a react-syntax-highlighter theme object.
+     */
+    constructor(name: string, type: ThemeType, rawMappings: Record<string, CSSProperties>, colors: ColorsTheme, semanticColors?: SemanticColors);
+    /**
+     * Gets the Ink-compatible color string for a given highlight.js class name.
+     * @param hljsClass The highlight.js class name (e.g., 'hljs-keyword', 'hljs-string').
+     * @returns The corresponding Ink color string (hex or name) if it exists.
+     */
+    getInkColor(hljsClass: string): string | undefined;
+    /**
+     * Resolves a CSS color value (name or hex) into an Ink-compatible color string.
+     * @param colorValue The raw color string (e.g., 'blue', '#ff0000', 'darkkhaki').
+     * @returns An Ink-compatible color string (hex or name), or undefined if not resolvable.
+     */
+    private static _resolveColor;
+    /**
+     * Builds the internal map from highlight.js class names to Ink-compatible color strings.
+     * This method is protected and primarily intended for use by the constructor.
+     * @param hljsTheme The raw CSSProperties mappings from a react-syntax-highlighter theme object.
+     * @returns An Ink-compatible theme map (Record<string, string>).
+     */
+    protected _buildColorMap(hljsTheme: Record<string, CSSProperties>): Record<string, string>;
+}
+/**
+ * Creates a Theme instance from a custom theme configuration.
+ * @param customTheme The custom theme configuration.
+ * @returns A new Theme instance.
+ */
+export declare function createCustomTheme(customTheme: CustomTheme): Theme;
+/**
+ * Validates a custom theme configuration.
+ * @param customTheme The custom theme to validate.
+ * @returns An object with isValid boolean and error message if invalid.
+ */
+export declare function validateCustomTheme(customTheme: Partial<CustomTheme>): {
+    isValid: boolean;
+    error?: string;
+    warning?: string;
+};

package/dist/src/ui/themes/theme.js

@@ -0,0 +1,390 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { resolveColor, interpolateColor } from './color-utils.js';
+export const lightTheme = {
+    type: 'light',
+    Background: '#FAFAFA',
+    Foreground: '#383A42',
+    LightBlue: '#89BDCD',
+    AccentBlue: '#3B82F6',
+    AccentPurple: '#8B5CF6',
+    AccentCyan: '#06B6D4',
+    AccentGreen: '#3CA84B',
+    AccentYellow: '#D5A40A',
+    AccentRed: '#DD4C4C',
+    DiffAdded: '#C6EAD8',
+    DiffRemoved: '#FFCCCC',
+    Comment: '#008000',
+    Gray: '#97a0b0',
+    DarkGray: interpolateColor('#97a0b0', '#FAFAFA', 0.5),
+    GradientColors: ['#4796E4', '#847ACE', '#C3677F'],
+};
+export const darkTheme = {
+    type: 'dark',
+    Background: '#1E1E2E',
+    Foreground: '#CDD6F4',
+    LightBlue: '#ADD8E6',
+    AccentBlue: '#89B4FA',
+    AccentPurple: '#CBA6F7',
+    AccentCyan: '#89DCEB',
+    AccentGreen: '#A6E3A1',
+    AccentYellow: '#F9E2AF',
+    AccentRed: '#F38BA8',
+    DiffAdded: '#28350B',
+    DiffRemoved: '#430000',
+    Comment: '#6C7086',
+    Gray: '#6C7086',
+    DarkGray: interpolateColor('#6C7086', '#1E1E2E', 0.5),
+    GradientColors: ['#4796E4', '#847ACE', '#C3677F'],
+};
+export const ansiTheme = {
+    type: 'ansi',
+    Background: 'black',
+    Foreground: 'white',
+    LightBlue: 'blue',
+    AccentBlue: 'blue',
+    AccentPurple: 'magenta',
+    AccentCyan: 'cyan',
+    AccentGreen: 'green',
+    AccentYellow: 'yellow',
+    AccentRed: 'red',
+    DiffAdded: 'green',
+    DiffRemoved: 'red',
+    Comment: 'gray',
+    Gray: 'gray',
+    DarkGray: 'gray',
+};
+export class Theme {
+    name;
+    type;
+    colors;
+    /**
+     * The default foreground color for text when no specific highlight rule applies.
+     * This is an Ink-compatible color string (hex or name).
+     */
+    defaultColor;
+    /**
+     * Stores the mapping from highlight.js class names (e.g., 'hljs-keyword')
+     * to Ink-compatible color strings (hex or name).
+     */
+    _colorMap;
+    semanticColors;
+    /**
+     * Creates a new Theme instance.
+     * @param name The name of the theme.
+     * @param rawMappings The raw CSSProperties mappings from a react-syntax-highlighter theme object.
+     */
+    constructor(name, type, rawMappings, colors, semanticColors) {
+        this.name = name;
+        this.type = type;
+        this.colors = colors;
+        this.semanticColors = semanticColors ?? {
+            text: {
+                primary: this.colors.Foreground,
+                secondary: this.colors.Gray,
+                link: this.colors.AccentBlue,
+                accent: this.colors.AccentPurple,
+                response: this.colors.Foreground,
+            },
+            background: {
+                primary: this.colors.Background,
+                diff: {
+                    added: this.colors.DiffAdded,
+                    removed: this.colors.DiffRemoved,
+                },
+            },
+            border: {
+                default: this.colors.Gray,
+                focused: this.colors.AccentBlue,
+            },
+            ui: {
+                comment: this.colors.Gray,
+                symbol: this.colors.AccentCyan,
+                dark: this.colors.DarkGray,
+                gradient: this.colors.GradientColors,
+            },
+            status: {
+                error: this.colors.AccentRed,
+                success: this.colors.AccentGreen,
+                warning: this.colors.AccentYellow,
+            },
+        };
+        this._colorMap = Object.freeze(this._buildColorMap(rawMappings)); // Build and freeze the map
+        // Determine the default foreground color
+        const rawDefaultColor = rawMappings['hljs']?.color;
+        this.defaultColor =
+            (rawDefaultColor ? Theme._resolveColor(rawDefaultColor) : undefined) ??
+                ''; // Default to empty string if not found or resolvable
+    }
+    /**
+     * Gets the Ink-compatible color string for a given highlight.js class name.
+     * @param hljsClass The highlight.js class name (e.g., 'hljs-keyword', 'hljs-string').
+     * @returns The corresponding Ink color string (hex or name) if it exists.
+     */
+    getInkColor(hljsClass) {
+        return this._colorMap[hljsClass];
+    }
+    /**
+     * Resolves a CSS color value (name or hex) into an Ink-compatible color string.
+     * @param colorValue The raw color string (e.g., 'blue', '#ff0000', 'darkkhaki').
+     * @returns An Ink-compatible color string (hex or name), or undefined if not resolvable.
+     */
+    static _resolveColor(colorValue) {
+        return resolveColor(colorValue);
+    }
+    /**
+     * Builds the internal map from highlight.js class names to Ink-compatible color strings.
+     * This method is protected and primarily intended for use by the constructor.
+     * @param hljsTheme The raw CSSProperties mappings from a react-syntax-highlighter theme object.
+     * @returns An Ink-compatible theme map (Record<string, string>).
+     */
+    _buildColorMap(hljsTheme) {
+        const inkTheme = {};
+        for (const key in hljsTheme) {
+            // Ensure the key starts with 'hljs-' or is 'hljs' for the base style
+            if (!key.startsWith('hljs-') && key !== 'hljs') {
+                continue; // Skip keys not related to highlighting classes
+            }
+            const style = hljsTheme[key];
+            if (style?.color) {
+                const resolvedColor = Theme._resolveColor(style.color);
+                if (resolvedColor !== undefined) {
+                    // Use the original key from the hljsTheme (e.g., 'hljs-keyword')
+                    inkTheme[key] = resolvedColor;
+                }
+                // If color is not resolvable, it's omitted from the map,
+                // this enables falling back to the default foreground color.
+            }
+            // We currently only care about the 'color' property for Ink rendering.
+            // Other properties like background, fontStyle, etc., are ignored.
+        }
+        return inkTheme;
+    }
+}
+/**
+ * Creates a Theme instance from a custom theme configuration.
+ * @param customTheme The custom theme configuration.
+ * @returns A new Theme instance.
+ */
+export function createCustomTheme(customTheme) {
+    const colors = {
+        type: 'custom',
+        Background: customTheme.background?.primary ?? customTheme.Background ?? '',
+        Foreground: customTheme.text?.primary ?? customTheme.Foreground ?? '',
+        LightBlue: customTheme.text?.link ?? customTheme.LightBlue ?? '',
+        AccentBlue: customTheme.text?.link ?? customTheme.AccentBlue ?? '',
+        AccentPurple: customTheme.text?.accent ?? customTheme.AccentPurple ?? '',
+        AccentCyan: customTheme.text?.link ?? customTheme.AccentCyan ?? '',
+        AccentGreen: customTheme.status?.success ?? customTheme.AccentGreen ?? '',
+        AccentYellow: customTheme.status?.warning ?? customTheme.AccentYellow ?? '',
+        AccentRed: customTheme.status?.error ?? customTheme.AccentRed ?? '',
+        DiffAdded: customTheme.background?.diff?.added ?? customTheme.DiffAdded ?? '',
+        DiffRemoved: customTheme.background?.diff?.removed ?? customTheme.DiffRemoved ?? '',
+        Comment: customTheme.ui?.comment ?? customTheme.Comment ?? '',
+        Gray: customTheme.text?.secondary ?? customTheme.Gray ?? '',
+        DarkGray: customTheme.DarkGray ??
+            interpolateColor(customTheme.text?.secondary ?? customTheme.Gray ?? '', customTheme.background?.primary ?? customTheme.Background ?? '', 0.5),
+        GradientColors: customTheme.ui?.gradient ?? customTheme.GradientColors,
+    };
+    // Generate CSS properties mappings based on the custom theme colors
+    const rawMappings = {
+        hljs: {
+            display: 'block',
+            overflowX: 'auto',
+            padding: '0.5em',
+            background: colors.Background,
+            color: colors.Foreground,
+        },
+        'hljs-keyword': {
+            color: colors.AccentBlue,
+        },
+        'hljs-literal': {
+            color: colors.AccentBlue,
+        },
+        'hljs-symbol': {
+            color: colors.AccentBlue,
+        },
+        'hljs-name': {
+            color: colors.AccentBlue,
+        },
+        'hljs-link': {
+            color: colors.AccentBlue,
+            textDecoration: 'underline',
+        },
+        'hljs-built_in': {
+            color: colors.AccentCyan,
+        },
+        'hljs-type': {
+            color: colors.AccentCyan,
+        },
+        'hljs-number': {
+            color: colors.AccentGreen,
+        },
+        'hljs-class': {
+            color: colors.AccentGreen,
+        },
+        'hljs-string': {
+            color: colors.AccentYellow,
+        },
+        'hljs-meta-string': {
+            color: colors.AccentYellow,
+        },
+        'hljs-regexp': {
+            color: colors.AccentRed,
+        },
+        'hljs-template-tag': {
+            color: colors.AccentRed,
+        },
+        'hljs-subst': {
+            color: colors.Foreground,
+        },
+        'hljs-function': {
+            color: colors.Foreground,
+        },
+        'hljs-title': {
+            color: colors.Foreground,
+        },
+        'hljs-params': {
+            color: colors.Foreground,
+        },
+        'hljs-formula': {
+            color: colors.Foreground,
+        },
+        'hljs-comment': {
+            color: colors.Comment,
+            fontStyle: 'italic',
+        },
+        'hljs-quote': {
+            color: colors.Comment,
+            fontStyle: 'italic',
+        },
+        'hljs-doctag': {
+            color: colors.Comment,
+        },
+        'hljs-meta': {
+            color: colors.Gray,
+        },
+        'hljs-meta-keyword': {
+            color: colors.Gray,
+        },
+        'hljs-tag': {
+            color: colors.Gray,
+        },
+        'hljs-variable': {
+            color: colors.AccentPurple,
+        },
+        'hljs-template-variable': {
+            color: colors.AccentPurple,
+        },
+        'hljs-attr': {
+            color: colors.LightBlue,
+        },
+        'hljs-attribute': {
+            color: colors.LightBlue,
+        },
+        'hljs-builtin-name': {
+            color: colors.LightBlue,
+        },
+        'hljs-section': {
+            color: colors.AccentYellow,
+        },
+        'hljs-emphasis': {
+            fontStyle: 'italic',
+        },
+        'hljs-strong': {
+            fontWeight: 'bold',
+        },
+        'hljs-bullet': {
+            color: colors.AccentYellow,
+        },
+        'hljs-selector-tag': {
+            color: colors.AccentYellow,
+        },
+        'hljs-selector-id': {
+            color: colors.AccentYellow,
+        },
+        'hljs-selector-class': {
+            color: colors.AccentYellow,
+        },
+        'hljs-selector-attr': {
+            color: colors.AccentYellow,
+        },
+        'hljs-selector-pseudo': {
+            color: colors.AccentYellow,
+        },
+        'hljs-addition': {
+            backgroundColor: colors.AccentGreen,
+            display: 'inline-block',
+            width: '100%',
+        },
+        'hljs-deletion': {
+            backgroundColor: colors.AccentRed,
+            display: 'inline-block',
+            width: '100%',
+        },
+    };
+    const semanticColors = {
+        text: {
+            primary: customTheme.text?.primary ?? colors.Foreground,
+            secondary: customTheme.text?.secondary ?? colors.Gray,
+            link: customTheme.text?.link ?? colors.AccentBlue,
+            accent: customTheme.text?.accent ?? colors.AccentPurple,
+            response: customTheme.text?.response ??
+                customTheme.text?.primary ??
+                colors.Foreground,
+        },
+        background: {
+            primary: customTheme.background?.primary ?? colors.Background,
+            diff: {
+                added: customTheme.background?.diff?.added ?? colors.DiffAdded,
+                removed: customTheme.background?.diff?.removed ?? colors.DiffRemoved,
+            },
+        },
+        border: {
+            default: customTheme.border?.default ?? colors.Gray,
+            focused: customTheme.border?.focused ?? colors.AccentBlue,
+        },
+        ui: {
+            comment: customTheme.ui?.comment ?? colors.Comment,
+            symbol: customTheme.ui?.symbol ?? colors.Gray,
+            dark: colors.DarkGray,
+            gradient: customTheme.ui?.gradient ?? colors.GradientColors,
+        },
+        status: {
+            error: customTheme.status?.error ?? colors.AccentRed,
+            success: customTheme.status?.success ?? colors.AccentGreen,
+            warning: customTheme.status?.warning ?? colors.AccentYellow,
+        },
+    };
+    return new Theme(customTheme.name, 'custom', rawMappings, colors, semanticColors);
+}
+/**
+ * Validates a custom theme configuration.
+ * @param customTheme The custom theme to validate.
+ * @returns An object with isValid boolean and error message if invalid.
+ */
+export function validateCustomTheme(customTheme) {
+    // Since all fields are optional, we only need to validate the name.
+    if (customTheme.name && !isValidThemeName(customTheme.name)) {
+        return {
+            isValid: false,
+            error: `Invalid theme name: ${customTheme.name}`,
+        };
+    }
+    return {
+        isValid: true,
+    };
+}
+/**
+ * Checks if a theme name is valid.
+ * @param name The theme name to validate.
+ * @returns True if the theme name is valid.
+ */
+function isValidThemeName(name) {
+    // Theme name should be non-empty and not contain invalid characters
+    return name.trim().length > 0 && name.trim().length <= 50;
+}
+//# sourceMappingURL=theme.js.map