/**
 * Built-in theme presets for Arkite UI.
 *
 * Each preset defines CSS variable values (HSL format without the hsl() wrapper).
 * Apply by calling `applyTheme(preset)` or import the CSS directly.
 */
interface ThemeTokens {
    primary: string;
    'primary-foreground': string;
    secondary: string;
    'secondary-foreground': string;
    accent: string;
    'accent-foreground': string;
    success: string;
    'success-foreground': string;
    warning: string;
    'warning-foreground': string;
    destructive: string;
    'destructive-foreground': string;
    info: string;
    'info-foreground': string;
    'success-soft': string;
    'success-soft-foreground': string;
    'success-border': string;
    'warning-soft': string;
    'warning-soft-foreground': string;
    'warning-border': string;
    'destructive-soft': string;
    'destructive-soft-foreground': string;
    'destructive-border': string;
    'info-soft': string;
    'info-soft-foreground': string;
    'info-border': string;
    background: string;
    foreground: string;
    muted: string;
    'muted-foreground': string;
    card: string;
    'card-foreground': string;
    border: string;
    input: string;
    ring: string;
    radius: string;
}
interface ThemePreset {
    name: string;
    light: ThemeTokens;
    dark: ThemeTokens;
}
declare const defaultTheme: ThemePreset;
declare const neutralTheme: ThemePreset;
declare const oceanTheme: ThemePreset;
declare const forestTheme: ThemePreset;
/** All built-in theme presets */
declare const themePresets: {
    readonly default: ThemePreset;
    readonly neutral: ThemePreset;
    readonly ocean: ThemePreset;
    readonly forest: ThemePreset;
};
type ThemePresetName = keyof typeof themePresets;

interface CreateThemeOptions {
    /** Theme name */
    name?: string;
    /** Primary brand color (hex) */
    primary: string;
    /** Accent color (hex). Defaults to a complementary color. */
    accent?: string;
    /** Border radius. Defaults to "0.5rem". */
    radius?: string;
}
/**
 * Create a complete theme from 1-2 input colors.
 *
 * @example
 * ```ts
 * import { createTheme, applyTheme } from '@arkite-ui/core'
 *
 * const myTheme = createTheme({
 *   primary: '#FF6B00',
 *   accent: '#00B4D8',
 * })
 *
 * applyTheme(myTheme) // applies to :root
 * ```
 */
declare function createTheme(options: CreateThemeOptions): ThemePreset;

/**
 * Apply a theme preset's CSS variables to a DOM element.
 * Applies light tokens to the element and dark tokens to `.dark` selector.
 *
 * @param theme - Theme preset to apply
 * @param element - Target element (defaults to document.documentElement)
 */
declare function applyTheme(theme: ThemePreset, element?: HTMLElement): void;
/**
 * Apply dark mode tokens to an element.
 *
 * @param theme - Theme preset to apply
 * @param element - Target element (defaults to document.documentElement)
 */
declare function applyDarkTheme(theme: ThemePreset, element?: HTMLElement): void;
/**
 * Generate a CSS string from a theme preset.
 * Useful for SSR or injecting into a <style> tag.
 *
 * @example
 * ```ts
 * const css = themeToCSS(myTheme)
 * // Returns:
 * // :root { --primary: 250 100% 65%; ... }
 * // .dark { --primary: 250 100% 70%; ... }
 * ```
 */
declare function themeToCSS(theme: ThemePreset, selector?: string): string;

/**
 * The contents of an `arkite.theme.json` — a project's brand as a committed
 * artifact rather than CSS variables copied between repos.
 *
 * Four values are the whole source of truth; every token in the generated
 * theme is derived from them, so a rebrand is a reviewable four-line diff.
 */
type ThemeFile = CreateThemeOptions;
/** Thrown when a theme file is malformed. The message is written for a terminal. */
declare class ThemeFileError extends Error {
    name: string;
}
/**
 * Validate parsed JSON as a theme file.
 *
 * `createTheme` itself is permissive — an unparseable hex flows through
 * `parseInt` and lands in the CSS as `NaN NaN% NaN%`, which fails at render
 * time in the consuming app rather than here. This is the gate that turns
 * that into a message at the point of authorship.
 *
 * Unknown keys are rejected rather than ignored: the file has four keys, so
 * an extra one is a typo (`primaryColor`) or a wrong mental model, and
 * silently dropping it would ship the default brand instead.
 */
declare function parseThemeFile(input: unknown): ThemeFile;
interface ThemeFileToCSSOptions {
    /** Path shown in the generated header, so the CSS points back at its source. */
    source?: string;
    /** Selector the light tokens land on. Defaults to `:root`. */
    selector?: string;
}
/**
 * Render a theme file as CSS variables, with a header marking it generated.
 *
 * Server-safe: this module touches no DOM, so a build script or a Server
 * Component can emit theme CSS without pulling in the component library.
 */
declare function themeFileToCSS(file: ThemeFile, options?: ThemeFileToCSSOptions): string;

/**
 * Chart color palette — CSS variable references for use with
 * Recharts, Nivo, Chart.js, or any charting library.
 *
 * Colors follow the theme system and adapt to light/dark mode.
 *
 * @example
 * ```tsx
 * import { chartColors } from '@arkite-ui/core'
 *
 * <BarChart data={data}>
 *   <Bar dataKey="revenue" fill={chartColors[1]} />
 *   <Bar dataKey="cost" fill={chartColors[2]} />
 * </BarChart>
 * ```
 */
declare const chartColors: {
    readonly 1: "hsl(var(--chart-1))";
    readonly 2: "hsl(var(--chart-2))";
    readonly 3: "hsl(var(--chart-3))";
    readonly 4: "hsl(var(--chart-4))";
    readonly 5: "hsl(var(--chart-5))";
};
/** Array form for iterating (e.g. mapping over datasets) */
declare const chartColorList: readonly ["hsl(var(--chart-1))", "hsl(var(--chart-2))", "hsl(var(--chart-3))", "hsl(var(--chart-4))", "hsl(var(--chart-5))"];
type ChartColorKey = keyof typeof chartColors;

export { type ChartColorKey, type CreateThemeOptions, type ThemeFile, ThemeFileError, type ThemeFileToCSSOptions, type ThemePreset, type ThemePresetName, type ThemeTokens, applyDarkTheme, applyTheme, chartColorList, chartColors, createTheme, defaultTheme, forestTheme, neutralTheme, oceanTheme, parseThemeFile, themeFileToCSS, themePresets, themeToCSS };