/**
 * @copyright Sister Software
 * @license AGPL-3.0
 * @author Teffen Ellis, et al.
 *
 * `bare-postcode` — a postcode without another address component, in the country's format.
 * Every surface the recipe renders is run through `detectKnownFormats` and refused unless the detector
 * calls it a postcode, so the rendering table and `known-formats.ts`'s patterns must agree.
 */
import type { PathBuilderLike } from "path-ts";
import { type CorpusRecipe } from "#recipes/scaffold";
/**
 * Choose distinct postcodes without inheriting the publisher's row order.
 *
 * A prior sort makes the result independent of input order.
 * The seeded sample spreads reproducibly across the complete set.
 */
export declare function selectPostcodes(codes: Iterable<string>, limit: number, seed: number): string[];
/**
 * Return every required input path that is absent, preserving declaration order for diagnostics.
 */
export declare function findMissingPostcodeSources<P extends PathBuilderLike>(paths: readonly P[], exists?: (path: P) => Promise<boolean>): Promise<P[]>;
/**
 * Every surface a country writes for one postcode, spaced form first, or `[]`
 * when this recipe defines no form for that country or the code does not fit.
 *
 * Exported so a test can pin that every rendered surface is one {@linkcode detectedAsPostcode} accepts.
 */
export declare function renderBarePostcode(country: string, postcode: string): string[];
/**
 * Whether `known-formats.ts` reads this surface as a postcode across its whole span.
 *
 * A surface the detector does not recognize would train the model on a string
 * the query-shape prior cannot then support.
 */
export declare function detectedAsPostcode(surface: string): boolean;
/**
 * Recipe registered with the corpus builder.
 */
export declare const barePostcodeRecipe: CorpusRecipe;
//# sourceMappingURL=postcode.d.ts.map