import { LicensePlateFormat } from "./get-format-license-plate.js";
//#region src/generate-license-plate/generate-license-plate.d.ts
/** The license plate formats `generateLicensePlate` can generate. */
export type GenerateLicensePlateFormat = LicensePlateFormat;
/**
 * Generates a valid random Brazilian license plate (placa de carro ou moto).
 *
 * Uses `Math.random()` internally, so it is not cryptographically secure, do not use for
 * security purposes.
 *
 * @param {GenerateLicensePlateFormat} [format] - The format to generate. Defaults to the
 * Mercosul format ("LLLNLNN"), the single sequence Resolução CONTRAN nº 969/2022 defines for
 * every vehicle, motorcycles included.
 * @returns {string} A randomly generated license plate matching the requested format.
 *
 * @example
 * ```typescript
 * generateLicensePlate(); // "ABC1D23" (Mercosul)
 * generateLicensePlate("LLLNNNN"); // "ABC1234" (old Brazilian format)
 * ```
 *
 * The resolution's own text does not spell the sequence out: art. 2º § 2º delegates the
 * technical specification to Anexo I, whose item 1.2 reads "O padrão de estampagem é composto de
 * 7 (sete) caracteres alfanuméricos, em alto relevo, na sequência LLLNLNN" and whose item 1.2.1
 * reads `L` as a letter and `N` as a numeral. The annexes are published in a PDF of their own,
 * cited below alongside the resolution's text.
 *
 * A `format` outside the two supported literals falls back to the default, like every other
 * generator of this package does with an option it does not know, so the result is always a plate
 * `isValidLicensePlate` accepts. (2.3.0 used an unknown string verbatim, so
 * `generateLicensePlate("LLLNNLN")` produced the withdrawn motorcycle sequence and
 * `generateLicensePlate("bogus")` five digits; neither is a plate.)
 *
 * @see Official: https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao9692022.pdf
 * @see Official: https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao9692022anexos.pdf
 */
export declare const generateLicensePlate: (format?: GenerateLicensePlateFormat) => string;
//#endregion