import { a as LookupResult } from './lookup-result-DXCBA61F.js';
import { b as DatasetChanges, c as DatasetVerification } from './types-CnePu8im.js';

interface IbgeRegiao {
    id: number;
    nome: string;
}
interface Estado {
    codigo: number;
    sigla: string;
    nome: string;
    regiao: IbgeRegiao;
}
interface Municipio {
    codigo: number;
    nome: string;
    uf: string;
}
interface IbgeDataVersion {
    id: 'ibge';
    nome: string;
    fonte: string;
    endpoints: string[];
    capturadoEm: string;
    atualizadoEm: string;
    contagens: {
        estados: number;
        municipios: number;
    };
    alteracoes: DatasetChanges;
    verificacao: DatasetVerification;
    documentacao: string;
}
type CmunFgParseFailureReason = 'EMPTY_INPUT' | 'INVALID_CHARS' | 'INVALID_LENGTH' | 'CHECK_DIGIT_MISMATCH';
interface CmunFgParseSuccess {
    ok: true;
    codigo: number;
    base6: string;
    checkDigit: number;
}
interface CmunFgParseFailure {
    ok: false;
    reason: CmunFgParseFailureReason;
}
type CmunFgParseResult = CmunFgParseSuccess | CmunFgParseFailure;

/**
 * IBGE locality lookup — offline embedded data from official IBGE API.
 * @see https://servicodados.ibge.gov.br/api/docs/localidades
 */

/** Returns every embedded IBGE state row (in-memory reference, not a copy). */
declare function getAllEstados(): readonly Estado[];
/** @deprecated Use {@link getAllEstados} instead. Removed in v2.0. */
declare function getEstados(): readonly Estado[];
/** Returns embedded IBGE municipalities, optionally filtered by UF (in-memory reference, not a copy). */
declare function getAllMunicipios(options?: {
    uf?: string;
}): readonly Municipio[];
/** @deprecated Use {@link getAllMunicipios} instead. Removed in v2.0. */
declare function getMunicipios(options?: {
    uf?: string;
}): readonly Municipio[];
declare function lookupMunicipioPorCodigo(codigo: number): LookupResult<Municipio>;
declare function getMunicipioPorCodigo(codigo: number): Municipio | undefined;

/**
 * NF-e cMunFG — 7-digit IBGE municipality code with check-digit rules (field B12).
 * @see https://www.ibge.gov.br/explica/codigos-dos-municipios.php
 * @see NF-e MOC 7.0 Anexo I — campo B12 cMunFG
 */

declare function computeCmunFgCheckDigit(base6: string): number | undefined;
declare function toCmunFg(codigo: number | string): string | undefined;
declare function parseCmunFg(code: string): CmunFgParseResult;

/**
 * IBGE localities — official Brazilian states and municipalities.
 * @see https://servicodados.ibge.gov.br/api/docs/localidades
 */
declare const IBGE_OFFICIAL_DOCS_URL = "https://servicodados.ibge.gov.br/api/docs/localidades";
declare const IBGE_ESTADOS_URL = "https://servicodados.ibge.gov.br/api/v1/localidades/estados";
declare const IBGE_MUNICIPIOS_URL = "https://servicodados.ibge.gov.br/api/v1/localidades/municipios";
/** All 27 federative unit siglas — used for UF filter validation. */
declare const IBGE_UF_SIGLAS: readonly ["AC", "AL", "AM", "AP", "BA", "CE", "DF", "ES", "GO", "MA", "MG", "MS", "MT", "PA", "PB", "PE", "PI", "PR", "RJ", "RN", "RO", "RR", "RS", "SC", "SE", "SP", "TO"];
/** Golden municipality — São Paulo capital (IBGE 3550308). */
declare const IBGE_GOLDEN_MUNICIPIO_SP = 3550308;
/** Golden municipality — Sorriso, MT (IBGE 5107925). */
declare const IBGE_GOLDEN_MUNICIPIO_SORRISO = 5107925;
/** Golden municipality — Brasília, DF (IBGE 5300108). */
declare const IBGE_GOLDEN_MUNICIPIO_BRASILIA = 5300108;
/** Golden state — São Paulo (IBGE 35). */
declare const IBGE_GOLDEN_ESTADO_SP = 35;
/** IBGE municipality code structure — official explanation (7-digit DV rules). */
declare const IBGE_MUNICIPIO_CODIGOS_URL = "https://www.ibge.gov.br/explica/codigos-dos-municipios.php";
/** NF-e MOC 7.0 Anexo I — campo B12 cMunFG (municipality of tax occurrence). */
declare const NFE_MOC_ANEXO_I_URL = "https://www.nfe.fazenda.gov.br/portal/listaConteudo.aspx?tipoConteudo=BMPFMBoln3w=";
/** Golden cMunFG base (6 digits) — São Paulo capital → 3550308. */
declare const CMUNFG_GOLDEN_BASE_SAO_PAULO = "355030";
/** Golden cMunFG full code — São Paulo capital. */
declare const CMUNFG_GOLDEN_SAO_PAULO = 3550308;
/** Golden cMunFG exception — Bom Princípio do Piauí (non-algorithmic DV). */
declare const CMUNFG_GOLDEN_EXCEPTION_BOM_PRINCIPIO = 2201919;

declare const IBGE_DATA_VERSION: IbgeDataVersion;

export { CMUNFG_GOLDEN_BASE_SAO_PAULO, CMUNFG_GOLDEN_EXCEPTION_BOM_PRINCIPIO, CMUNFG_GOLDEN_SAO_PAULO, type CmunFgParseFailure, type CmunFgParseFailureReason, type CmunFgParseResult, type CmunFgParseSuccess, type Estado, IBGE_DATA_VERSION, IBGE_ESTADOS_URL, IBGE_GOLDEN_ESTADO_SP, IBGE_GOLDEN_MUNICIPIO_BRASILIA, IBGE_GOLDEN_MUNICIPIO_SORRISO, IBGE_GOLDEN_MUNICIPIO_SP, IBGE_MUNICIPIOS_URL, IBGE_MUNICIPIO_CODIGOS_URL, IBGE_OFFICIAL_DOCS_URL, IBGE_UF_SIGLAS, type IbgeDataVersion, type IbgeRegiao, type Municipio, NFE_MOC_ANEXO_I_URL, computeCmunFgCheckDigit, getAllEstados, getAllMunicipios, getEstados, getMunicipioPorCodigo, getMunicipios, lookupMunicipioPorCodigo, parseCmunFg, toCmunFg };