import type { FlattenedDesignToken } from "./designmd.js";
export type BindingVerdict = "exact" | "near" | "none";
export interface Thresholds {
    color: number;
    length: number;
    unitless: number;
    rootPx: number;
}
export interface TokenBinding {
    property: string;
    captured: string;
    token?: string;
    css_var?: string;
    token_value?: string;
    verdict: BindingVerdict;
    delta?: number;
    delta_unit?: "px" | "rgb" | "ratio" | "unitless";
    why: string;
}
export interface ReferenceTokenMap {
    bindings: TokenBinding[];
    gaps: Array<{
        property: string;
        captured: string;
        why: string;
    }>;
    /** Bound and total count only properties eligible for deterministic matching. */
    coverage: {
        bound: number;
        total: number;
        ratio: number;
    };
    ramps_used: string[];
    /** Design-system problems found while resolving tokens, independent of any one property. */
    diagnostics: string[];
}
export declare function mapReferenceToTokens(captured: Record<string, string>, tokens: FlattenedDesignToken[], opts?: {
    thresholds?: Partial<Thresholds>;
    properties?: string[];
}): ReferenceTokenMap;
export declare function parseColorValue(value: string): [number, number, number, number] | null;