/**
 * @copyright Sister Software
 * @license AGPL-3.0
 * @author Teffen Ellis, et al.
 *
 *   Renders four hand-reviewed Venezuelan postcode facts in the `locality postcode, region` order.
 */
import type { PathBuilderLike } from "path-ts";
import { type CorpusRecipe } from "#recipes/scaffold";
/**
 * The source label for these rows.
 *
 * The rows get their own sampler bucket so an eval can measure them apart from other postcode placements.
 */
export declare const REVIEWED_POSTCODE_TAIL_SOURCE: string;
interface ReviewedTupleProvenance {
    publisher: string;
    url: string;
    retrievedAt: string;
    reviewStatus: "reviewed";
    sourceLicenseNote: string;
}
/**
 * One reviewed postcode fact and the source it was read from.
 */
export interface ReviewedPostcodeTuple {
    id: string;
    locality: string;
    postcode: string;
    region: string;
    country: "Venezuela";
    cc: "VE";
    locale: "es-VE";
    postcodePlacement: "after_locality";
    provenance: ReviewedTupleProvenance;
}
type VariantID = "canonical-country" | "canonical-no-country" | "comma-free" | "uppercase" | "left-context" | "accent-folded";
interface Variant {
    id: VariantID;
    raw: string;
    components: Record<string, string>;
}
/**
 * Returns the path of the committed reviewed-tuple data file.
 */
export declare function defaultReviewedPostcodeTuplePath(): string;
/**
 * Reads and validates the reviewed tuples.
 *
 * @throws When the file does not hold exactly four complete, unique, reviewed tuples.
 */
export declare function readReviewedPostcodeTuples(path?: PathBuilderLike): Promise<ReviewedPostcodeTuple[]>;
/**
 * Returns the surface variants of one tuple.
 *
 * Every variant reuses the tuple's own locality, postcode and region, so no variant
 * pairs a postcode with a place the review did not cover.
 */
export declare function reviewedPostcodeTailVariants(tuple: ReviewedPostcodeTuple): Variant[];
/**
 * The corpus recipe that emits every variant of every reviewed tuple.
 */
export declare const reviewedPostcodeTailRecipe: CorpusRecipe;
export {};
//# sourceMappingURL=reviewed-postcode-tail.d.ts.map