import type { Mapping, MappingId } from "./types.js";
/**
 * Load a mapping from a JSON string. Validates that every word entry maps to a
 * string; keys beginning with `_` (e.g. the `_meta` provenance block) are
 * skipped rather than treated as word pairs.
 *
 * Have the JSON already in memory (bundled into your app, or fetched from a CDN
 * with your own `fetch`)? Pass the text straight to this function.
 */
export declare function loadMappingFromString(json: string): Mapping;
/**
 * Best-effort identity parser. Reads `_meta` if present in the JSON,
 * else returns null. Use it to compare the encoder's mapping against a
 * font's nameID 26 metadata (encoder/font pairing check).
 */
export declare function parseMappingId(json: string): MappingId | null;
/**
 * Return the `_meta` provenance block of a bundled mapping object (the JSON
 * constants exported from this package each carry one), or null if absent.
 * Lets a consumer read `mappingMeta(alpha)?.version` / `.mappingId` at runtime
 * to verify which font + dictionary generation they are running.
 */
export declare function mappingMeta(mapping: Mapping): MappingId | null;
//# sourceMappingURL=mapping.d.ts.map