/**
 * Browser-safe brand contract, defaults, and LLM serialization helpers.
 *
 * Asset values are intentionally strings: they may be relative file paths,
 * package exports, data URLs, or network URLs depending on the consumer.
 *
 * @module
 */
import { z } from "zod";
/** Package asset references used when a brand context supplies no custom artwork. */
export declare const DEFAULT_BRAND_ASSETS: {
    readonly icon: {
        readonly light: "@dbx-tools/ui/branding/assets/icon-light.svg";
        readonly dark: "@dbx-tools/ui/branding/assets/icon-dark.svg";
    };
    readonly logo: {
        readonly light: "@dbx-tools/ui/branding/assets/logo-light.svg";
        readonly dark: "@dbx-tools/ui/branding/assets/logo-dark.svg";
    };
    readonly favicon: "@dbx-tools/ui/branding/assets/icon-light.svg";
};
/** Validates light and optional dark variants for one visual asset. */
export declare const BrandAssetSetSchema: z.ZodObject<{
    light: z.ZodString;
    dark: z.ZodOptional<z.ZodString>;
}, z.core.$strict>;
/** Strict brand palette whose omitted colors resolve to the dbx tools defaults. */
export declare const BrandColorsSchema: z.ZodPrefault<z.ZodObject<{
    primary: z.ZodDefault<z.ZodString>;
    primaryHover: z.ZodDefault<z.ZodString>;
    accent: z.ZodDefault<z.ZodString>;
    foreground: z.ZodDefault<z.ZodString>;
    background: z.ZodDefault<z.ZodString>;
    surface: z.ZodDefault<z.ZodString>;
    muted: z.ZodDefault<z.ZodString>;
    border: z.ZodDefault<z.ZodString>;
}, z.core.$strict>>;
/** Strict audience, tone, principle, and avoidance lists with practical defaults. */
export declare const BrandVoiceSchema: z.ZodPrefault<z.ZodObject<{
    audience: z.ZodDefault<z.ZodArray<z.ZodString>>;
    tone: z.ZodDefault<z.ZodArray<z.ZodString>>;
    principles: z.ZodDefault<z.ZodArray<z.ZodString>>;
    avoid: z.ZodDefault<z.ZodArray<z.ZodString>>;
}, z.core.$strict>>;
/**
 * Strict portable brand contract that fills identity, assets, colors,
 * typography, voice, links, and extension defaults during parsing.
 */
export declare const BrandContextSchema: z.ZodObject<{
    schemaVersion: z.ZodDefault<z.ZodLiteral<"1">>;
    name: z.ZodDefault<z.ZodString>;
    shortName: z.ZodDefault<z.ZodString>;
    tagline: z.ZodOptional<z.ZodString>;
    description: z.ZodDefault<z.ZodString>;
    assets: z.ZodDefault<z.ZodObject<{
        icon: z.ZodDefault<z.ZodObject<{
            light: z.ZodString;
            dark: z.ZodOptional<z.ZodString>;
        }, z.core.$strict>>;
        logo: z.ZodDefault<z.ZodObject<{
            light: z.ZodString;
            dark: z.ZodOptional<z.ZodString>;
        }, z.core.$strict>>;
        favicon: z.ZodDefault<z.ZodString>;
    }, z.core.$strict>>;
    colors: z.ZodPrefault<z.ZodObject<{
        primary: z.ZodDefault<z.ZodString>;
        primaryHover: z.ZodDefault<z.ZodString>;
        accent: z.ZodDefault<z.ZodString>;
        foreground: z.ZodDefault<z.ZodString>;
        background: z.ZodDefault<z.ZodString>;
        surface: z.ZodDefault<z.ZodString>;
        muted: z.ZodDefault<z.ZodString>;
        border: z.ZodDefault<z.ZodString>;
    }, z.core.$strict>>;
    typography: z.ZodPrefault<z.ZodObject<{
        sans: z.ZodDefault<z.ZodString>;
        mono: z.ZodDefault<z.ZodString>;
    }, z.core.$strict>>;
    voice: z.ZodPrefault<z.ZodObject<{
        audience: z.ZodDefault<z.ZodArray<z.ZodString>>;
        tone: z.ZodDefault<z.ZodArray<z.ZodString>>;
        principles: z.ZodDefault<z.ZodArray<z.ZodString>>;
        avoid: z.ZodDefault<z.ZodArray<z.ZodString>>;
    }, z.core.$strict>>;
    links: z.ZodPrefault<z.ZodObject<{
        website: z.ZodDefault<z.ZodString>;
        repository: z.ZodOptional<z.ZodString>;
        documentation: z.ZodDefault<z.ZodString>;
    }, z.core.$strict>>;
    extensions: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
}, z.core.$strict>;
/** Fully validated brand context after every schema default has been applied. */
export type BrandContext = z.output<typeof BrandContextSchema>;
/** Input accepted by {@link BrandContextSchema}, before defaults are materialized. */
export type BrandContextInput = z.input<typeof BrandContextSchema>;
/** Theme-aware light and optional dark references for one brand asset. */
export type BrandAssetSet = z.output<typeof BrandAssetSetSchema>;
/** Validate input and fill every dbx tools default. */
export declare function parseBrandContext(input?: unknown): BrandContext;
/** Canonical dbx tools brand context with all schema defaults resolved. */
export declare const defaultBrandContext: BrandContext;
/** JSON Schema representation suitable for structured-output and tool definitions. */
export declare function brandContextJsonSchema(): Record<string, unknown>;
/** Stable prompt block for an LLM that needs to write or design in this brand. */
export declare function brandContextPrompt(context?: BrandContext): string;