export interface ThemeDefinition {
    id: string;
    name: string;
    description: string;
    isDark: boolean;
    /** Theme family for grouping light/dark variants */
    family: string;
}
export declare const BUILT_IN_THEMES: ThemeDefinition[];
export declare function isBuiltInThemeId(id: string): boolean;
/** Backwards-compat alias for older callers. Prefer `isBuiltInThemeId`. */
export declare function isValidThemeId(id: string): boolean;
/** Apply a theme to a DOM element. Used client-side when the user toggles
 *  light/dark mode and inside the editor preview pane. */
export declare function applyThemeToElement(el: HTMLElement, themeId: string, overrides?: Record<string, string>): void;
export declare function getThemeFromElement(el: HTMLElement): {
    themeId: string;
    overrides: Record<string, string>;
};
/**
 * Serialize a token map into a CSS rule body. Used by the SSR middleware
 * to inject custom-theme styles into the document head.
 *
 * Escaping rules (defense-in-depth — admins are the only writers, but
 * we still want a malformed token to fail closed rather than break the
 * page or escape the <style> block):
 *   - keys are stripped to `[a-zA-Z0-9_-]`; empty keys are dropped
 *   - values strip CR/LF (prevents premature rule termination), strip the
 *     CSS statement/block delimiters `; { }` (prevents a crafted value from
 *     closing the `:root` rule and injecting arbitrary rules — e.g. an
 *     imported `.cpub-theme.json`), and escape `</` (prevents closing the
 *     <style> block). No legitimate single-property value contains `; { }`.
 *   - the function returns the rule body only; the caller wraps it in
 *     `<style>...</style>` (which Vue/Nuxt's useHead does for us)
 *
 * @param selector — e.g. `:root[data-theme="cpub-custom-deveco"]` or just `:root`
 * @param tokens — map of name→value (without leading `--`)
 */
export declare function tokensToCss(selector: string, tokens: Record<string, string>): string;
/** Compute a 5-color preview swatch from a token map (for the picker card). */
export declare function previewFromTokens(tokens: Record<string, string>, isDark: boolean): {
    bg: string;
    surface: string;
    accent: string;
    text: string;
    border: string;
};
export { TOKEN_NAMES, TOKEN_SPECS, TOKEN_GROUP_LABELS, TOKEN_GROUP_ORDER, ALIAS_TOKEN_NAMES, validateTokenOverrides, tokensByGroup, getTokenSpec, } from './tokens.js';
export type { TokenSpec, TokenGroup, TokenKind } from './tokens.js';
//# sourceMappingURL=theme.d.ts.map