@google/gemini-cli 0.0.1

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

@@ -0,0 +1,262 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AyuDark } from './ayu.js';
+import { AyuLight } from './ayu-light.js';
+import { AtomOneDark } from './atom-one-dark.js';
+import { Dracula } from './dracula.js';
+import { GitHubDark } from './github-dark.js';
+import { GitHubLight } from './github-light.js';
+import { GoogleCode } from './googlecode.js';
+import { DefaultLight } from './default-light.js';
+import { DefaultDark } from './default.js';
+import { ShadesOfPurple } from './shades-of-purple.js';
+import { XCode } from './xcode.js';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { createCustomTheme, validateCustomTheme } from './theme.js';
+import { ANSI } from './ansi.js';
+import { ANSILight } from './ansi-light.js';
+import { NoColorTheme } from './no-color.js';
+import process from 'node:process';
+export const DEFAULT_THEME = DefaultDark;
+class ThemeManager {
+    availableThemes;
+    activeTheme;
+    customThemes = new Map();
+    constructor() {
+        this.availableThemes = [
+            AyuDark,
+            AyuLight,
+            AtomOneDark,
+            Dracula,
+            DefaultLight,
+            DefaultDark,
+            GitHubDark,
+            GitHubLight,
+            GoogleCode,
+            ShadesOfPurple,
+            XCode,
+            ANSI,
+            ANSILight,
+        ];
+        this.activeTheme = DEFAULT_THEME;
+    }
+    /**
+     * Loads custom themes from settings.
+     * @param customThemesSettings Custom themes from settings.
+     */
+    loadCustomThemes(customThemesSettings) {
+        this.customThemes.clear();
+        if (!customThemesSettings) {
+            return;
+        }
+        for (const [name, customThemeConfig] of Object.entries(customThemesSettings)) {
+            const validation = validateCustomTheme(customThemeConfig);
+            if (validation.isValid) {
+                if (validation.warning) {
+                    console.warn(`Theme "${name}": ${validation.warning}`);
+                }
+                const themeWithDefaults = {
+                    ...DEFAULT_THEME.colors,
+                    ...customThemeConfig,
+                    name: customThemeConfig.name || name,
+                    type: 'custom',
+                };
+                try {
+                    const theme = createCustomTheme(themeWithDefaults);
+                    this.customThemes.set(name, theme);
+                }
+                catch (error) {
+                    console.warn(`Failed to load custom theme "${name}":`, error);
+                }
+            }
+            else {
+                console.warn(`Invalid custom theme "${name}": ${validation.error}`);
+            }
+        }
+        // If the current active theme is a custom theme, keep it if still valid
+        if (this.activeTheme &&
+            this.activeTheme.type === 'custom' &&
+            this.customThemes.has(this.activeTheme.name)) {
+            this.activeTheme = this.customThemes.get(this.activeTheme.name);
+        }
+    }
+    /**
+     * Sets the active theme.
+     * @param themeName The name of the theme to set as active.
+     * @returns True if the theme was successfully set, false otherwise.
+     */
+    setActiveTheme(themeName) {
+        const theme = this.findThemeByName(themeName);
+        if (!theme) {
+            return false;
+        }
+        this.activeTheme = theme;
+        return true;
+    }
+    /**
+     * Gets the currently active theme.
+     * @returns The active theme.
+     */
+    getActiveTheme() {
+        if (process.env['NO_COLOR']) {
+            return NoColorTheme;
+        }
+        if (this.activeTheme) {
+            const isBuiltIn = this.availableThemes.some((t) => t.name === this.activeTheme.name);
+            const isCustom = [...this.customThemes.values()].includes(this.activeTheme);
+            if (isBuiltIn || isCustom) {
+                return this.activeTheme;
+            }
+        }
+        // Fallback to default if no active theme or if it's no longer valid.
+        this.activeTheme = DEFAULT_THEME;
+        return this.activeTheme;
+    }
+    /**
+     * Gets the semantic colors for the active theme.
+     * @returns The semantic colors.
+     */
+    getSemanticColors() {
+        return this.getActiveTheme().semanticColors;
+    }
+    /**
+     * Gets a list of custom theme names.
+     * @returns Array of custom theme names.
+     */
+    getCustomThemeNames() {
+        return Array.from(this.customThemes.keys());
+    }
+    /**
+     * Checks if a theme name is a custom theme.
+     * @param themeName The theme name to check.
+     * @returns True if the theme is custom.
+     */
+    isCustomTheme(themeName) {
+        return this.customThemes.has(themeName);
+    }
+    /**
+     * Returns a list of available theme names.
+     */
+    getAvailableThemes() {
+        const builtInThemes = this.availableThemes.map((theme) => ({
+            name: theme.name,
+            type: theme.type,
+            isCustom: false,
+        }));
+        const customThemes = Array.from(this.customThemes.values()).map((theme) => ({
+            name: theme.name,
+            type: theme.type,
+            isCustom: true,
+        }));
+        const allThemes = [...builtInThemes, ...customThemes];
+        const sortedThemes = allThemes.sort((a, b) => {
+            const typeOrder = (type) => {
+                switch (type) {
+                    case 'dark':
+                        return 1;
+                    case 'light':
+                        return 2;
+                    case 'ansi':
+                        return 3;
+                    case 'custom':
+                        return 4; // Custom themes at the end
+                    default:
+                        return 5;
+                }
+            };
+            const typeComparison = typeOrder(a.type) - typeOrder(b.type);
+            if (typeComparison !== 0) {
+                return typeComparison;
+            }
+            return a.name.localeCompare(b.name);
+        });
+        return sortedThemes;
+    }
+    /**
+     * Gets a theme by name.
+     * @param themeName The name of the theme to get.
+     * @returns The theme if found, undefined otherwise.
+     */
+    getTheme(themeName) {
+        return this.findThemeByName(themeName);
+    }
+    isPath(themeName) {
+        return (themeName.endsWith('.json') ||
+            themeName.startsWith('.') ||
+            path.isAbsolute(themeName));
+    }
+    loadThemeFromFile(themePath) {
+        try {
+            // realpathSync resolves the path and throws if it doesn't exist.
+            const canonicalPath = fs.realpathSync(path.resolve(themePath));
+            // 1. Check cache using the canonical path.
+            if (this.customThemes.has(canonicalPath)) {
+                return this.customThemes.get(canonicalPath);
+            }
+            // 2. Perform security check.
+            const homeDir = path.resolve(os.homedir());
+            if (!canonicalPath.startsWith(homeDir)) {
+                console.warn(`Theme file at "${themePath}" is outside your home directory. ` +
+                    `Only load themes from trusted sources.`);
+                return undefined;
+            }
+            // 3. Read, parse, and validate the theme file.
+            const themeContent = fs.readFileSync(canonicalPath, 'utf-8');
+            const customThemeConfig = JSON.parse(themeContent);
+            const validation = validateCustomTheme(customThemeConfig);
+            if (!validation.isValid) {
+                console.warn(`Invalid custom theme from file "${themePath}": ${validation.error}`);
+                return undefined;
+            }
+            if (validation.warning) {
+                console.warn(`Theme from "${themePath}": ${validation.warning}`);
+            }
+            // 4. Create and cache the theme.
+            const themeWithDefaults = {
+                ...DEFAULT_THEME.colors,
+                ...customThemeConfig,
+                name: customThemeConfig.name || canonicalPath,
+                type: 'custom',
+            };
+            const theme = createCustomTheme(themeWithDefaults);
+            this.customThemes.set(canonicalPath, theme); // Cache by canonical path
+            return theme;
+        }
+        catch (error) {
+            // Any error in the process (file not found, bad JSON, etc.) is caught here.
+            // We can return undefined silently for file-not-found, and warn for others.
+            if (!(error instanceof Error && 'code' in error && error.code === 'ENOENT')) {
+                console.warn(`Could not load theme from file "${themePath}":`, error);
+            }
+            return undefined;
+        }
+    }
+    findThemeByName(themeName) {
+        if (!themeName) {
+            return DEFAULT_THEME;
+        }
+        // First check built-in themes
+        const builtInTheme = this.availableThemes.find((theme) => theme.name === themeName);
+        if (builtInTheme) {
+            return builtInTheme;
+        }
+        // Then check custom themes that have been loaded from settings, or file paths
+        if (this.isPath(themeName)) {
+            return this.loadThemeFromFile(themeName);
+        }
+        if (this.customThemes.has(themeName)) {
+            return this.customThemes.get(themeName);
+        }
+        // If it's not a built-in, not in cache, and not a valid file path,
+        // it's not a valid theme.
+        return undefined;
+    }
+}
+// Export an instance of the ThemeManager
+export const themeManager = new ThemeManager();
+//# sourceMappingURL=theme-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme-manager.js","sourceRoot":"","sources":["../../../../src/ui/themes/theme-manager.ts"],"names":[],"mappings":"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"}

package/dist/src/ui/themes/theme-manager.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

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

@@ -0,0 +1,142 @@
+/**
+ * @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';
+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(console, '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;AAG9B,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,OAAO,EAAE,MAAM,CAAC;iBACtB,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,130 @@
+/**
+ * @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;
+    GradientColors?: string[];
+}
+export interface CustomTheme {
+    type: 'custom';
+    name: string;
+    text?: {
+        primary?: string;
+        secondary?: string;
+        link?: string;
+        accent?: 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;
+    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;
+};