@br-validators/core 1.9.0 → 1.10.0

package/dist/{index-CttohJuk.d.ts → index-CmpOAd8U.d.ts}

@@ -1,6 +1,6 @@
 import { U as UfCode, V as ValidationErrorCode } from './validation-result-D4Wrxl7j.js';
 
-type SanitizableDocumentType = 'cpf' | 'cnpj' | 'cep' | 'placa' | 'pis-pasep' | 'telefone' | 'cnh' | 'renavam' | 'titulo-eleitor' | 'processo-judicial' | 'rg' | 'nfe-chave' | 'boleto' | 'cartao-credito' | 'ean' | 'inscricao-estadual' | 'inscricao-estadual-produtor-rural';
+type SanitizableDocumentType = 'cpf' | 'cnpj' | 'cep' | 'placa' | 'pis-pasep' | 'telefone' | 'cnh' | 'renavam' | 'titulo-eleitor' | 'processo-judicial' | 'rg' | 'nfe-chave' | 'boleto' | 'cartao-credito' | 'ean' | 'inscricao-estadual' | 'inscricao-estadual-produtor-rural' | 'pix';
 type SanitizeOptions = {
     uf?: UfCode;
 };

package/dist/index.d.ts

@@ -16,20 +16,20 @@ export { PLACA_GOLDEN_CONVERSION_FROM, PLACA_GOLDEN_CONVERSION_TO, PLACA_GOLDEN_
 export { PIS_PASEP_GOLDEN_PRIMARY, PIS_PASEP_GOLDEN_PRIMARY_MASKED, PIS_PASEP_GOLDEN_SECONDARY, PIS_PASEP_OFFICIAL_SOURCE_URL, formatPisPasep, isValidPisPasep, stripPisPasep, validatePisPasep } from './pis-pasep.js';
 export { CNIS_BASE_LENGTH, CNIS_DV_WEIGHTS, CNIS_GOLDEN_CAIXA_PIS, CNIS_GOLDEN_CAIXA_PIS_MASKED, CNIS_GOLDEN_INSS_NIT, CNIS_GOLDEN_INSS_NIT_MASKED, CNIS_INSS_NIT_SERVICE_URL, CNIS_LENGTH, CNIS_MASK_PATTERN, CNIS_OFFICIAL_VALIDATION_URL, NitMetadataOptions, ValidateNitOptions, formatNit, inferNitIssuer, inferNitTipo, isValidNit, resolveNitMetadata, stripNit, validateNit } from './cnis.js';
 export { ArrecadacaoInputKind, ArrecadacaoValidationResult, ArrecadacaoValueType, BOLETO_ARRECADACAO_CODIGO_BARRAS_LENGTH, BOLETO_ARRECADACAO_LINHA_LENGTH, BOLETO_ARRECADACAO_OFFICIAL_SOURCE_URL, BOLETO_ARRECADACAO_PRODUCT_ID, BOLETO_CODE_ISPB_HOLDER, BOLETO_CODIGO_BARRAS_LENGTH, BOLETO_CURRENCY_ISPB, BOLETO_CURRENCY_REAL, BOLETO_GOLDEN_CODIGO_BARRAS, BOLETO_GOLDEN_CODIGO_BARRAS_BB, BOLETO_GOLDEN_CODIGO_BARRAS_SITUACAO2, BOLETO_GOLDEN_LINHA_BB_STRIPPED, BOLETO_GOLDEN_LINHA_MASKED, BOLETO_GOLDEN_LINHA_SITUACAO2_STRIPPED, BOLETO_GOLDEN_LINHA_STRIPPED, BOLETO_LAYOUTS_PORTAL_URL, BOLETO_LINHA_LENGTH, BOLETO_OFFICIAL_SOURCE_URL, BoletoSituacaoCode, BoletoSituacaoKind, DetectedBoletoInputKind, FatorVencimentoValidationResult, ValidateBoletoOptions, ValorDocumentoValidationResult, applyLinhaDigitavelMask, computeArrecadacaoModulo10Dv, computeArrecadacaoModulo11Dv, computeArrecadacaoModulo10Dv as computeModulo10FieldDv, computeModulo11BarcodeDv, convertCodigoBarrasToLinhaDigitavel, convertCodigoBarrasToLinhaDigits, convertLinhaToCodigoBarras, convertLinhaToCodigoBarrasDigits, detectBoletoInputKind, detectBoletoSituacao, formatBoleto, formatLinhaDigitavel, isValidArrecadacao, isValidBoleto, linhaArrecadacaoToCodigoBarras, stripArrecadacao, stripCodigoBarras, stripLinhaDigitavel, validateArrecadacao, validateArrecadacaoCodigoBarras, validateArrecadacaoLinha, validateBoleto, validateCodigoBarras, validateFatorVencimento, validateLinhaDigitavel, validateValorDocumento } from './boleto.js';
-export { D as DetectedPixKeyType, P as PIX_DICT_API_SOURCE_URL, a as PIX_GOLDEN_CNPJ_ALPHANUMERIC, b as PIX_GOLDEN_CNPJ_NUMERIC, c as PIX_GOLDEN_CPF, d as PIX_GOLDEN_EMAIL, e as PIX_GOLDEN_EVP, f as PIX_GOLDEN_PHONE, g as PIX_OFFICIAL_SOURCE_URL, V as ValidatePixKeyOptions, h as detectPixKeyType, i as formatPixKey, j as isValidPixKey, v as validatePixCnpjKey, k as validatePixCpfKey, l as validatePixEmailKey, m as validatePixEvpKey, n as validatePixKey, o as validatePixPhoneKey } from './pix-B8_PfK2D.js';
+export { D as DetectedPixKeyType, P as PIX_DICT_API_SOURCE_URL, a as PIX_GOLDEN_CNPJ_ALPHANUMERIC, b as PIX_GOLDEN_CNPJ_NUMERIC, c as PIX_GOLDEN_CPF, d as PIX_GOLDEN_EMAIL, e as PIX_GOLDEN_EVP, f as PIX_GOLDEN_PHONE, g as PIX_OFFICIAL_SOURCE_URL, V as ValidatePixKeyOptions, h as detectPixKeyType, i as formatPixKey, j as isValidPixKey, s as stripPixKey, v as validatePixCnpjKey, k as validatePixCpfKey, l as validatePixEmailKey, m as validatePixEvpKey, n as validatePixKey, o as validatePixPhoneKey } from './pix-DhAb6Iho.js';
 export { computeLuhnSum, detectCardBrand, formatCartaoCredito, isValidCartaoCredito, isValidLuhn, passesLuhn, stripCartaoCredito, validateCartaoCredito } from './cartao-credito.js';
 export { EAN_13_LENGTH, EAN_8_LENGTH, EAN_GOLDEN_13, EAN_GOLDEN_13_MASKED, EAN_GOLDEN_8, EAN_GOLDEN_8_MASKED, EAN_OFFICIAL_SOURCE_URL, EanFormat, applyEanMask, computeGs1Modulo10CheckDigit, computeGs1Modulo10Sum, detectEanFormat, formatEan, isValidEan, isValidGs1Modulo10, passesGs1Modulo10, stripEan, validateEan } from './ean.js';
 export { ValidateInscricaoEstadualOptions, formatInscricaoEstadual, getIeOfficialSourceUrl, isValidInscricaoEstadual, stripInscricaoEstadual, validateIeDf, validateIeMt, validateIeSp, validateInscricaoEstadual } from './inscricao-estadual.js';
 export { DetectOptions, DetectResult, DetectableDocumentType, detect } from './detect.js';
-export { S as SanitizableDocumentType, a as SanitizeOptions, b as SanitizeResult, s as sanitize } from './index-CttohJuk.js';
+export { S as SanitizableDocumentType, a as SanitizeOptions, b as SanitizeResult, s as sanitize } from './index-CmpOAd8U.js';
 export { MASKABLE_DOCUMENT_TYPES, MaskOptions, MaskableDocumentType, isMaskableDocumentType, mask, maskRuntime } from './mask.js';
 export { CompareResult, compare, compareRuntime } from './compare.js';
-export { BatchInvalidEntry, BatchResult, BatchSummary, BatchValidEntry, batch } from './batch.js';
+export { BatchInvalidEntry, BatchResult, BatchSummary, BatchValidEntry, ParseBatchCsvFailure, ParseBatchCsvOptions, ParseBatchCsvResult, ParseBatchCsvSuccess, batch, parseBatchCsv } from './batch.js';
 export { DiffField, DiffResult, diff } from './diff.js';
 export { CPF_ALPHA_GENERATE_STUB, GENERATABLE_CARD_BRANDS, GeneratableCardBrand, GeneratableDocumentType, GenerateOptions, applyArrecadacaoLinhaMask, assertCpfAlphanumericGenerateAllowed, generate, isGeneratableCardBrand, rejectCpfAlphanumericGenerate } from './generate.js';
 export { C as CARTAO_GOLDEN_AMEX, a as CARTAO_GOLDEN_LUHN_WALKTHROUGH, b as CARTAO_GOLDEN_MASTERCARD, c as CARTAO_GOLDEN_MIN_LENGTH, d as CARTAO_GOLDEN_VISA, e as CARTAO_GOLDEN_VISA_MASKED, f as CARTAO_IEC_SOURCE_URL, g as CARTAO_OFFICIAL_SOURCE_URL, h as CARTAO_PAN_MAX_LENGTH, i as CARTAO_PAN_MIN_LENGTH, j as CardBrand } from './constants-BqegsAc2.js';
 import './types-CnePu8im.js';
-import './types-CTLx5zMu.js';
+import './types-DLuN-sEJ.js';
 
 /**
  * Format decorator — union entrypoint (UC-003).

package/dist/index.js

@@ -1,69 +1,70 @@
 import './chunk-ZH4RJNG7.js';
 import './chunk-7ULDLG4C.js';
+import './chunk-JQABTHUJ.js';
 import './chunk-3WXLMV7Q.js';
 import './chunk-G24G7WR5.js';
 import './chunk-NQIDHQ6U.js';
-export { sanitize } from './chunk-KSDAKRG5.js';
+export { sanitize } from './chunk-UH6WIKOT.js';
 import './chunk-4J5IMD7B.js';
 import './chunk-P55H5YRX.js';
-import './chunk-KLPONHBL.js';
-import './chunk-JQABTHUJ.js';
-export { MASKABLE_DOCUMENT_TYPES, isMaskableDocumentType, mask, maskRuntime } from './chunk-MOMQLTSD.js';
+import './chunk-5V2TNYC7.js';
+import './chunk-QGMVUIDD.js';
+export { MASKABLE_DOCUMENT_TYPES, isMaskableDocumentType, mask, maskRuntime } from './chunk-QGL5YFPF.js';
 export { formatProcessoJudicial } from './chunk-MAMBSTTO.js';
-export { CPF_ALPHA_GENERATE_STUB, GENERATABLE_CARD_BRANDS, applyArrecadacaoLinhaMask, assertCpfAlphanumericGenerateAllowed, generate, isGeneratableCardBrand, rejectCpfAlphanumericGenerate } from './chunk-62P6SKG3.js';
+export { CPF_ALPHA_GENERATE_STUB, GENERATABLE_CARD_BRANDS, applyArrecadacaoLinhaMask, assertCpfAlphanumericGenerateAllowed, generate, isGeneratableCardBrand, rejectCpfAlphanumericGenerate } from './chunk-ZJ2GD2GK.js';
 export { formatTelefone } from './chunk-S4WEXFHC.js';
-export { formatTituloEleitor } from './chunk-4HQ4J2J5.js';
-export { formatRenavam } from './chunk-N6CALNFU.js';
+export { formatTituloEleitor } from './chunk-A255RZZ7.js';
+import { formatPlaca } from './chunk-KCRWHMDY.js';
+export { formatPlaca } from './chunk-KCRWHMDY.js';
+export { formatRenavam } from './chunk-YC4GZZJP.js';
 export { formatNfeChave } from './chunk-6KHTKD5U.js';
 import { formatPisPasep } from './chunk-INPLK35M.js';
 export { formatPisPasep } from './chunk-INPLK35M.js';
-import { formatPixKey } from './chunk-NQIKXTMI.js';
-export { formatPixKey } from './chunk-NQIKXTMI.js';
-import { formatPlaca } from './chunk-2BNGYQFQ.js';
-export { formatPlaca } from './chunk-2BNGYQFQ.js';
+import { formatPixKey } from './chunk-LKDZEPWZ.js';
+export { formatPixKey } from './chunk-LKDZEPWZ.js';
 import './chunk-MFNJTAUS.js';
-import './chunk-QGMVUIDD.js';
 export { formatIeProdutorRural } from './chunk-5ZJMYR63.js';
-export { compare, compareRuntime } from './chunk-CIOSYWV4.js';
+export { compare, compareRuntime } from './chunk-JZKKTVMO.js';
 import './chunk-YGA5W54J.js';
-import { formatCpf } from './chunk-7HEMXLDS.js';
-export { formatCpf } from './chunk-7HEMXLDS.js';
-export { detect } from './chunk-DQPSNERX.js';
-export { diff } from './chunk-N2MDJI4B.js';
-import './chunk-SCBXZLZ5.js';
-import './chunk-BLSDFC3C.js';
+import { formatCpf } from './chunk-GQRHLW5W.js';
+export { formatCpf } from './chunk-GQRHLW5W.js';
+export { detect } from './chunk-ZODIHY33.js';
+export { diff } from './chunk-FTC4V5PN.js';
+import './chunk-OHGZOWUT.js';
+import './chunk-NNMK3ZHS.js';
 import './chunk-GVK6IMBF.js';
 import './chunk-P5BDKYBC.js';
 import { formatEan } from './chunk-WIBYIZ4N.js';
 export { formatEan } from './chunk-WIBYIZ4N.js';
 import './chunk-2CNYSY3Z.js';
-import { formatCep } from './chunk-56ZN3TBH.js';
-export { formatCep } from './chunk-56ZN3TBH.js';
+import { formatCep } from './chunk-DXKHCIMV.js';
+export { formatCep } from './chunk-DXKHCIMV.js';
 import './chunk-Y2KUN2D3.js';
-export { formatCnh } from './chunk-3FDHWX2H.js';
+export { formatCnh } from './chunk-BTRWDUZF.js';
 export { CNIS_BASE_LENGTH, CNIS_DV_WEIGHTS, CNIS_GOLDEN_CAIXA_PIS, CNIS_GOLDEN_CAIXA_PIS_MASKED, CNIS_GOLDEN_INSS_NIT, CNIS_GOLDEN_INSS_NIT_MASKED, CNIS_INSS_NIT_SERVICE_URL, CNIS_LENGTH, CNIS_MASK_PATTERN, CNIS_OFFICIAL_VALIDATION_URL, formatNit, inferNitIssuer, inferNitTipo, isValidNit, resolveNitMetadata, stripNit, validateNit } from './chunk-W5J2V4NI.js';
 import './chunk-XFKSJRWM.js';
 import './chunk-LF2B4VPE.js';
-import { formatCnpj } from './chunk-ZL5RDZJM.js';
-export { formatCnpj, formatCnpjAlphanumeric, formatCnpjNumeric } from './chunk-ZL5RDZJM.js';
-export { batch } from './chunk-5IYHOWQU.js';
+import { formatCnpj } from './chunk-HEPUV3XR.js';
+export { formatCnpj, formatCnpjAlphanumeric, formatCnpjNumeric } from './chunk-HEPUV3XR.js';
+export { batch, parseBatchCsv } from './chunk-GTEKDS6X.js';
 export { RG_AC_GOLDEN, RG_AL_GOLDEN, RG_AM_GOLDEN, RG_AP_GOLDEN, RG_BA_GOLDEN, RG_CE_GOLDEN, RG_DF_GOLDEN, RG_ES_GOLDEN, RG_GO_GOLDEN, RG_MA_GOLDEN, RG_MG_GOLDEN, RG_MG_GOLDEN_MASKED, RG_MG_GOLDEN_PREFIXED, RG_MS_GOLDEN, RG_MT_GOLDEN, RG_OFFICIAL_SOURCE_URL, RG_OFFICIAL_SOURCE_URLS, RG_PA_GOLDEN, RG_PB_GOLDEN, RG_PENDING_UFS, RG_PE_GOLDEN, RG_PI_GOLDEN, RG_PR_GOLDEN, RG_RESEARCH_URLS, RG_RJ_GOLDEN, RG_RJ_GOLDEN_MASKED, RG_RN_GOLDEN, RG_RO_GOLDEN, RG_RR_GOLDEN, RG_RS_GOLDEN, RG_SC_GOLDEN, RG_SE_GOLDEN, RG_SP_GOLDEN, RG_SP_GOLDEN_MASKED, RG_SP_GOLDEN_X, RG_SP_GOLDEN_X_MASKED, RG_SUPPORTED_UFS, RG_TO_GOLDEN, RG_UF_RULES, computeRgMod10AlternatingCheckDigit, computeRgSpCheckDigit, formatRg, getRgOfficialSourceUrl, getRgPendingUfs, getRgResearchUrl, getRgUfRules, getRgUfSupport, isRgUfImplemented, isValidRg, stripRg, validateRg, validateRgAc, validateRgAl, validateRgAm, validateRgAp, validateRgBa, validateRgCe, validateRgDf, validateRgEs, validateRgGo, validateRgMa, validateRgMg, validateRgMs, validateRgMt, validateRgPa, validateRgPb, validateRgPe, validateRgPi, validateRgPr, validateRgRj, validateRgRn, validateRgRo, validateRgRr, validateRgRs, validateRgSc, validateRgSe, validateRgSp, validateRgTo } from './chunk-6F3A3NT4.js';
-export { RENAVAM_BASE_LENGTH, RENAVAM_DV_WEIGHTS, RENAVAM_GOLDEN_DASH_INPUT, RENAVAM_GOLDEN_DV_ZERO, RENAVAM_GOLDEN_LEADING_ZEROS, RENAVAM_GOLDEN_PRIMARY, RENAVAM_GOLDEN_SECONDARY, RENAVAM_LENGTH, RENAVAM_OFFICIAL_SOURCE_URL, RENAVAM_SENATRAN_CONSULTA_URL, isValidRenavam, validateRenavam } from './chunk-F6LVFAJT.js';
+export { RENAVAM_BASE_LENGTH, RENAVAM_DV_WEIGHTS, RENAVAM_GOLDEN_DASH_INPUT, RENAVAM_GOLDEN_DV_ZERO, RENAVAM_GOLDEN_LEADING_ZEROS, RENAVAM_GOLDEN_PRIMARY, RENAVAM_GOLDEN_SECONDARY, RENAVAM_LENGTH, RENAVAM_OFFICIAL_SOURCE_URL, RENAVAM_SENATRAN_CONSULTA_URL, isValidRenavam, validateRenavam } from './chunk-4NS47CJG.js';
 export { PROCESSO_JUDICIAL_ANEXO_VIII_URL, PROCESSO_JUDICIAL_ANO_LENGTH, PROCESSO_JUDICIAL_DV_LENGTH, PROCESSO_JUDICIAL_GOLDEN_PRIMARY, PROCESSO_JUDICIAL_GOLDEN_PRIMARY_MASKED, PROCESSO_JUDICIAL_GOLDEN_SECONDARY, PROCESSO_JUDICIAL_GOLDEN_SECONDARY_MASKED, PROCESSO_JUDICIAL_GOLDEN_TJSP, PROCESSO_JUDICIAL_GOLDEN_TJSP_MASKED, PROCESSO_JUDICIAL_LENGTH, PROCESSO_JUDICIAL_MASKED_PATTERN, PROCESSO_JUDICIAL_MAX_SEGMENTO, PROCESSO_JUDICIAL_MIN_SEGMENTO, PROCESSO_JUDICIAL_NUMERIC_PATTERN, PROCESSO_JUDICIAL_OFFICIAL_SOURCE_URL, PROCESSO_JUDICIAL_ORIGEM_LENGTH, PROCESSO_JUDICIAL_SEGMENTO_LENGTH, PROCESSO_JUDICIAL_SEQUENCIAL_LENGTH, PROCESSO_JUDICIAL_TRIBUNAL_LENGTH, computeProcessoJudicialCheckDigits, isValidProcessoJudicial, isValidProcessoJudicialCheckDigits, parseProcessoJudicial, parseProcessoJudicialParts, stripProcessoJudicial, validateProcessoJudicial } from './chunk-A4QBLVVO.js';
 export { ANATEL_DDDS, ANATEL_DDD_SET, TELEFONE_ANATEL_DDD_PANEL_URL, TELEFONE_DDD_DATA_VERSION, TELEFONE_GOLDEN_CELULAR, TELEFONE_GOLDEN_CELULAR_MASKED, TELEFONE_GOLDEN_FIXO, TELEFONE_GOLDEN_FIXO_MASKED, TELEFONE_OFFICIAL_SOURCE_URL, extractTelefoneDigits, getDddInfo, isValidTelefone, normalizeTelefoneDigits, stripTelefone, validateTelefone } from './chunk-HZ4UGWFE.js';
-export { TITULO_ELEITOR_ALGORITHM_REF_URL, TITULO_ELEITOR_ALGORITHM_WEIGHTS_REF_URL, TITULO_ELEITOR_DV1_WEIGHTS_8, TITULO_ELEITOR_DV1_WEIGHTS_9, TITULO_ELEITOR_DV2_WEIGHTS, TITULO_ELEITOR_ETITULO_URL, TITULO_ELEITOR_EXTERIOR_UF_CODE, TITULO_ELEITOR_GOLDEN_EXTERIOR, TITULO_ELEITOR_GOLDEN_MASKED_INPUT, TITULO_ELEITOR_GOLDEN_PRIMARY, TITULO_ELEITOR_GOLDEN_SP_EXTENDED, TITULO_ELEITOR_GOLDEN_SP_SPECIAL, TITULO_ELEITOR_LENGTH, TITULO_ELEITOR_LENGTH_EXTENDED, TITULO_ELEITOR_NORMATIVE_SECONDARY_URL, TITULO_ELEITOR_NUMERIC_PATTERN_12, TITULO_ELEITOR_NUMERIC_PATTERN_13, TITULO_ELEITOR_OFFICIAL_SOURCE_URL, TITULO_ELEITOR_SEQUENTIAL_LENGTH, TITULO_ELEITOR_SEQUENTIAL_LENGTH_EXTENDED, TITULO_ELEITOR_SPECIAL_UF_CODES, TITULO_ELEITOR_TSE_PORTAL_URL, TITULO_ELEITOR_UF_BY_CODE, isValidTituloEleitor, validateTituloEleitor } from './chunk-MSYTS5K7.js';
+export { TITULO_ELEITOR_ALGORITHM_REF_URL, TITULO_ELEITOR_ALGORITHM_WEIGHTS_REF_URL, TITULO_ELEITOR_DV1_WEIGHTS_8, TITULO_ELEITOR_DV1_WEIGHTS_9, TITULO_ELEITOR_DV2_WEIGHTS, TITULO_ELEITOR_ETITULO_URL, TITULO_ELEITOR_EXTERIOR_UF_CODE, TITULO_ELEITOR_GOLDEN_EXTERIOR, TITULO_ELEITOR_GOLDEN_MASKED_INPUT, TITULO_ELEITOR_GOLDEN_PRIMARY, TITULO_ELEITOR_GOLDEN_SP_EXTENDED, TITULO_ELEITOR_GOLDEN_SP_SPECIAL, TITULO_ELEITOR_LENGTH, TITULO_ELEITOR_LENGTH_EXTENDED, TITULO_ELEITOR_NORMATIVE_SECONDARY_URL, TITULO_ELEITOR_NUMERIC_PATTERN_12, TITULO_ELEITOR_NUMERIC_PATTERN_13, TITULO_ELEITOR_OFFICIAL_SOURCE_URL, TITULO_ELEITOR_SEQUENTIAL_LENGTH, TITULO_ELEITOR_SEQUENTIAL_LENGTH_EXTENDED, TITULO_ELEITOR_SPECIAL_UF_CODES, TITULO_ELEITOR_TSE_PORTAL_URL, TITULO_ELEITOR_UF_BY_CODE, isValidTituloEleitor, validateTituloEleitor } from './chunk-6WBUKUHD.js';
+export { PLACA_GOLDEN_CONVERSION_FROM, PLACA_GOLDEN_CONVERSION_TO, PLACA_GOLDEN_LEGACY, PLACA_GOLDEN_MERCOSUL, PLACA_OFFICIAL_SOURCE_URL, convertPlacaToMercosul, detectPlacaFormat, isValidPlaca, isValidPlacaLegacy, isValidPlacaMercosul, validatePlaca } from './chunk-UG2YICWH.js';
 export { NFE_CHAVE_BASE_LENGTH, NFE_CHAVE_DFE_PORTAL_URL, NFE_CHAVE_GOLDEN_PRIMARY, NFE_CHAVE_GOLDEN_SECONDARY, NFE_CHAVE_LENGTH, NFE_CHAVE_MOC_DV_SECTION_URL, NFE_CHAVE_MOC_ONLINE_URL, NFE_CHAVE_MOC_PDF_URL, NFE_CHAVE_MOD, NFE_CHAVE_NFCE_QR_ILLUSTRATIVE, NFE_CHAVE_NFCE_QR_ILLUSTRATIVE_URL, NFE_CHAVE_NUMERIC_PATTERN, NFE_CHAVE_OFFICIAL_SOURCE_URL, NFE_CHAVE_WEIGHT_CYCLE, NFE_IBGE_UF_BY_CODE, NFE_IBGE_UF_CODES, NFE_MODELOS, NFE_MODELO_NFCE, NFE_MODELO_NFE, computeNfeChaveCheckDigit, computeNfeChaveWeightedSum, isValidNfeChave, isValidNfeChaveCheckDigit, parseNfeChave, parseNfeChaveParts, resolveNfeChaveCheckDigit, validateNfeChave } from './chunk-XRT44FMY.js';
 export { isValidPisPasep, stripPisPasep, validatePisPasep } from './chunk-HORKZQIH.js';
-export { PLACA_GOLDEN_CONVERSION_FROM, PLACA_GOLDEN_CONVERSION_TO, PLACA_GOLDEN_LEGACY, PLACA_GOLDEN_MERCOSUL, PLACA_OFFICIAL_SOURCE_URL, convertPlacaToMercosul, detectPlacaFormat, isValidPlaca, isValidPlacaLegacy, isValidPlacaMercosul, validatePlaca } from './chunk-BDYNBRT7.js';
 export { formatInscricaoEstadual, getIeOfficialSourceUrl, isValidInscricaoEstadual, stripInscricaoEstadual, validateIeDf, validateIeMt, validateIeSp, validateInscricaoEstadual } from './chunk-OHBSYBG7.js';
 export { IE_DF_GOLDEN, IE_DF_GOLDEN_MASKED, IE_DF_OFFICIAL_SOURCE_URL, IE_MT_GOLDEN_CANONICAL, IE_MT_GOLDEN_LEGACY, IE_MT_OFFICIAL_SOURCE_URL, IE_OFFICIAL_SOURCE_URLS, IE_SP_GOLDEN, IE_SP_GOLDEN_MASKED, IE_SP_OFFICIAL_SOURCE_URL, IE_SP_RURAL_GOLDEN, IE_SP_RURAL_GOLDEN_MASKED, IE_SP_RURAL_LENGTH, IE_SP_RURAL_OFFICIAL_SOURCE_URL, IE_SUPPORTED_UFS, getIeProdutorRuralOfficialSourceUrl, isSpRuralIeInput, isValidIeProdutorRural, stripIeSpRural, stripIeSpRural as stripInscricaoEstadualProdutorRural, validateIeProdutorRural, validateIeSpRural } from './chunk-FGOPYU2L.js';
 import './chunk-GFRG6ZPY.js';
 export { EAN_13_LENGTH, EAN_8_LENGTH, EAN_GOLDEN_13, EAN_GOLDEN_13_MASKED, EAN_GOLDEN_8, EAN_GOLDEN_8_MASKED, EAN_OFFICIAL_SOURCE_URL, applyEanMask, computeGs1Modulo10CheckDigit, computeGs1Modulo10Sum, detectEanFormat, isValidEan, isValidGs1Modulo10, passesGs1Modulo10, stripEan, validateEan } from './chunk-OFAU4VTU.js';
-export { CEP_FAIXA_CNEFE_BASE_URL, CEP_FAIXA_DATA_VERSION, CEP_FAIXA_GOLDEN_PREFIX_RJ, CEP_FAIXA_GOLDEN_PREFIX_SP, CEP_FAIXA_MAX_PREFIXES, CEP_FAIXA_MIN_PREFIXES, CEP_GOLDEN_PRIMARY, CEP_GOLDEN_PRIMARY_MASKED, CEP_GOLDEN_SECONDARY, CEP_OFFICIAL_SOURCE_URL, getCepFaixaInfo, getCepFaixas, isValidCep, validateCep } from './chunk-55IZCKNL.js';
+export { CEP_FAIXA_CNEFE_BASE_URL, CEP_FAIXA_DATA_VERSION, CEP_FAIXA_GOLDEN_PREFIX_RJ, CEP_FAIXA_GOLDEN_PREFIX_SP, CEP_FAIXA_MAX_PREFIXES, CEP_FAIXA_MIN_PREFIXES, CEP_GOLDEN_PRIMARY, CEP_GOLDEN_PRIMARY_MASKED, CEP_GOLDEN_SECONDARY, CEP_OFFICIAL_SOURCE_URL, getCepFaixaInfo, getCepFaixas, isValidCep, validateCep } from './chunk-C4E2AE2A.js';
 import './chunk-RY2BSDOR.js';
-export { CNH_BASE_LENGTH, CNH_DV1_WEIGHTS, CNH_DV2_WEIGHTS, CNH_GOLDEN_DISCOUNT_CASE, CNH_GOLDEN_PRIMARY, CNH_GOLDEN_PRIMARY_DECORATED_INPUT, CNH_GOLDEN_SECONDARY, CNH_LENGTH, CNH_OFFICIAL_SOURCE_URL, CNH_SENATRAN_VALIDAR_URL, isValidCnh, validateCnh } from './chunk-DL4TSGE5.js';
-export { stripCep, stripCnh, stripPlaca, stripRenavam, stripTituloEleitor } from './chunk-YYHS5WQN.js';
+export { CNH_BASE_LENGTH, CNH_DV1_WEIGHTS, CNH_DV2_WEIGHTS, CNH_GOLDEN_DISCOUNT_CASE, CNH_GOLDEN_PRIMARY, CNH_GOLDEN_PRIMARY_DECORATED_INPUT, CNH_GOLDEN_SECONDARY, CNH_LENGTH, CNH_OFFICIAL_SOURCE_URL, CNH_SENATRAN_VALIDAR_URL, isValidCnh, validateCnh } from './chunk-JZOS2MO7.js';
+export { stripCep, stripCnh, stripPlaca, stripRenavam, stripTituloEleitor } from './chunk-6BWOYNQD.js';
 export { stripNfeChave } from './chunk-4SNBZFS5.js';
+export { stripPixKey } from './chunk-JUQMINSZ.js';
 export { PIS_PASEP_GOLDEN_PRIMARY, PIS_PASEP_GOLDEN_PRIMARY_MASKED, PIS_PASEP_GOLDEN_SECONDARY, PIS_PASEP_OFFICIAL_SOURCE_URL } from './chunk-W64OQYC4.js';
 import './chunk-KBNWI6GE.js';
 import { formatBoleto } from './chunk-S6ER3Y3B.js';
@@ -72,13 +73,13 @@ export { convertCodigoBarrasToLinhaDigitavel, convertLinhaToCodigoBarras, isVali
 export { computeArrecadacaoModulo11Dv, isValidArrecadacao, linhaArrecadacaoToCodigoBarras, stripArrecadacao, stripCodigoBarras, validateArrecadacao, validateArrecadacaoCodigoBarras, validateArrecadacaoLinha, validateCodigoBarras } from './chunk-UB2ZUHQZ.js';
 export { BOLETO_ARRECADACAO_CODIGO_BARRAS_LENGTH, BOLETO_ARRECADACAO_LINHA_LENGTH, BOLETO_ARRECADACAO_OFFICIAL_SOURCE_URL, BOLETO_ARRECADACAO_PRODUCT_ID, BOLETO_CODE_ISPB_HOLDER, BOLETO_CODIGO_BARRAS_LENGTH, BOLETO_CURRENCY_ISPB, BOLETO_CURRENCY_REAL, BOLETO_GOLDEN_CODIGO_BARRAS, BOLETO_GOLDEN_CODIGO_BARRAS_BB, BOLETO_GOLDEN_CODIGO_BARRAS_SITUACAO2, BOLETO_GOLDEN_LINHA_BB_STRIPPED, BOLETO_GOLDEN_LINHA_MASKED, BOLETO_GOLDEN_LINHA_SITUACAO2_STRIPPED, BOLETO_GOLDEN_LINHA_STRIPPED, BOLETO_LAYOUTS_PORTAL_URL, BOLETO_LINHA_LENGTH, BOLETO_OFFICIAL_SOURCE_URL, applyLinhaDigitavelMask, computeModulo10FieldDv as computeArrecadacaoModulo10Dv, computeModulo10FieldDv, computeModulo11BarcodeDv, convertCodigoBarrasToLinhaDigits, convertLinhaToCodigoBarrasDigits, detectBoletoInputKind, detectBoletoSituacao, formatLinhaDigitavel, stripLinhaDigitavel, validateLinhaDigitavel } from './chunk-7U64V3YD.js';
 import './chunk-RYGAK7PB.js';
-export { BRCODE_GOLDEN_COMPOSITE, BRCODE_GOLDEN_DYNAMIC_URL, BRCODE_GOLDEN_STATIC_CPF, BRCODE_GOLDEN_STATIC_EMAIL, BRCODE_GOLDEN_STATIC_EVP, BRCODE_OFFICIAL_SOURCE_URL, BRCODE_PIX_INITIATION_MANUAL_URL, buildStaticPixBrCode, computeCrc16Ccitt, findPixMerchantAccount, findTlvField, isValidBrCode, normalizeBrCodePayload, parseBrCode, parseBrCodePayload, parseTlvSequence, validateBrCode, verifyBrCodeCrc } from './chunk-UNBIJPJU.js';
-export { PIX_DICT_API_SOURCE_URL, PIX_GOLDEN_CNPJ_ALPHANUMERIC, PIX_GOLDEN_CNPJ_NUMERIC, PIX_GOLDEN_CPF, PIX_GOLDEN_EMAIL, PIX_GOLDEN_EVP, PIX_GOLDEN_PHONE, PIX_OFFICIAL_SOURCE_URL, detectPixKeyType, isValidPixKey, validatePixCnpjKey, validatePixCpfKey, validatePixEmailKey, validatePixEvpKey, validatePixKey, validatePixPhoneKey } from './chunk-DS6MOO5K.js';
-import './chunk-VBFKN3NR.js';
-export { CPF_GOLDEN_PRIMARY, CPF_GOLDEN_PRIMARY_MASKED, CPF_GOLDEN_SECONDARY, CPF_OFFICIAL_SOURCE_URL, isValidCpf, validateCpf } from './chunk-W5LOXC7J.js';
+export { BRCODE_GOLDEN_COMPOSITE, BRCODE_GOLDEN_DYNAMIC_URL, BRCODE_GOLDEN_STATIC_CPF, BRCODE_GOLDEN_STATIC_EMAIL, BRCODE_GOLDEN_STATIC_EVP, BRCODE_OFFICIAL_SOURCE_URL, BRCODE_PIX_INITIATION_MANUAL_URL, buildStaticPixBrCode, computeCrc16Ccitt, findPixMerchantAccount, findTlvField, isValidBrCode, normalizeBrCodePayload, parseBrCode, parseBrCodePayload, parseTlvSequence, validateBrCode, verifyBrCodeCrc } from './chunk-L3WG36Y4.js';
+export { isValidPixKey, validatePixCnpjKey, validatePixCpfKey, validatePixEmailKey, validatePixEvpKey, validatePixKey, validatePixPhoneKey } from './chunk-7XVCTDJE.js';
+export { CPF_GOLDEN_PRIMARY, CPF_GOLDEN_PRIMARY_MASKED, CPF_GOLDEN_SECONDARY, CPF_OFFICIAL_SOURCE_URL, isValidCpf, validateCpf } from './chunk-DQQNXXGO.js';
+export { PIX_DICT_API_SOURCE_URL, PIX_GOLDEN_CNPJ_ALPHANUMERIC, PIX_GOLDEN_CNPJ_NUMERIC, PIX_GOLDEN_CPF, PIX_GOLDEN_EMAIL, PIX_GOLDEN_EVP, PIX_GOLDEN_PHONE, PIX_OFFICIAL_SOURCE_URL, detectPixKeyType } from './chunk-FA5ZM5UA.js';
 export { stripCpf } from './chunk-UCJPSJN5.js';
-import './chunk-RUQDVHR7.js';
-export { CNPJ_GOLDEN_ALPHANUMERIC, CNPJ_GOLDEN_ALPHANUMERIC_MASKED, CNPJ_GOLDEN_NUMERIC, CNPJ_GOLDEN_NUMERIC_MASKED, CNPJ_OFFICIAL_SOURCE_URL, detectCnpjFormat, isValidCnpj, isValidCnpjAlphanumeric, isValidCnpjNumeric, validateCnpj } from './chunk-2RZXK6C3.js';
+export { isValidCnpj, isValidCnpjAlphanumeric, isValidCnpjNumeric, validateCnpj } from './chunk-MGFDTECS.js';
+export { CNPJ_GOLDEN_ALPHANUMERIC, CNPJ_GOLDEN_ALPHANUMERIC_MASKED, CNPJ_GOLDEN_NUMERIC, CNPJ_GOLDEN_NUMERIC_MASKED, CNPJ_OFFICIAL_SOURCE_URL, detectCnpjFormat } from './chunk-LLJSXMO2.js';
 export { stripCnpj } from './chunk-EB3G4IG6.js';
 import './chunk-OTZHMJYE.js';
 import './chunk-CQPM43VV.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/format/document.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BO,IAAM,0BAAA,GAA6B;AAAA,EACxC,KAAA;AAAA,EACA,MAAA;AAAA,EACA,KAAA;AAAA,EACA,OAAA;AAAA,EACA,WAAA;AAAA,EACA,KAAA;AAAA,EACA,QAAA;AAAA,EACA,gBAAA;AAAA,EACA;AACF;AAEO,SAAS,0BAA0B,IAAA,EAA+C;AACvF,EAAA,OAAQ,0BAAA,CAAiD,SAAS,IAAI,CAAA;AACxE;AAEO,SAAS,cAAA,CAAe,MAA+B,KAAA,EAA6B;AACzF,EAAA,QAAQ,IAAA;AAAM,IACZ,KAAK,KAAA;AACH,MAAA,OAAO,UAAU,KAAK,CAAA;AAAA,IACxB,KAAK,MAAA;AACH,MAAA,OAAO,WAAW,KAAK,CAAA;AAAA,IACzB,KAAK,KAAA;AACH,MAAA,OAAO,UAAU,KAAK,CAAA;AAAA,IACxB,KAAK,OAAA;AACH,MAAA,OAAO,YAAY,KAAK,CAAA;AAAA,IAC1B,KAAK,WAAA;AACH,MAAA,OAAO,eAAe,KAAK,CAAA;AAAA,IAC7B,KAAK,KAAA;AACH,MAAA,OAAO,aAAa,KAAK,CAAA;AAAA,IAC3B,KAAK,QAAA;AACH,MAAA,OAAO,aAAa,KAAK,CAAA;AAAA,IAC3B,KAAK,gBAAA;AACH,MAAA,OAAO,oBAAoB,KAAK,CAAA;AAAA,IAClC,KAAK,KAAA;AACH,MAAA,OAAO,UAAU,KAAK,CAAA;AAAA;AAE5B;AAGO,SAAS,qBAAA,CAAsB,MAAc,KAAA,EAA6B;AAC/E,EAAA,IAAI,CAAC,yBAAA,CAA0B,IAAI,CAAA,EAAG;AACpC,IAAA,OAAO,EAAE,IAAI,KAAA,EAAO,IAAA,EAAM,sBAAsB,OAAA,EAAS,CAAA,uBAAA,EAA0B,IAAI,CAAA,CAAA,EAAG;AAAA,EAC5F;AACA,EAAA,OAAO,cAAA,CAAe,MAAM,KAAK,CAAA;AACnC","file":"index.js","sourcesContent":["/**\n * Format decorator — union entrypoint (UC-003).\n * @see docs/use-cases/UC-003-format-document.md\n */\nimport type { FormatResult } from '../types/validation-result.js';\nimport { formatBoleto } from './boleto.js';\nimport { formatCartaoCredito } from './cartao-credito.js';\nimport { formatEan } from './ean.js';\nimport { formatCep } from './cep.js';\nimport { formatCnpj } from './cnpj.js';\nimport { formatCpf } from './cpf.js';\nimport { formatPisPasep } from './pis-pasep.js';\nimport { formatPixKey } from './pix.js';\nimport { formatPlaca } from './placa.js';\n\nexport type FormattableDocumentType =\n  | 'cpf'\n  | 'cnpj'\n  | 'cep'\n  | 'placa'\n  | 'pis-pasep'\n  | 'pix'\n  | 'boleto'\n  | 'cartao-credito'\n  | 'ean';\n\nexport const FORMATTABLE_DOCUMENT_TYPES = [\n  'cpf',\n  'cnpj',\n  'cep',\n  'placa',\n  'pis-pasep',\n  'pix',\n  'boleto',\n  'cartao-credito',\n  'ean',\n] as const satisfies readonly FormattableDocumentType[];\n\nexport function isFormattableDocumentType(type: string): type is FormattableDocumentType {\n  return (FORMATTABLE_DOCUMENT_TYPES as readonly string[]).includes(type);\n}\n\nexport function formatDocument(type: FormattableDocumentType, input: string): FormatResult {\n  switch (type) {\n    case 'cpf':\n      return formatCpf(input);\n    case 'cnpj':\n      return formatCnpj(input);\n    case 'cep':\n      return formatCep(input);\n    case 'placa':\n      return formatPlaca(input);\n    case 'pis-pasep':\n      return formatPisPasep(input);\n    case 'pix':\n      return formatPixKey(input);\n    case 'boleto':\n      return formatBoleto(input);\n    case 'cartao-credito':\n      return formatCartaoCredito(input);\n    case 'ean':\n      return formatEan(input);\n  }\n}\n\n/** Runtime guard for dynamic callers (non-exhaustive type string). */\nexport function formatDocumentRuntime(type: string, input: string): FormatResult {\n  if (!isFormattableDocumentType(type)) {\n    return { ok: false, code: 'UNSUPPORTED_FORMAT', message: `Unknown document type: ${type}` };\n  }\n  return formatDocument(type, input);\n}\n"]}
+{"version":3,"sources":["../src/format/document.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BO,IAAM,0BAAA,GAA6B;AAAA,EACxC,KAAA;AAAA,EACA,MAAA;AAAA,EACA,KAAA;AAAA,EACA,OAAA;AAAA,EACA,WAAA;AAAA,EACA,KAAA;AAAA,EACA,QAAA;AAAA,EACA,gBAAA;AAAA,EACA;AACF;AAEO,SAAS,0BAA0B,IAAA,EAA+C;AACvF,EAAA,OAAQ,0BAAA,CAAiD,SAAS,IAAI,CAAA;AACxE;AAEO,SAAS,cAAA,CAAe,MAA+B,KAAA,EAA6B;AACzF,EAAA,QAAQ,IAAA;AAAM,IACZ,KAAK,KAAA;AACH,MAAA,OAAO,UAAU,KAAK,CAAA;AAAA,IACxB,KAAK,MAAA;AACH,MAAA,OAAO,WAAW,KAAK,CAAA;AAAA,IACzB,KAAK,KAAA;AACH,MAAA,OAAO,UAAU,KAAK,CAAA;AAAA,IACxB,KAAK,OAAA;AACH,MAAA,OAAO,YAAY,KAAK,CAAA;AAAA,IAC1B,KAAK,WAAA;AACH,MAAA,OAAO,eAAe,KAAK,CAAA;AAAA,IAC7B,KAAK,KAAA;AACH,MAAA,OAAO,aAAa,KAAK,CAAA;AAAA,IAC3B,KAAK,QAAA;AACH,MAAA,OAAO,aAAa,KAAK,CAAA;AAAA,IAC3B,KAAK,gBAAA;AACH,MAAA,OAAO,oBAAoB,KAAK,CAAA;AAAA,IAClC,KAAK,KAAA;AACH,MAAA,OAAO,UAAU,KAAK,CAAA;AAAA;AAE5B;AAGO,SAAS,qBAAA,CAAsB,MAAc,KAAA,EAA6B;AAC/E,EAAA,IAAI,CAAC,yBAAA,CAA0B,IAAI,CAAA,EAAG;AACpC,IAAA,OAAO,EAAE,IAAI,KAAA,EAAO,IAAA,EAAM,sBAAsB,OAAA,EAAS,CAAA,uBAAA,EAA0B,IAAI,CAAA,CAAA,EAAG;AAAA,EAC5F;AACA,EAAA,OAAO,cAAA,CAAe,MAAM,KAAK,CAAA;AACnC","file":"index.js","sourcesContent":["/**\n * Format decorator — union entrypoint (UC-003).\n * @see docs/use-cases/UC-003-format-document.md\n */\nimport type { FormatResult } from '../types/validation-result.js';\nimport { formatBoleto } from './boleto.js';\nimport { formatCartaoCredito } from './cartao-credito.js';\nimport { formatEan } from './ean.js';\nimport { formatCep } from './cep.js';\nimport { formatCnpj } from './cnpj.js';\nimport { formatCpf } from './cpf.js';\nimport { formatPisPasep } from './pis-pasep.js';\nimport { formatPixKey } from './pix.js';\nimport { formatPlaca } from './placa.js';\n\nexport type FormattableDocumentType =\n  | 'cpf'\n  | 'cnpj'\n  | 'cep'\n  | 'placa'\n  | 'pis-pasep'\n  | 'pix'\n  | 'boleto'\n  | 'cartao-credito'\n  | 'ean';\n\nexport const FORMATTABLE_DOCUMENT_TYPES = [\n  'cpf',\n  'cnpj',\n  'cep',\n  'placa',\n  'pis-pasep',\n  'pix',\n  'boleto',\n  'cartao-credito',\n  'ean',\n] as const satisfies readonly FormattableDocumentType[];\n\nexport function isFormattableDocumentType(type: string): type is FormattableDocumentType {\n  return (FORMATTABLE_DOCUMENT_TYPES as readonly string[]).includes(type);\n}\n\nexport function formatDocument(type: FormattableDocumentType, input: string): FormatResult {\n  switch (type) {\n    case 'cpf':\n      return formatCpf(input);\n    case 'cnpj':\n      return formatCnpj(input);\n    case 'cep':\n      return formatCep(input);\n    case 'placa':\n      return formatPlaca(input);\n    case 'pis-pasep':\n      return formatPisPasep(input);\n    case 'pix':\n      return formatPixKey(input);\n    case 'boleto':\n      return formatBoleto(input);\n    case 'cartao-credito':\n      return formatCartaoCredito(input);\n    case 'ean':\n      return formatEan(input);\n  }\n}\n\n/** Runtime guard for dynamic callers (non-exhaustive type string). */\nexport function formatDocumentRuntime(type: string, input: string): FormatResult {\n  if (!isFormattableDocumentType(type)) {\n    return { ok: false, code: 'UNSUPPORTED_FORMAT', message: `Unknown document type: ${type}` };\n  }\n  return formatDocument(type, input);\n}\n"]}

package/dist/iss-municipal.d.ts

@@ -11,7 +11,15 @@ interface IssMunicipalRow {
     estimativa: boolean;
     pibRank: number | null;
 }
+/** Provenance of the embedded ISS alíquota row — do not use `'estimativa'` or `'munic-ibge'` for NFSe emission. */
+type IssMunicipalFonte = 'oficial' | 'munic-ibge' | 'estimativa';
 interface IssMunicipalResult extends IssMunicipalRow {
+    /**
+     * `'oficial'` — capital seed with verified municipal legislation URL.
+     * `'munic-ibge'` — MUNIC/IBGE municipal profile fallback (LC 116 legal band; not exact municipal rate).
+     * `'estimativa'` — LC 116 Art. 8 band fallback; not verified municipal legislation.
+     */
+    fonte: IssMunicipalFonte;
     warning: string;
 }
 interface IssMunicipalDataVersion {
@@ -33,19 +41,69 @@ interface IssMunicipalDataVersion {
 }
 
 /**
- * Municipal ISS alíquota lookup — partial embed (capitals + top PIB ~100).
+ * Municipal ISS alíquota lookup — partial embed (capitals + top PIB ~500).
  * @see docs/OFFICIAL-SOURCES.md#iss-municipal
  */
 
 /** Returns every embedded ISS municipal row (in-memory reference, not a copy). */
 declare function getAllIssMunicipal(): readonly IssMunicipalRow[];
+/** Returns UFs present in the partial embed, sorted alphabetically. */
+declare function getIssMunicipalUfsDisponiveis(): readonly string[];
 declare function getIssMunicipalPorIbge(codigo: number | string): IssMunicipalResult | undefined;
+declare function getIssMunicipalPorUf(uf: string): readonly IssMunicipalResult[];
 declare function getIssMunicipalPorUfMunicipio(uf: string, nome: string): IssMunicipalResult | undefined;
 declare function searchIssMunicipal(query: string, options?: {
+    uf?: string;
     limit?: number;
 }): readonly IssMunicipalResult[];
 
+/** Compact MUNIC/IBGE fallback row — municipalities outside the 500-row partial embed. */
+interface IssMunicIbgeRow {
+    codigoIbge: number;
+    nome: string;
+    uf: string;
+    aliquotaMin: number;
+    aliquotaMax: number;
+    municAnoPesquisa: number;
+}
+interface IssMunicIbgeDataVersion {
+    id: 'iss-munic-ibge';
+    municAnoPesquisa: number;
+    municBaseUrl: string;
+    municPesquisaUrl: string;
+    issSidraTableId: number | null;
+    nota: string;
+    capturadoEm: string;
+    contagens: {
+        municipios: number;
+    };
+    documentacao: string;
+}
+
+/**
+ * ISS municipal cascade lookup — 500 embed → MUNIC/IBGE → LC 116.
+ * @see docs/OFFICIAL-SOURCES.md#iss-munic-ibge
+ */
+
+/** Returns MUNIC/IBGE fallback row for IBGE codes outside the 500-row partial embed. */
+declare function getIssMunicIbgePorIbge(codigo: number | string): IssMunicipalResult | undefined;
+/**
+ * Cascade lookup: partial 500 embed → MUNIC/IBGE fallback → LC 116 generic band.
+ * Returns `undefined` only for invalid IBGE input or unknown municipality code.
+ */
+declare function lookupIssMunicipalPorIbge(codigo: number | string): IssMunicipalResult | undefined;
+/** LC 116 fallback when municipality exists in IBGE localities but not yet in MUNIC embed. */
+declare function resolveIbgeLc116Fallback(normalizedIbge: number): IssMunicipalResult | undefined;
+/** Returns every MUNIC/IBGE fallback row (in-memory reference, not a copy). */
+declare function getAllIssMunicIbge(): readonly IssMunicIbgeRow[];
+/** Count of municipalities in the MUNIC/IBGE fallback embed. */
+declare function getIssMunicIbgeCount(): number;
+
+declare function resolveIssMunicipalFonte(estimativa: boolean): IssMunicipalFonte;
 declare function buildIssMunicipalResult(row: IssMunicipalRow): IssMunicipalResult;
+declare function buildIssMunicIbgeResult(row: IssMunicIbgeRow): IssMunicipalResult;
+type Lc116EstimativaInput = Omit<IssMunicipalRow, 'estimativa' | 'pibRank'>;
+declare function buildLc116EstimativaResult(row: Lc116EstimativaInput): IssMunicipalResult;
 
 /**
  * Municipal ISS alíquota constants — partial embed (estimation only).
@@ -57,7 +115,7 @@ declare const IBGE_PIB_MUNICIPAL_URL = "https://www.ibge.gov.br/estatisticas/eco
 declare const IBGE_MUNICIPIO_CODES_URL = "https://www.ibge.gov.br/explica/codigos-dos-municipios.php";
 declare const CNM_LEGISLACAO_URL = "https://www.cnm.org.br/";
 declare const NFSE_NACIONAL_URL = "https://www.gov.br/nfse/pt-br";
-declare const ISS_MUNICIPAL_TARGET_COUNT = 100;
+declare const ISS_MUNICIPAL_TARGET_COUNT = 500;
 declare const ISS_MUNICIPAL_CAPITAL_COUNT = 27;
 declare const ISS_MUNICIPAL_LC116_MIN = 2;
 declare const ISS_MUNICIPAL_LC116_MAX = 5;
@@ -67,9 +125,19 @@ declare const ISS_MUNICIPAL_GOLDEN_SAO_PAULO = 3550308;
 declare const ISS_MUNICIPAL_GOLDEN_RIO = 3304557;
 /** Golden municipality — Belo Horizonte capital (IBGE 3106200). */
 declare const ISS_MUNICIPAL_GOLDEN_BELO_HORIZONTE = 3106200;
+/** Golden municipality — Campinas high-PIB non-capital (IBGE 3509502). */
+declare const ISS_MUNICIPAL_GOLDEN_CAMPINAS = 3509502;
+declare const IBGE_SIDRA_PIB_URL = "https://apisidra.ibge.gov.br/values/t/5938/n6/all/v/37/p/2022";
+declare const IBGE_MUNIC_PESQUISA_URL = "https://www.ibge.gov.br/estatisticas/economicas/contabilidade/9078-pesquisa-de-informacoes-municipais.html";
+declare const IBGE_MUNIC_BASE_2024_URL = "https://ftp.ibge.gov.br/Perfil_Municipios/2024/Base_de_Dados/Base_MUNIC_2024_20251107.xlsx";
+/** Golden municipality — Acrelândia/AC (not in 500-row embed; MUNIC fallback). */
+declare const ISS_MUNIC_GOLDEN_ACRELANDIA = 1200013;
 declare const ISS_MUNICIPAL_ESTIMATION_WARNING: string;
+declare const ISS_MUNIC_IBGE_WARNING: string;
 declare const ISS_MUNICIPAL_METADATA_ESTIMATIVA = true;
 
 declare const ISS_MUNICIPAL_DATA_VERSION: IssMunicipalDataVersion;
 
-export { CNM_LEGISLACAO_URL, IBGE_MUNICIPIO_CODES_URL, IBGE_PIB_MUNICIPAL_URL, ISS_MUNICIPAL_CAPITAL_COUNT, ISS_MUNICIPAL_DATA_VERSION, ISS_MUNICIPAL_ESTIMATION_WARNING, ISS_MUNICIPAL_GOLDEN_BELO_HORIZONTE, ISS_MUNICIPAL_GOLDEN_RIO, ISS_MUNICIPAL_GOLDEN_SAO_PAULO, ISS_MUNICIPAL_LC116_MAX, ISS_MUNICIPAL_LC116_MIN, ISS_MUNICIPAL_METADATA_ESTIMATIVA, ISS_MUNICIPAL_TARGET_COUNT, type IssMunicipalDataVersion, type IssMunicipalResult, type IssMunicipalRow, NFSE_NACIONAL_URL, PLANALTO_LC116_ART8_URL, PLANALTO_LC116_URL, buildIssMunicipalResult, getAllIssMunicipal, getIssMunicipalPorIbge, getIssMunicipalPorUfMunicipio, searchIssMunicipal };
+declare const ISS_MUNIC_IBGE_DATA_VERSION: IssMunicIbgeDataVersion;
+
+export { CNM_LEGISLACAO_URL, IBGE_MUNICIPIO_CODES_URL, IBGE_MUNIC_BASE_2024_URL, IBGE_MUNIC_PESQUISA_URL, IBGE_PIB_MUNICIPAL_URL, IBGE_SIDRA_PIB_URL, ISS_MUNICIPAL_CAPITAL_COUNT, ISS_MUNICIPAL_DATA_VERSION, ISS_MUNICIPAL_ESTIMATION_WARNING, ISS_MUNICIPAL_GOLDEN_BELO_HORIZONTE, ISS_MUNICIPAL_GOLDEN_CAMPINAS, ISS_MUNICIPAL_GOLDEN_RIO, ISS_MUNICIPAL_GOLDEN_SAO_PAULO, ISS_MUNICIPAL_LC116_MAX, ISS_MUNICIPAL_LC116_MIN, ISS_MUNICIPAL_METADATA_ESTIMATIVA, ISS_MUNICIPAL_TARGET_COUNT, ISS_MUNIC_GOLDEN_ACRELANDIA, ISS_MUNIC_IBGE_DATA_VERSION, ISS_MUNIC_IBGE_WARNING, type IssMunicIbgeDataVersion, type IssMunicIbgeRow, type IssMunicipalDataVersion, type IssMunicipalFonte, type IssMunicipalResult, type IssMunicipalRow, NFSE_NACIONAL_URL, PLANALTO_LC116_ART8_URL, PLANALTO_LC116_URL, buildIssMunicIbgeResult, buildIssMunicipalResult, buildLc116EstimativaResult, getAllIssMunicIbge, getAllIssMunicipal, getIssMunicIbgeCount, getIssMunicIbgePorIbge, getIssMunicipalPorIbge, getIssMunicipalPorUf, getIssMunicipalPorUfMunicipio, getIssMunicipalUfsDisponiveis, lookupIssMunicipalPorIbge, resolveIbgeLc116Fallback, resolveIssMunicipalFonte, searchIssMunicipal };