@earendil-works/pi-coding-agent/dist/modes/interactive/theme/theme-schema.js

Coding agent CLI with read, bash, edit, write tools and session management

/**
 * Theme JSON validation, kept out of `theme.ts` on purpose.
 *
 * Validating user-authored theme files needs typebox, which costs ~17 MB of module graph to import.
 * Palette lookup does not, so a presentation that only uses built-in themes should never pay for it.
 * `main.ts` installs this validator before runtime resource loading; other consumers can opt in with
 * `setThemeJsonValidator()`. Built-in themes do not need validation.
 */
import { Type } from "typebox";
import { Compile } from "typebox/compile";
import { THEME_TOKENS } from "./theme-tokens.js";
function colorValue(description) {
    return Type.Union([
        Type.String({
            description: "Hex color (#RGB or #RRGGBB), OKLCH or OKHSL color, variable reference, or empty string for terminal default",
        }),
        Type.Integer({
            minimum: 0,
            maximum: 255,
            description: "256-color palette index (0-255)",
        }),
    ], description ? { description } : {});
}
export const ColorValueSchema = colorValue();
function themeTokenProperties(tokens) {
    const properties = {};
    for (const [name, descriptor] of Object.entries(tokens)) {
        const schema = colorValue(descriptor.description);
        properties[name] = descriptor.fallback === undefined ? schema : Type.Optional(schema);
    }
    return properties;
}
const ThemeColorsSchema = Type.Unsafe(Type.Object(themeTokenProperties(THEME_TOKENS), {
    description: "Theme color definitions (scrollbar, thinkingMax, and search highlight colors are optional and use compatible fallbacks)",
    additionalProperties: false,
}));
export const ThemeJsonSchema = Type.Object({
    $schema: Type.Optional(Type.String({ description: "JSON schema reference" })),
    name: Type.String({
        pattern: "^[^/]+$",
        description: "Theme name. Must not contain '/' because it is reserved for automatic light/dark theme settings.",
    }),
    appearance: Type.Optional(Type.Union([Type.Literal("dark"), Type.Literal("light")], {
        description: "Background the theme is designed for. Detected from the theme colors when omitted.",
    })),
    vars: Type.Optional(Type.Record(Type.String(), ColorValueSchema, {
        description: "Reusable color variables",
    })),
    colors: ThemeColorsSchema,
    export: Type.Optional(Type.Object({
        pageBg: Type.Optional(colorValue("Page background color")),
        cardBg: Type.Optional(colorValue("Card/container background color")),
        infoBg: Type.Optional(colorValue("Info sections background (system prompt, notices)")),
    }, {
        description: "Optional colors for HTML export (defaults derived from userMessageBg if not specified)",
        additionalProperties: false,
    })),
}, {
    title: "Pi Coding Agent Theme",
    description: "Theme schema for Pi coding agent",
    additionalProperties: false,
});
const compiledThemeSchema = Compile(ThemeJsonSchema);
/** Validate one theme document, throwing a message that names the offending tokens. */
export function validateThemeJson(label, json) {
    if (typeof json === "object" &&
        json !== null &&
        "name" in json &&
        typeof json.name === "string" &&
        json.name.includes("/")) {
        throw new Error(`Invalid theme name "${json.name}": theme names cannot contain "/" because it is reserved for automatic light/dark theme settings.`);
    }
    if (!compiledThemeSchema.Check(json)) {
        const errors = Array.from(compiledThemeSchema.Errors(json));
        const missingColors = new Set();
        const otherErrors = [];
        for (const error of errors) {
            if (error.keyword === "required" && error.instancePath === "/colors") {
                const requiredProperties = error.params.requiredProperties;
                for (const requiredProperty of requiredProperties ?? []) {
                    missingColors.add(requiredProperty);
                }
                continue;
            }
            const path = error.instancePath || "/";
            otherErrors.push(`  - ${path}: ${error.message}`);
        }
        let errorMessage = `Invalid theme "${label}":\n`;
        if (missingColors.size > 0) {
            errorMessage += "\nMissing required color tokens:\n";
            errorMessage += Array.from(missingColors)
                .sort()
                .map((color) => `  - ${color}`)
                .join("\n");
            errorMessage += '\n\nPlease add these colors to your theme\'s "colors" object.';
            errorMessage += "\nSee the built-in themes (dark.json, light.json) for reference values.";
        }
        if (otherErrors.length > 0) {
            errorMessage += `\n\nOther errors:\n${otherErrors.join("\n")}`;
        }
        throw new Error(errorMessage);
    }
    return json;
}
//# sourceMappingURL=theme-schema.js.map