declare const VALID_DTYPES: readonly ["string", "integer", "float", "boolean", "date", "datetime"];
type Dtype = (typeof VALID_DTYPES)[number];
interface FieldInfo {
    name: string;
    dtype: Dtype;
    sampleValues: string[];
    nullRate: number;
    uniqueRate: number;
    valueCount: number;
    metadata: Record<string, unknown>;
    /** Affix-stripped canonical form populated by the engine. Optional. */
    canonicalName?: string;
}
interface SchemaInfo {
    fields: FieldInfo[];
    sourceName: string;
    requiredFields: string[];
}
interface ScorerResult {
    score: number;
    reasoning: string;
}
interface FieldMapping {
    source: string;
    target: string;
    confidence: number;
    breakdown: Record<string, ScorerResult>;
    reasoning: string;
}
interface MapResult {
    mappings: FieldMapping[];
    unmappedSource: string[];
    unmappedTarget: string[];
    warnings: string[];
    metadata: Record<string, unknown>;
    scoreMatrix?: Record<string, Record<string, number>>;
}
declare function makeFieldInfo(input: {
    name: string;
    dtype?: string;
    sampleValues?: string[];
    nullRate?: number;
    uniqueRate?: number;
    valueCount?: number;
    metadata?: Record<string, unknown>;
}): FieldInfo;
declare function makeSchemaInfo(input: {
    fields: FieldInfo[];
    sourceName?: string;
    requiredFields?: string[];
}): SchemaInfo;
declare function clampScore(score: number): number;
declare function makeScorerResult(score: number, reasoning: string): ScorerResult;
interface MapResultReport {
    mappings: Array<{
        source: string;
        target: string;
        confidence: number;
        breakdown: Record<string, {
            score: number;
            reasoning: string;
        }>;
        reasoning: string;
    }>;
    unmapped_source: string[];
    unmapped_target: string[];
    warnings: string[];
}
declare function mapResultToReport(result: MapResult): MapResultReport;
declare function mapResultToJson(result: MapResult): string;

interface FileProviderOptions {
    sourceName?: string;
    sampleSize?: number;
}
declare function inferSchemaFromCsvText(text: string, options?: FileProviderOptions): SchemaInfo;
declare function inferSchemaFromJsonText(text: string, options?: FileProviderOptions): SchemaInfo;

export { type Dtype as D, type FileProviderOptions as F, type MapResult as M, type SchemaInfo as S, VALID_DTYPES as V, type FieldInfo as a, type ScorerResult as b, type FieldMapping as c, type MapResultReport as d, clampScore as e, inferSchemaFromJsonText as f, makeSchemaInfo as g, makeScorerResult as h, inferSchemaFromCsvText as i, mapResultToJson as j, mapResultToReport as k, makeFieldInfo as m };