@br-validators/core 0.12.0-alpha.3 → 1.0.0

package/README.md

@@ -25,7 +25,7 @@ Every Brazilian SaaS eventually reinvents CPF validation — usually wrong.
 (Receita Federal, Bacen, CONTRAN, TSE, SEFAZ, FEBRABAN, Anatel) so you don't have to.
 
 - ✅ **CNPJ alfanumérico** — new RFB format (effective July 2026), ready now
-- ✅ **18 document types** — CPF, CNPJ, CEP, NF-e chave, BR Code PIX, boleto, CNH, RENAVAM, placa, PIS/PASEP, PIX key, cartão de crédito, IE (27 UFs), IE produtor rural, título de eleitor, telefone, + platform APIs
+- ✅ **18+ document types** — CPF, CNPJ, CEP, NF-e chave, BR Code PIX, boleto (cobrança + arrecadação), CNH, RENAVAM, placa, PIS/PASEP, PIX key, cartão de crédito, IE (27 UFs), IE produtor rural, título de eleitor, telefone, + platform APIs above
 - ✅ **Zero runtime dependencies** — pure TypeScript logic, no HTTP calls
 - ✅ **Never throws** — every function returns `{ ok: true, value } | { ok: false, message, code }`
 - ✅ **Tree-shakeable** — subpath imports per document type
@@ -93,9 +93,16 @@ generate('cnh');
 generate('inscricao-estadual', { uf: 'SP', seed: 42 });
 generate('titulo-eleitor', { uf: 'SC', seed: 42 });
 generate('cartao-credito', { brand: 'visa', seed: 42 });
+generate('pix', { seed: 42 });           // EVP UUID — Bacen DICT
+generate('nfe-chave', { seed: 42 });     // MOC §2.2.6 modulo-11 DV
+generate('brcode', { seed: 42 });        // static PIX EMV + CRC16
+generate('boleto', { masked: true });    // FEBRABAN cobrança Situação 1
+generate('boleto-arrecadacao');          // FEBRABAN Layout v7
+generate('inscricao-estadual-produtor-rural', { masked: true }); // SP SINTEGRA Bloco II
 ```
 
-> `generate()` is for test fixtures and seed data only — never use in production.
+> `generate()` is for test fixtures and seed data only — never use in production.  
+> Alphanumeric CPF: `generate('cpf', { format: 'alphanumeric' })` throws `CPF_ALPHA_SPEC_PENDING` until RFB publishes the official algorithm ([OFFICIAL-SOURCES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/OFFICIAL-SOURCES.md)).
 
 ### ETL / data cleanup
 
@@ -121,12 +128,66 @@ const result = validateNfeChave('52060433009911002506550120000007800267301615');
 ### BR Code (PIX QR payload)
 
 ```typescript
-import { validateBrCode, parseBrCode } from '@br-validators/core/brcode';
-
-parseBrCode('00020126580014br.gov.bcb.pix0136...');
+import {
+  buildStaticPixBrCode,
+  parseBrCode,
+  validateBrCode,
+} from '@br-validators/core/brcode';
+
+// Permanent static QR (no amount — payer sets value at payment time)
+const payload = buildStaticPixBrCode({
+  pixKey: 'pix@bcb.gov.br',
+  merchantName: 'Fulano de Tal',
+  merchantCity: 'BRASILIA',
+});
+validateBrCode(payload).ok; // true
+
+// Fixed-value static QR
+buildStaticPixBrCode({
+  pixKey: 'pix@bcb.gov.br',
+  merchantName: 'Fulano de Tal',
+  merchantCity: 'BRASILIA',
+  amount: '10.50',
+});
+
+parseBrCode(payload);
 // { ok: true, pixKey, pixKeyType, merchantName, merchantCity, amount, txid }
 ```
 
+**Playground:** [doc-raiz-playground.vercel.app/pix](https://doc-raiz-playground.vercel.app/pix) renders the QR image from `buildStaticPixBrCode` output. Official sources: [Bacen Manual BR Code](https://www.bcb.gov.br/content/estabilidadefinanceira/spb_docs/ManualBRCode.pdf) · [Manual de Padrões PIX](https://www.bcb.gov.br/content/estabilidadefinanceira/pix/Regulamento_Pix/II_ManualdePadroesparaIniciacaodoPix.pdf).
+
+### Boleto — cobrança + arrecadação
+
+```typescript
+import { validateBoleto, validateArrecadacao } from '@br-validators/core/boleto';
+
+validateBoleto('03399.02579 08991.834006 71742.301014 6 14500000099668');
+// cobrança Situação 1/2 — FEBRABAN FB-0061/2021
+
+validateArrecadacao('846300000003812345678906123456789015234567890129');
+// arrecadação 48-digit — FEBRABAN Layout v7
+```
+
+### Platform APIs — mask, compare, batch, diff
+
+```typescript
+import { mask, compare, batch, diff } from '@br-validators/core';
+
+mask('12345678909', 'cpf');
+// { ok: true, formatted: '123.456.789-09' }
+
+compare('123.456.789-09', '12345678909', 'cpf');
+// { equal: true }
+
+batch(['12345678909', 'invalid'], 'cpf');
+// { valid: [...], invalid: [...], summary: { total: 2, valid: 1, invalid: 1 } }
+
+diff('12345678909', '12345678901', 'cpf');
+// { changed: true, fields: [{ field: 'dv', a: '09', b: '01' }] }
+```
+
+Per-type rules and official sources: [docs/OFFICIAL-SOURCES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/OFFICIAL-SOURCES.md) · API contract: [docs/LIBRARY-API.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/LIBRARY-API.md)
+
 ### Form handler (React / Next.js)
 
 ```typescript
@@ -156,8 +217,12 @@ br-validators cnpj validate "$CNPJ" --quiet || exit 1
 br-validators ie validate "$IE" --uf SP --json
 br-validators detect '123.456.789-09' --json
 br-validators generate cpf --seed 42 --masked
-br-validators generate inscricao-estadual --uf SP --seed 42
-br-validators generate cartao-credito --brand visa --seed 42
+br-validators generate pix --seed 42
+br-validators generate nfe-chave --seed 42
+br-validators generate brcode --seed 42
+br-validators generate boleto --masked --seed 42
+br-validators generate boleto-arrecadacao --seed 42
+br-validators generate inscricao-estadual-produtor-rural --masked --seed 42
 ```
 
 ---
@@ -176,15 +241,21 @@ br-validators generate cartao-credito --brand visa --seed 42
 | Placa (Mercosul + legada) | `@br-validators/core/placa` | `br-validators placa …` | `/placa` |
 | PIS / PASEP / NIS | `@br-validators/core/pis-pasep` | `br-validators pis-pasep …` | `/pis` |
 | PIX key | `@br-validators/core/pix` | `br-validators pix …` | `/pix` |
-| BR Code (PIX QR payload) | `@br-validators/core/brcode` | `br-validators brcode …` | `/brcode` |
-| Boleto (Situação 1 + 2) | `@br-validators/core/boleto` | `br-validators boleto …` | `/boleto` |
+| BR Code (PIX QR payload + builder) | `@br-validators/core/brcode` | `br-validators brcode …` | `/brcode` |
+| Boleto cobrança (Situação 1 + 2) | `@br-validators/core/boleto` | `br-validators boleto …` | `/boleto` |
+| Boleto arrecadação (48/44) | `@br-validators/core/boleto` | `br-validators boleto …` | `/boleto` |
 | NF-e / NFC-e chave (44 digits) | `@br-validators/core/nfe-chave` | `br-validators nfe-chave …` | `/nfe-chave` |
 | Cartão de crédito (Luhn) | `@br-validators/core/cartao-credito` | `br-validators cartao …` | `/cartao-credito` |
 | Inscrição Estadual (27 UFs) | `@br-validators/core/inscricao-estadual` | `br-validators ie … --uf SP` | `/ie` |
-| IE Produtor Rural | `@br-validators/core/inscricao-estadual-produtor-rural` | `br-validators ie …` (auto-detect `P` prefix) | `/ie` |
+| IE Produtor Rural | `@br-validators/core/inscricao-estadual-produtor-rural` | `br-validators ie …` (auto `P`) | `/ie` |
 | **detect()** | `@br-validators/core/detect` | `br-validators detect …` | `/detect` |
 | **sanitize()** | `@br-validators/core/sanitize` | `br-validators sanitize …` | `/sanitize` |
+| **mask()** | `@br-validators/core/mask` | — | via per-type `format` |
+| **compare()** | `@br-validators/core/compare` | — | — |
+| **batch()** | `@br-validators/core/batch` | — | — |
+| **diff()** | `@br-validators/core/diff` | — | — |
 | **generate()** | `@br-validators/core/generate` | `br-validators generate …` | `/generate` |
+| **buildStaticPixBrCode()** | `@br-validators/core/brcode` | — | `/pix` (QR panel) |
 
 Full official sources per type: [docs/OFFICIAL-SOURCES.md](https://github.com/AlexandreZanata/br-validators/blob/main/docs/OFFICIAL-SOURCES.md)
 
@@ -207,8 +278,8 @@ import { parseNfeChave } from '@br-validators/core/nfe-chave';
 | Package | Status |
 |---|---|
 | [`@br-validators/cli`](https://www.npmjs.com/package/@br-validators/cli) | Published |
-| `@br-validators/zod` | Coming soon — Zod schemas |
-| `@br-validators/react-hook-form` | Coming soon — RHF resolvers |
+| [`@br-validators/zod`](https://www.npmjs.com/package/@br-validators/zod) | Published — Zod 3/4 schemas |
+| [`@br-validators/react-hook-form`](https://www.npmjs.com/package/@br-validators/react-hook-form) | Published — RHF resolvers |
 
 ---
 

package/dist/batch.d.ts

@@ -0,0 +1,28 @@
+import { P as PlatformDocumentType, a as PlatformOptions } from './types-MXifBcV5.js';
+import { V as ValidationErrorCode } from './validation-result-BaI2Xder.js';
+import './index-BEJFgDXj.js';
+
+type BatchValidEntry = {
+    index: number;
+    input: string;
+    value: string;
+};
+type BatchInvalidEntry = {
+    index: number;
+    input: string;
+    code: ValidationErrorCode;
+    message: string;
+};
+type BatchSummary = {
+    total: number;
+    valid: number;
+    invalid: number;
+};
+type BatchResult = {
+    valid: BatchValidEntry[];
+    invalid: BatchInvalidEntry[];
+    summary: BatchSummary;
+};
+declare function batch(inputs: readonly string[], type: PlatformDocumentType, options?: PlatformOptions): BatchResult;
+
+export { type BatchInvalidEntry, type BatchResult, type BatchSummary, type BatchValidEntry, batch };

package/dist/batch.js

@@ -0,0 +1,29 @@
+export { batch } from './chunk-N2WVO3GF.js';
+import './chunk-I66ZRSEN.js';
+import './chunk-AO6UTQ4A.js';
+import './chunk-JLCQ7MGC.js';
+import './chunk-3LMDBXU6.js';
+import './chunk-DAR6VOMT.js';
+import './chunk-CSVGWTCG.js';
+import './chunk-665E36SC.js';
+import './chunk-CDNOUZEI.js';
+import './chunk-AU6TW3GH.js';
+import './chunk-N6RQICAP.js';
+import './chunk-E2EFGMWA.js';
+import './chunk-V7UJ55KW.js';
+import './chunk-H3MLGGFI.js';
+import './chunk-P2KNN6ZR.js';
+import './chunk-63G7QO73.js';
+import './chunk-ANWQBKGN.js';
+import './chunk-TE6NSONR.js';
+import './chunk-YNVMVDFN.js';
+import './chunk-YYHS5WQN.js';
+import './chunk-4SNBZFS5.js';
+import './chunk-UCJPSJN5.js';
+import './chunk-CSRBRKXY.js';
+import './chunk-FBARVLLP.js';
+import './chunk-OTZHMJYE.js';
+import './chunk-EB3G4IG6.js';
+import './chunk-NUQSMT4Y.js';
+//# sourceMappingURL=batch.js.map
+//# sourceMappingURL=batch.js.map

package/dist/batch.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"batch.js"}

package/dist/boleto.d.ts

@@ -1,5 +1,5 @@
-import { b as BoletoValidationResult, V as ValidationErrorCode, B as BoletoInputKind, F as FormatResult } from './validation-result-BhQE-1_O.js';
-export { a as BoletoSituacao, i as CodigoBarras, D as DocumentFormat, L as LinhaDigitavel } from './validation-result-BhQE-1_O.js';
+import { y as CobrancaBoletoValidationResult, V as ValidationErrorCode, B as BoletoInputKind, b as BoletoValidationResult, F as FormatResult } from './validation-result-BaI2Xder.js';
+export { a as BoletoSituacao, i as CodigoBarras, D as DocumentFormat, L as LinhaDigitavel } from './validation-result-BaI2Xder.js';
 
 /**
  * FEBRABAN bank boleto (cobrança) — linha digitável + código de barras.
@@ -20,6 +20,10 @@ declare const BOLETO_GOLDEN_LINHA_SITUACAO2_STRIPPED = "988012345167890123457678
 declare const BOLETO_GOLDEN_CODIGO_BARRAS_SITUACAO2 = "98807607469480001121234567890123456789012345";
 declare const BOLETO_OFFICIAL_SOURCE_URL = "https://cmsarquivos.febraban.org.br/Arquivos/documentos/PDF/Conven%C3%A7%C3%A3o%20da%20Cobran%C3%A7a%20-%2005_02_2021_f.pdf";
 declare const BOLETO_LAYOUTS_PORTAL_URL = "https://portal.febraban.org.br/pagina/3425/33/pt-br/layout-febraban";
+declare const BOLETO_ARRECADACAO_LINHA_LENGTH = 48;
+declare const BOLETO_ARRECADACAO_CODIGO_BARRAS_LENGTH = 44;
+declare const BOLETO_ARRECADACAO_PRODUCT_ID = "8";
+declare const BOLETO_ARRECADACAO_OFFICIAL_SOURCE_URL = "https://cmsarquivos.febraban.org.br/Arquivos/documentos/PDF/Layout%20-%20C%C3%B3digo%20de%20Barras%20-%20Vers%C3%A3o%207%20-%2001_03_2023_mn.pdf";
 
 /**
  * Modulo 10 — linha digitável field DVs (Anexo IX).
@@ -52,7 +56,7 @@ declare function formatLinhaDigitavel(stripped: string): string;
  */
 
 declare function stripLinhaDigitavel(input: string): string;
-declare function validateLinhaDigitavel(input: string): BoletoValidationResult;
+declare function validateLinhaDigitavel(input: string): CobrancaBoletoValidationResult;
 
 /**
  * Código de barras validation — modulo 11 general DV (Anexo X).
@@ -60,7 +64,7 @@ declare function validateLinhaDigitavel(input: string): BoletoValidationResult;
  */
 
 declare function stripCodigoBarras(input: string): string;
-declare function validateCodigoBarras(input: string): BoletoValidationResult;
+declare function validateCodigoBarras(input: string): CobrancaBoletoValidationResult;
 
 /**
  * Due-date factor semantic validation (Situação 1 only).
@@ -93,6 +97,55 @@ type ValorDocumentoValidationResult = {
 };
 declare function validateValorDocumento(value: string): ValorDocumentoValidationResult;
 
+/**
+ * FEBRABAN arrecadação modulo 11 — Layout v7 §09–10.
+ * @see BOLETO_ARRECADACAO_OFFICIAL_SOURCE_URL
+ *
+ * Multipliers 2,3,4,5,6,7,8,9,2,3,4… from right; remainder 0|1 → DV 0; remainder 10 → DV 1.
+ */
+declare function computeArrecadacaoModulo11Dv(digits: string): number;
+declare function isArrecadacaoValueType(valueType: string): valueType is ArrecadacaoValueType;
+type ArrecadacaoValueType = '6' | '7' | '8' | '9';
+declare function getArrecadacaoDvCalculator(valueType: string): (digits: string) => number;
+
+/**
+ * Boleto arrecadação — FEBRABAN Layout v7 (48-digit linha + 44-digit código de barras).
+ * @see docs/use-cases/UC-007-validate-boleto.md
+ * @see BOLETO_ARRECADACAO_OFFICIAL_SOURCE_URL
+ */
+
+type ArrecadacaoInputKind = 'arrecadacao-linha' | 'arrecadacao-codigo-barras';
+type ArrecadacaoValidationResult = {
+    ok: true;
+    value: string;
+    inputKind: ArrecadacaoInputKind;
+    format: 'arrecadacao';
+    segment: string;
+    valueType: ArrecadacaoValueType;
+} | {
+    ok: false;
+    code: ValidationErrorCode;
+    message: string;
+    inputKind?: ArrecadacaoInputKind;
+};
+declare function stripArrecadacao(input: string): string;
+declare function linhaArrecadacaoToCodigoBarras(linha: string): string;
+declare function validateArrecadacaoLinha(input: string): ArrecadacaoValidationResult;
+declare function validateArrecadacaoCodigoBarras(input: string): ArrecadacaoValidationResult;
+declare function validateArrecadacao(input: string): ArrecadacaoValidationResult;
+declare function isValidArrecadacao(input: string): boolean;
+/** @internal Golden vector helper — builds valid barcode then linha. */
+declare function buildArrecadacaoGoldenPair(options: {
+    segment: string;
+    valueType: ArrecadacaoValueType;
+    value: string;
+    company: string;
+    free: string;
+}): {
+    barcode: string;
+    linha: string;
+};
+
 /**
  * Boleto validation — linha digitável + código de barras (FEBRABAN cobrança).
  * @see docs/use-cases/UC-007-validate-boleto.md
@@ -110,4 +163,4 @@ declare function convertCodigoBarrasToLinhaDigitavel(input: string): BoletoValid
 
 declare function formatBoleto(input: string): FormatResult;
 
-export { 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, BoletoInputKind, type BoletoSituacaoCode, type BoletoSituacaoKind, BoletoValidationResult, type DetectedBoletoInputKind, type FatorVencimentoValidationResult, type ValidateBoletoOptions, ValidationErrorCode, type ValorDocumentoValidationResult, applyLinhaDigitavelMask, computeModulo10FieldDv, computeModulo11BarcodeDv, convertCodigoBarrasToLinhaDigitavel, convertCodigoBarrasToLinhaDigits, convertLinhaToCodigoBarras, convertLinhaToCodigoBarrasDigits, detectBoletoInputKind, detectBoletoSituacao, formatBoleto, formatLinhaDigitavel, isValidBoleto, stripCodigoBarras, stripLinhaDigitavel, validateBoleto, validateCodigoBarras, validateFatorVencimento, validateLinhaDigitavel, validateValorDocumento };
+export { type ArrecadacaoInputKind, type ArrecadacaoValidationResult, type 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, BoletoInputKind, type BoletoSituacaoCode, type BoletoSituacaoKind, BoletoValidationResult, type DetectedBoletoInputKind, type FatorVencimentoValidationResult, type ValidateBoletoOptions, ValidationErrorCode, type ValorDocumentoValidationResult, applyLinhaDigitavelMask, buildArrecadacaoGoldenPair, computeModulo10FieldDv as computeArrecadacaoModulo10Dv, computeArrecadacaoModulo11Dv, computeModulo10FieldDv, computeModulo11BarcodeDv, convertCodigoBarrasToLinhaDigitavel, convertCodigoBarrasToLinhaDigits, convertLinhaToCodigoBarras, convertLinhaToCodigoBarrasDigits, detectBoletoInputKind, detectBoletoSituacao, formatBoleto, formatLinhaDigitavel, getArrecadacaoDvCalculator, isArrecadacaoValueType, isValidArrecadacao, isValidBoleto, linhaArrecadacaoToCodigoBarras, stripArrecadacao, stripCodigoBarras, stripLinhaDigitavel, validateArrecadacao, validateArrecadacaoCodigoBarras, validateArrecadacaoLinha, validateBoleto, validateCodigoBarras, validateFatorVencimento, validateLinhaDigitavel, validateValorDocumento };

package/dist/boleto.js

@@ -1,5 +1,8 @@
-export { formatBoleto } from './chunk-FXLVNCG3.js';
-export { 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, computeModulo11BarcodeDv, convertCodigoBarrasToLinhaDigitavel, convertCodigoBarrasToLinhaDigits, convertLinhaToCodigoBarras, convertLinhaToCodigoBarrasDigits, detectBoletoInputKind, detectBoletoSituacao, formatLinhaDigitavel, isValidBoleto, stripCodigoBarras, stripLinhaDigitavel, validateBoleto, validateCodigoBarras, validateFatorVencimento, validateLinhaDigitavel, validateValorDocumento } from './chunk-4W4OKLSZ.js';
-import './chunk-MSLJF2FM.js';
+import './chunk-KBNWI6GE.js';
+export { formatBoleto } from './chunk-XWHGXSQV.js';
+export { convertCodigoBarrasToLinhaDigitavel, convertLinhaToCodigoBarras, isValidBoleto, validateBoleto, validateFatorVencimento, validateValorDocumento } from './chunk-AU6TW3GH.js';
+export { buildArrecadacaoGoldenPair, computeArrecadacaoModulo11Dv, getArrecadacaoDvCalculator, isArrecadacaoValueType, isValidArrecadacao, linhaArrecadacaoToCodigoBarras, stripArrecadacao, stripCodigoBarras, validateArrecadacao, validateArrecadacaoCodigoBarras, validateArrecadacaoLinha, validateCodigoBarras } from './chunk-N6RQICAP.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-E2EFGMWA.js';
+import './chunk-NUQSMT4Y.js';
 //# sourceMappingURL=boleto.js.map
 //# sourceMappingURL=boleto.js.map

package/dist/brcode.d.ts

@@ -1,5 +1,5 @@
-import { p as PixKey, q as PixKeyType, V as ValidationErrorCode, d as BrCodeValidationResult } from './validation-result-BhQE-1_O.js';
-export { c as BrCodePayload } from './validation-result-BhQE-1_O.js';
+import { p as PixKey, q as PixKeyType, V as ValidationErrorCode, d as BrCodeValidationResult } from './validation-result-BaI2Xder.js';
+export { c as BrCodePayload } from './validation-result-BaI2Xder.js';
 
 /** Bacen Manual BR Code — EMV-QRCPS-MPM TLV + CRC16-CCITT */
 declare const BRCODE_OFFICIAL_SOURCE_URL = "https://www.bcb.gov.br/content/estabilidadefinanceira/spb_docs/ManualBRCode.pdf";
@@ -24,6 +24,18 @@ declare function verifyBrCodeCrc(payload: string): {
     message: string;
 };
 
+type StaticPixBrCodeInput = {
+    pixKey: string;
+    merchantName: string;
+    merchantCity: string;
+    /** Omit for permanent static QR (payer sets amount). Decimal with up to 2 fraction digits. */
+    amount?: string;
+    /** Defaults to `***` per Manual de Padrões PIX static QR. */
+    txid?: string;
+};
+/** Build static PIX BR Code EMV payload. Validate output with `validateBrCode`. */
+declare function buildStaticPixBrCode(input: StaticPixBrCodeInput): string;
+
 type BrCodeParsedFields = {
     merchantName: string;
     merchantCity: string;
@@ -76,4 +88,4 @@ declare function isValidBrCode(input: string): boolean;
 declare function parseBrCode(input: string): BrCodeValidationResult;
 declare function validateBrCode(input: string): BrCodeValidationResult;
 
-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, type BrCodeParseResult, type BrCodeParsedFields, BrCodeValidationResult, PixKeyType, type TlvField, type TlvParseResult, computeCrc16Ccitt, findPixMerchantAccount, findTlvField, isValidBrCode, normalizeBrCodePayload, parseBrCode, parseBrCodePayload, parseTlvSequence, validateBrCode, verifyBrCodeCrc };
+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, type BrCodeParseResult, type BrCodeParsedFields, BrCodeValidationResult, PixKeyType, type StaticPixBrCodeInput, type TlvField, type TlvParseResult, buildStaticPixBrCode, computeCrc16Ccitt, findPixMerchantAccount, findTlvField, isValidBrCode, normalizeBrCodePayload, parseBrCode, parseBrCodePayload, parseTlvSequence, validateBrCode, verifyBrCodeCrc };

package/dist/brcode.js

@@ -1,13 +1,13 @@
 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, computeCrc16Ccitt, findPixMerchantAccount, findTlvField, isValidBrCode, normalizeBrCodePayload, parseBrCode, parseBrCodePayload, parseTlvSequence, validateBrCode, verifyBrCodeCrc } from './chunk-WCQUQ2WX.js';
-import './chunk-MK7OJUF5.js';
-import './chunk-XUO7FV6Z.js';
-import './chunk-YXELVV37.js';
-import './chunk-EB3G4IG6.js';
-import './chunk-KQDLIGSG.js';
-import './chunk-F6PTZY4O.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-V7UJ55KW.js';
+import './chunk-H3MLGGFI.js';
+import './chunk-P2KNN6ZR.js';
+import './chunk-63G7QO73.js';
 import './chunk-UCJPSJN5.js';
+import './chunk-CSRBRKXY.js';
+import './chunk-FBARVLLP.js';
 import './chunk-OTZHMJYE.js';
-import './chunk-MSLJF2FM.js';
+import './chunk-EB3G4IG6.js';
+import './chunk-NUQSMT4Y.js';
 //# sourceMappingURL=brcode.js.map
 //# sourceMappingURL=brcode.js.map

package/dist/cartao-credito.d.ts

@@ -1,5 +1,5 @@
-import { e as CartaoCreditoValidationResult, F as FormatResult } from './validation-result-BhQE-1_O.js';
-export { C as CartaoCredito, D as DocumentFormat, V as ValidationErrorCode } from './validation-result-BhQE-1_O.js';
+import { e as CartaoCreditoValidationResult, F as FormatResult } from './validation-result-BaI2Xder.js';
+export { C as CartaoCredito, D as DocumentFormat, V as ValidationErrorCode } from './validation-result-BaI2Xder.js';
 import { j as CardBrand } from './constants-BqegsAc2.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 } from './constants-BqegsAc2.js';
 

package/dist/cartao-credito.js

@@ -1,6 +1,6 @@
 import './chunk-CQPM43VV.js';
-export { formatCartaoCredito } from './chunk-XW5G2RAL.js';
-export { CARTAO_GOLDEN_AMEX, CARTAO_GOLDEN_LUHN_WALKTHROUGH, CARTAO_GOLDEN_MASTERCARD, CARTAO_GOLDEN_MIN_LENGTH, CARTAO_GOLDEN_VISA, CARTAO_GOLDEN_VISA_MASKED, CARTAO_IEC_SOURCE_URL, CARTAO_OFFICIAL_SOURCE_URL, CARTAO_PAN_MAX_LENGTH, CARTAO_PAN_MIN_LENGTH, computeLuhnSum, detectCardBrand, isValidCartaoCredito, isValidLuhn, passesLuhn, stripCartaoCredito, validateCartaoCredito } from './chunk-AK5GVYQ5.js';
-import './chunk-MSLJF2FM.js';
+export { formatCartaoCredito } from './chunk-B6A7VF4R.js';
+export { CARTAO_GOLDEN_AMEX, CARTAO_GOLDEN_LUHN_WALKTHROUGH, CARTAO_GOLDEN_MASTERCARD, CARTAO_GOLDEN_MIN_LENGTH, CARTAO_GOLDEN_VISA, CARTAO_GOLDEN_VISA_MASKED, CARTAO_IEC_SOURCE_URL, CARTAO_OFFICIAL_SOURCE_URL, CARTAO_PAN_MAX_LENGTH, CARTAO_PAN_MIN_LENGTH, computeLuhnSum, detectCardBrand, isValidCartaoCredito, isValidLuhn, passesLuhn, stripCartaoCredito, validateCartaoCredito } from './chunk-ANWQBKGN.js';
+import './chunk-NUQSMT4Y.js';
 //# sourceMappingURL=cartao-credito.js.map
 //# sourceMappingURL=cartao-credito.js.map

package/dist/cep.d.ts

@@ -1,5 +1,5 @@
-import { x as ValidationResult, F as FormatResult } from './validation-result-BhQE-1_O.js';
-export { f as Cep, D as DocumentFormat, V as ValidationErrorCode } from './validation-result-BhQE-1_O.js';
+import { x as ValidationResult, F as FormatResult } from './validation-result-BaI2Xder.js';
+export { f as Cep, D as DocumentFormat, V as ValidationErrorCode } from './validation-result-BaI2Xder.js';
 
 declare const CEP_GOLDEN_PRIMARY = "01310100";
 declare const CEP_GOLDEN_SECONDARY = "20040020";

package/dist/cep.js

@@ -1,10 +1,10 @@
 import './chunk-2CNYSY3Z.js';
-export { formatCep } from './chunk-ZAUZRIOU.js';
-export { CEP_GOLDEN_PRIMARY, CEP_GOLDEN_PRIMARY_MASKED, CEP_GOLDEN_SECONDARY, CEP_OFFICIAL_SOURCE_URL, isValidCep, validateCep } from './chunk-2JJS46FM.js';
+export { formatCep } from './chunk-MESOO5GZ.js';
+export { CEP_GOLDEN_PRIMARY, CEP_GOLDEN_PRIMARY_MASKED, CEP_GOLDEN_SECONDARY, CEP_OFFICIAL_SOURCE_URL, isValidCep, validateCep } from './chunk-TE6NSONR.js';
 export { stripCep } from './chunk-YYHS5WQN.js';
 import './chunk-4SNBZFS5.js';
-import './chunk-EB3G4IG6.js';
 import './chunk-UCJPSJN5.js';
-import './chunk-MSLJF2FM.js';
+import './chunk-EB3G4IG6.js';
+import './chunk-NUQSMT4Y.js';
 //# sourceMappingURL=cep.js.map
 //# sourceMappingURL=cep.js.map

package/dist/{chunk-WPL47PWJ.js → chunk-3LMDBXU6.js}

@@ -1,5 +1,5 @@
 import { stripPlaca } from './chunk-YYHS5WQN.js';
-import { brandPlaca } from './chunk-MSLJF2FM.js';
+import { brandPlaca } from './chunk-NUQSMT4Y.js';
 
 // src/core/placa/constants.ts
 var PLACA_LENGTH = 7;
@@ -102,5 +102,5 @@ function validatePlaca(input) {
 }
 
 export { PLACA_GOLDEN_CONVERSION_FROM, PLACA_GOLDEN_CONVERSION_TO, PLACA_GOLDEN_LEGACY, PLACA_GOLDEN_MERCOSUL, PLACA_LEGACY_PATTERN, PLACA_LENGTH, PLACA_MERCOSUL_PATTERN, PLACA_OFFICIAL_SOURCE_URL, convertPlacaToMercosul, detectPlacaFormat, isValidPlaca, isValidPlacaLegacy, isValidPlacaMercosul, validatePlaca };
-//# sourceMappingURL=chunk-WPL47PWJ.js.map
-//# sourceMappingURL=chunk-WPL47PWJ.js.map
+//# sourceMappingURL=chunk-3LMDBXU6.js.map
+//# sourceMappingURL=chunk-3LMDBXU6.js.map

package/dist/{chunk-WPL47PWJ.js.map → chunk-3LMDBXU6.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/placa/constants.ts","../src/core/placa/detect.ts","../src/core/placa/legacy.ts","../src/core/placa/mercosul.ts","../src/core/placa/convert.ts","../src/core/placa/index.ts"],"names":["failure"],"mappings":";;;;AAKO,IAAM,YAAA,GAAe;AACrB,IAAM,oBAAA,GAAuB;AAC7B,IAAM,sBAAA,GAAyB;AAC/B,IAAM,4BAAA,GAAuD;AAAA,EAClE,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK;AACP,CAAA;AACO,IAAM,qBAAA,GAAwB;AAC9B,IAAM,mBAAA,GAAsB;AAC5B,IAAM,4BAAA,GAA+B;AACrC,IAAM,0BAAA,GAA6B;AACnC,IAAM,yBAAA,GACX;;;AChBK,SAAS,kBAAkB,KAAA,EAA4B;AAC5D,EAAA,MAAM,QAAA,GAAW,WAAW,KAAK,CAAA;AACjC,EAAA,IAAI,QAAA,CAAS,WAAW,YAAA,EAAc;AACpC,IAAA,OAAO,SAAA;AAAA,EACT;AACA,EAAA,IAAI,oBAAA,CAAqB,IAAA,CAAK,QAAQ,CAAA,EAAG;AACvC,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,IAAI,sBAAA,CAAuB,IAAA,CAAK,QAAQ,CAAA,EAAG;AACzC,IAAA,OAAO,UAAA;AAAA,EACT;AACA,EAAA,OAAO,SAAA;AACT;;;ACdO,SAAS,mBAAmB,KAAA,EAAwB;AACzD,EAAA,MAAM,QAAA,GAAW,WAAW,KAAK,CAAA;AACjC,EAAA,OAAO,oBAAA,CAAqB,KAAK,QAAQ,CAAA;AAC3C;;;ACHO,SAAS,qBAAqB,KAAA,EAAwB;AAC3D,EAAA,MAAM,QAAA,GAAW,WAAW,KAAK,CAAA;AACjC,EAAA,OAAO,sBAAA,CAAuB,KAAK,QAAQ,CAAA;AAC7C;;;ACCA,SAAS,OAAA,CAAQ,MAA4B,OAAA,EAA+B;AAC1E,EAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,IAAA,EAAM,OAAA,EAAQ;AACpC;AAEO,SAAS,uBAAuB,KAAA,EAA6B;AAClE,EAAA,MAAM,QAAA,GAAW,WAAW,KAAK,CAAA;AACjC,EAAA,IAAI,QAAA,CAAS,WAAW,CAAA,EAAG;AACzB,IAAA,OAAO,OAAA,CAAQ,eAAe,sBAAsB,CAAA;AAAA,EACtD;AAEA,EAAA,IAAI,iBAAA,CAAkB,KAAK,CAAA,KAAM,QAAA,EAAU;AACzC,IAAA,OAAO,OAAA,CAAQ,sBAAsB,oDAAoD,CAAA;AAAA,EAC3F;AAEA,EAAA,MAAM,MAAA,GAAS,QAAA,CAAS,KAAA,CAAM,CAAA,EAAG,CAAC,CAAA;AAClC,EAAA,MAAM,MAAA,GAAS,4BAAA,CAA6B,QAAA,CAAS,MAAA,CAAO,CAAC,CAAC,CAAA;AAC9D,EAAA,MAAM,MAAA,GAAS,QAAA,CAAS,KAAA,CAAM,CAAC,CAAA;AAC/B,EAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,SAAA,EAAW,CAAA,EAAG,MAAM,CAAA,EAAG,MAAM,CAAA,EAAG,MAAM,CAAA,CAAA,EAAG;AAC9D;;;ACJA,SAASA,QAAAA,CAAQ,MAA4B,OAAA,EAA+B;AAC1E,EAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,IAAA,EAAM,OAAA,EAAQ;AACpC;AAEA,SAAS,iBAAA,CAAkB,OAAe,QAAA,EAAuC;AAC/E,EAAA,IAAI,QAAA,CAAS,WAAW,CAAA,EAAG;AACzB,IAAA,OAAOA,QAAAA,CAAQ,eAAe,sBAAsB,CAAA;AAAA,EACtD;AAEA,EAAA,MAAM,iBAAA,GAAoB,KAAA,CAAM,OAAA,CAAQ,QAAA,EAAU,EAAE,CAAA;AACpD,EAAA,IAAI,cAAA,CAAe,IAAA,CAAK,iBAAiB,CAAA,EAAG;AAC1C,IAAA,OAAOA,QAAAA,CAAQ,qBAAqB,mCAAmC,CAAA;AAAA,EACzE;AAEA,EAAA,IAAI,QAAA,CAAS,WAAW,YAAA,EAAc;AACpC,IAAA,OAAOA,QAAAA,CAAQ,gBAAA,EAAkB,CAAA,gBAAA,EAAmB,YAAY,CAAA,+BAAA,CAAiC,CAAA;AAAA,EACnG;AAEA,EAAA,OAAO,IAAA;AACT;AAEO,SAAS,aAAa,KAAA,EAAwB;AACnD,EAAA,OAAO,aAAA,CAAc,KAAK,CAAA,CAAE,EAAA;AAC9B;AAEO,SAAS,cAAc,KAAA,EAAwC;AACpE,EAAA,MAAM,QAAA,GAAW,WAAW,KAAK,CAAA;AACjC,EAAA,MAAM,UAAA,GAAa,iBAAA,CAAkB,KAAA,EAAO,QAAQ,CAAA;AACpD,EAAA,IAAI,UAAA,EAAY;AACd,IAAA,OAAO,UAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAA,GAAS,kBAAkB,KAAK,CAAA;AACtC,EAAA,IAAI,WAAW,SAAA,EAAW;AACxB,IAAA,OAAOA,QAAAA,CAAQ,sBAAsB,gDAAgD,CAAA;AAAA,EACvF;AAEA,EAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,OAAO,UAAA,CAAW,QAAQ,GAAG,MAAA,EAAiC;AACnF","file":"chunk-WPL47PWJ.js","sourcesContent":["/**\n * License plate patterns — CONTRAN 729/2018 (legacy + Mercosul).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n * @see docs/use-cases/UC-004-validate-placa.md — golden vectors ABC1D23, ABC1234\n */\nexport const PLACA_LENGTH = 7;\nexport const PLACA_LEGACY_PATTERN = /^[A-Z]{3}[0-9]{4}$/;\nexport const PLACA_MERCOSUL_PATTERN = /^[A-Z]{3}[0-9][A-Z0-9][0-9]{2}$/;\nexport const PLACA_LEGACY_TO_MERCOSUL_MAP: Record<string, string> = {\n  '0': 'A',\n  '1': 'B',\n  '2': 'C',\n  '3': 'D',\n  '4': 'E',\n  '5': 'F',\n  '6': 'G',\n  '7': 'H',\n  '8': 'I',\n  '9': 'J',\n};\nexport const PLACA_GOLDEN_MERCOSUL = 'ABC1D23';\nexport const PLACA_GOLDEN_LEGACY = 'ABC1234';\nexport const PLACA_GOLDEN_CONVERSION_FROM = 'ABC1234';\nexport const PLACA_GOLDEN_CONVERSION_TO = 'ABC1C34';\nexport const PLACA_OFFICIAL_SOURCE_URL =\n  'https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf';\n","/**\n * License plate format detection — legacy vs Mercosul (CONTRAN).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n */\nimport { stripPlaca } from '../../strip/index.js';\nimport { PLACA_LENGTH, PLACA_LEGACY_PATTERN, PLACA_MERCOSUL_PATTERN } from './constants.js';\n\nexport type PlacaFormat = 'legacy' | 'mercosul' | 'unknown';\n\nexport function detectPlacaFormat(input: string): PlacaFormat {\n  const stripped = stripPlaca(input);\n  if (stripped.length !== PLACA_LENGTH) {\n    return 'unknown';\n  }\n  if (PLACA_LEGACY_PATTERN.test(stripped)) {\n    return 'legacy';\n  }\n  if (PLACA_MERCOSUL_PATTERN.test(stripped)) {\n    return 'mercosul';\n  }\n  return 'unknown';\n}\n","/**\n * License plate — legacy format LLLNNNN (CONTRAN).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n */\nimport { stripPlaca } from '../../strip/index.js';\nimport { PLACA_LEGACY_PATTERN } from './constants.js';\n\nexport function isValidPlacaLegacy(input: string): boolean {\n  const stripped = stripPlaca(input);\n  return PLACA_LEGACY_PATTERN.test(stripped);\n}\n","/**\n * License plate — Mercosul format LLLNLNN (CONTRAN).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n */\nimport { stripPlaca } from '../../strip/index.js';\nimport { PLACA_MERCOSUL_PATTERN } from './constants.js';\n\nexport function isValidPlacaMercosul(input: string): boolean {\n  const stripped = stripPlaca(input);\n  return PLACA_MERCOSUL_PATTERN.test(stripped);\n}\n","/**\n * Legacy → Mercosul plate conversion (CONTRAN digit-to-letter table).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n */\nimport type { FormatResult } from '../../types/validation-result.js';\nimport { stripPlaca } from '../../strip/index.js';\nimport { PLACA_LEGACY_TO_MERCOSUL_MAP } from './constants.js';\nimport { detectPlacaFormat } from './detect.js';\n\ntype FailedResult = Extract<FormatResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string): FailedResult {\n  return { ok: false, code, message };\n}\n\nexport function convertPlacaToMercosul(input: string): FormatResult {\n  const stripped = stripPlaca(input);\n  if (stripped.length === 0) {\n    return failure('EMPTY_INPUT', 'Placa input is empty');\n  }\n\n  if (detectPlacaFormat(input) !== 'legacy') {\n    return failure('UNSUPPORTED_FORMAT', 'Conversion requires a valid legacy plate (LLLNNNN)');\n  }\n\n  const prefix = stripped.slice(0, 4);\n  const mapped = PLACA_LEGACY_TO_MERCOSUL_MAP[stripped.charAt(4)];\n  const suffix = stripped.slice(5);\n  return { ok: true, formatted: `${prefix}${mapped}${suffix}` };\n}\n","/**\n * License plate validation — legacy (LLLNNNN) + Mercosul (LLLNLNN). CONTRAN 729/2018.\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n * @see docs/use-cases/UC-004-validate-placa.md — golden vectors ABC1D23, ABC1234\n */\nimport { stripPlaca } from '../../strip/index.js';\nimport type { DocumentFormat, Placa, ValidationResult } from '../../types/validation-result.js';\nimport { brandPlaca } from '../../types/validation-result.js';\nimport { detectPlacaFormat } from './detect.js';\nimport { PLACA_LENGTH } from './constants.js';\n\nexport {\n  PLACA_GOLDEN_CONVERSION_FROM,\n  PLACA_GOLDEN_CONVERSION_TO,\n  PLACA_GOLDEN_LEGACY,\n  PLACA_GOLDEN_MERCOSUL,\n  PLACA_OFFICIAL_SOURCE_URL,\n} from './constants.js';\nexport { detectPlacaFormat, type PlacaFormat } from './detect.js';\nexport { isValidPlacaLegacy } from './legacy.js';\nexport { isValidPlacaMercosul } from './mercosul.js';\nexport { convertPlacaToMercosul } from './convert.js';\n\ntype FailedResult = Extract<ValidationResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string): FailedResult {\n  return { ok: false, code, message };\n}\n\nfunction validateStructure(input: string, stripped: string): FailedResult | null {\n  if (stripped.length === 0) {\n    return failure('EMPTY_INPUT', 'Placa input is empty');\n  }\n\n  const withoutSeparators = input.replace(/[-\\s]/g, '');\n  if (/[^A-Za-z0-9]/.test(withoutSeparators)) {\n    return failure('INVALID_CHARACTER', 'Placa contains invalid characters');\n  }\n\n  if (stripped.length !== PLACA_LENGTH) {\n    return failure('INVALID_LENGTH', `Placa must have ${PLACA_LENGTH} characters after normalization`);\n  }\n\n  return null;\n}\n\nexport function isValidPlaca(input: string): boolean {\n  return validatePlaca(input).ok;\n}\n\nexport function validatePlaca(input: string): ValidationResult<Placa> {\n  const stripped = stripPlaca(input);\n  const structural = validateStructure(input, stripped);\n  if (structural) {\n    return structural;\n  }\n\n  const format = detectPlacaFormat(input);\n  if (format === 'unknown') {\n    return failure('UNSUPPORTED_FORMAT', 'Placa does not match legacy or Mercosul format');\n  }\n\n  return { ok: true, value: brandPlaca(stripped), format: format as DocumentFormat };\n}\n"]}
+{"version":3,"sources":["../src/core/placa/constants.ts","../src/core/placa/detect.ts","../src/core/placa/legacy.ts","../src/core/placa/mercosul.ts","../src/core/placa/convert.ts","../src/core/placa/index.ts"],"names":["failure"],"mappings":";;;;AAKO,IAAM,YAAA,GAAe;AACrB,IAAM,oBAAA,GAAuB;AAC7B,IAAM,sBAAA,GAAyB;AAC/B,IAAM,4BAAA,GAAuD;AAAA,EAClE,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK,GAAA;AAAA,EACL,GAAA,EAAK;AACP,CAAA;AACO,IAAM,qBAAA,GAAwB;AAC9B,IAAM,mBAAA,GAAsB;AAC5B,IAAM,4BAAA,GAA+B;AACrC,IAAM,0BAAA,GAA6B;AACnC,IAAM,yBAAA,GACX;;;AChBK,SAAS,kBAAkB,KAAA,EAA4B;AAC5D,EAAA,MAAM,QAAA,GAAW,WAAW,KAAK,CAAA;AACjC,EAAA,IAAI,QAAA,CAAS,WAAW,YAAA,EAAc;AACpC,IAAA,OAAO,SAAA;AAAA,EACT;AACA,EAAA,IAAI,oBAAA,CAAqB,IAAA,CAAK,QAAQ,CAAA,EAAG;AACvC,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,IAAI,sBAAA,CAAuB,IAAA,CAAK,QAAQ,CAAA,EAAG;AACzC,IAAA,OAAO,UAAA;AAAA,EACT;AACA,EAAA,OAAO,SAAA;AACT;;;ACdO,SAAS,mBAAmB,KAAA,EAAwB;AACzD,EAAA,MAAM,QAAA,GAAW,WAAW,KAAK,CAAA;AACjC,EAAA,OAAO,oBAAA,CAAqB,KAAK,QAAQ,CAAA;AAC3C;;;ACHO,SAAS,qBAAqB,KAAA,EAAwB;AAC3D,EAAA,MAAM,QAAA,GAAW,WAAW,KAAK,CAAA;AACjC,EAAA,OAAO,sBAAA,CAAuB,KAAK,QAAQ,CAAA;AAC7C;;;ACCA,SAAS,OAAA,CAAQ,MAA4B,OAAA,EAA+B;AAC1E,EAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,IAAA,EAAM,OAAA,EAAQ;AACpC;AAEO,SAAS,uBAAuB,KAAA,EAA6B;AAClE,EAAA,MAAM,QAAA,GAAW,WAAW,KAAK,CAAA;AACjC,EAAA,IAAI,QAAA,CAAS,WAAW,CAAA,EAAG;AACzB,IAAA,OAAO,OAAA,CAAQ,eAAe,sBAAsB,CAAA;AAAA,EACtD;AAEA,EAAA,IAAI,iBAAA,CAAkB,KAAK,CAAA,KAAM,QAAA,EAAU;AACzC,IAAA,OAAO,OAAA,CAAQ,sBAAsB,oDAAoD,CAAA;AAAA,EAC3F;AAEA,EAAA,MAAM,MAAA,GAAS,QAAA,CAAS,KAAA,CAAM,CAAA,EAAG,CAAC,CAAA;AAClC,EAAA,MAAM,MAAA,GAAS,4BAAA,CAA6B,QAAA,CAAS,MAAA,CAAO,CAAC,CAAC,CAAA;AAC9D,EAAA,MAAM,MAAA,GAAS,QAAA,CAAS,KAAA,CAAM,CAAC,CAAA;AAC/B,EAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,SAAA,EAAW,CAAA,EAAG,MAAM,CAAA,EAAG,MAAM,CAAA,EAAG,MAAM,CAAA,CAAA,EAAG;AAC9D;;;ACJA,SAASA,QAAAA,CAAQ,MAA4B,OAAA,EAA+B;AAC1E,EAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,IAAA,EAAM,OAAA,EAAQ;AACpC;AAEA,SAAS,iBAAA,CAAkB,OAAe,QAAA,EAAuC;AAC/E,EAAA,IAAI,QAAA,CAAS,WAAW,CAAA,EAAG;AACzB,IAAA,OAAOA,QAAAA,CAAQ,eAAe,sBAAsB,CAAA;AAAA,EACtD;AAEA,EAAA,MAAM,iBAAA,GAAoB,KAAA,CAAM,OAAA,CAAQ,QAAA,EAAU,EAAE,CAAA;AACpD,EAAA,IAAI,cAAA,CAAe,IAAA,CAAK,iBAAiB,CAAA,EAAG;AAC1C,IAAA,OAAOA,QAAAA,CAAQ,qBAAqB,mCAAmC,CAAA;AAAA,EACzE;AAEA,EAAA,IAAI,QAAA,CAAS,WAAW,YAAA,EAAc;AACpC,IAAA,OAAOA,QAAAA,CAAQ,gBAAA,EAAkB,CAAA,gBAAA,EAAmB,YAAY,CAAA,+BAAA,CAAiC,CAAA;AAAA,EACnG;AAEA,EAAA,OAAO,IAAA;AACT;AAEO,SAAS,aAAa,KAAA,EAAwB;AACnD,EAAA,OAAO,aAAA,CAAc,KAAK,CAAA,CAAE,EAAA;AAC9B;AAEO,SAAS,cAAc,KAAA,EAAwC;AACpE,EAAA,MAAM,QAAA,GAAW,WAAW,KAAK,CAAA;AACjC,EAAA,MAAM,UAAA,GAAa,iBAAA,CAAkB,KAAA,EAAO,QAAQ,CAAA;AACpD,EAAA,IAAI,UAAA,EAAY;AACd,IAAA,OAAO,UAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAA,GAAS,kBAAkB,KAAK,CAAA;AACtC,EAAA,IAAI,WAAW,SAAA,EAAW;AACxB,IAAA,OAAOA,QAAAA,CAAQ,sBAAsB,gDAAgD,CAAA;AAAA,EACvF;AAEA,EAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,OAAO,UAAA,CAAW,QAAQ,GAAG,MAAA,EAAiC;AACnF","file":"chunk-3LMDBXU6.js","sourcesContent":["/**\n * License plate patterns — CONTRAN 729/2018 (legacy + Mercosul).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n * @see docs/use-cases/UC-004-validate-placa.md — golden vectors ABC1D23, ABC1234\n */\nexport const PLACA_LENGTH = 7;\nexport const PLACA_LEGACY_PATTERN = /^[A-Z]{3}[0-9]{4}$/;\nexport const PLACA_MERCOSUL_PATTERN = /^[A-Z]{3}[0-9][A-Z0-9][0-9]{2}$/;\nexport const PLACA_LEGACY_TO_MERCOSUL_MAP: Record<string, string> = {\n  '0': 'A',\n  '1': 'B',\n  '2': 'C',\n  '3': 'D',\n  '4': 'E',\n  '5': 'F',\n  '6': 'G',\n  '7': 'H',\n  '8': 'I',\n  '9': 'J',\n};\nexport const PLACA_GOLDEN_MERCOSUL = 'ABC1D23';\nexport const PLACA_GOLDEN_LEGACY = 'ABC1234';\nexport const PLACA_GOLDEN_CONVERSION_FROM = 'ABC1234';\nexport const PLACA_GOLDEN_CONVERSION_TO = 'ABC1C34';\nexport const PLACA_OFFICIAL_SOURCE_URL =\n  'https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf';\n","/**\n * License plate format detection — legacy vs Mercosul (CONTRAN).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n */\nimport { stripPlaca } from '../../strip/index.js';\nimport { PLACA_LENGTH, PLACA_LEGACY_PATTERN, PLACA_MERCOSUL_PATTERN } from './constants.js';\n\nexport type PlacaFormat = 'legacy' | 'mercosul' | 'unknown';\n\nexport function detectPlacaFormat(input: string): PlacaFormat {\n  const stripped = stripPlaca(input);\n  if (stripped.length !== PLACA_LENGTH) {\n    return 'unknown';\n  }\n  if (PLACA_LEGACY_PATTERN.test(stripped)) {\n    return 'legacy';\n  }\n  if (PLACA_MERCOSUL_PATTERN.test(stripped)) {\n    return 'mercosul';\n  }\n  return 'unknown';\n}\n","/**\n * License plate — legacy format LLLNNNN (CONTRAN).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n */\nimport { stripPlaca } from '../../strip/index.js';\nimport { PLACA_LEGACY_PATTERN } from './constants.js';\n\nexport function isValidPlacaLegacy(input: string): boolean {\n  const stripped = stripPlaca(input);\n  return PLACA_LEGACY_PATTERN.test(stripped);\n}\n","/**\n * License plate — Mercosul format LLLNLNN (CONTRAN).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n */\nimport { stripPlaca } from '../../strip/index.js';\nimport { PLACA_MERCOSUL_PATTERN } from './constants.js';\n\nexport function isValidPlacaMercosul(input: string): boolean {\n  const stripped = stripPlaca(input);\n  return PLACA_MERCOSUL_PATTERN.test(stripped);\n}\n","/**\n * Legacy → Mercosul plate conversion (CONTRAN digit-to-letter table).\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n */\nimport type { FormatResult } from '../../types/validation-result.js';\nimport { stripPlaca } from '../../strip/index.js';\nimport { PLACA_LEGACY_TO_MERCOSUL_MAP } from './constants.js';\nimport { detectPlacaFormat } from './detect.js';\n\ntype FailedResult = Extract<FormatResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string): FailedResult {\n  return { ok: false, code, message };\n}\n\nexport function convertPlacaToMercosul(input: string): FormatResult {\n  const stripped = stripPlaca(input);\n  if (stripped.length === 0) {\n    return failure('EMPTY_INPUT', 'Placa input is empty');\n  }\n\n  if (detectPlacaFormat(input) !== 'legacy') {\n    return failure('UNSUPPORTED_FORMAT', 'Conversion requires a valid legacy plate (LLLNNNN)');\n  }\n\n  const prefix = stripped.slice(0, 4);\n  const mapped = PLACA_LEGACY_TO_MERCOSUL_MAP[stripped.charAt(4)];\n  const suffix = stripped.slice(5);\n  return { ok: true, formatted: `${prefix}${mapped}${suffix}` };\n}\n","/**\n * License plate validation — legacy (LLLNNNN) + Mercosul (LLLNLNN). CONTRAN 729/2018.\n * @see https://www.gov.br/transportes/pt-br/assuntos/transito/conteudo-contran/resolucoes/resolucao7292018consolidada.pdf\n * @see docs/use-cases/UC-004-validate-placa.md — golden vectors ABC1D23, ABC1234\n */\nimport { stripPlaca } from '../../strip/index.js';\nimport type { DocumentFormat, Placa, ValidationResult } from '../../types/validation-result.js';\nimport { brandPlaca } from '../../types/validation-result.js';\nimport { detectPlacaFormat } from './detect.js';\nimport { PLACA_LENGTH } from './constants.js';\n\nexport {\n  PLACA_GOLDEN_CONVERSION_FROM,\n  PLACA_GOLDEN_CONVERSION_TO,\n  PLACA_GOLDEN_LEGACY,\n  PLACA_GOLDEN_MERCOSUL,\n  PLACA_OFFICIAL_SOURCE_URL,\n} from './constants.js';\nexport { detectPlacaFormat, type PlacaFormat } from './detect.js';\nexport { isValidPlacaLegacy } from './legacy.js';\nexport { isValidPlacaMercosul } from './mercosul.js';\nexport { convertPlacaToMercosul } from './convert.js';\n\ntype FailedResult = Extract<ValidationResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string): FailedResult {\n  return { ok: false, code, message };\n}\n\nfunction validateStructure(input: string, stripped: string): FailedResult | null {\n  if (stripped.length === 0) {\n    return failure('EMPTY_INPUT', 'Placa input is empty');\n  }\n\n  const withoutSeparators = input.replace(/[-\\s]/g, '');\n  if (/[^A-Za-z0-9]/.test(withoutSeparators)) {\n    return failure('INVALID_CHARACTER', 'Placa contains invalid characters');\n  }\n\n  if (stripped.length !== PLACA_LENGTH) {\n    return failure('INVALID_LENGTH', `Placa must have ${PLACA_LENGTH} characters after normalization`);\n  }\n\n  return null;\n}\n\nexport function isValidPlaca(input: string): boolean {\n  return validatePlaca(input).ok;\n}\n\nexport function validatePlaca(input: string): ValidationResult<Placa> {\n  const stripped = stripPlaca(input);\n  const structural = validateStructure(input, stripped);\n  if (structural) {\n    return structural;\n  }\n\n  const format = detectPlacaFormat(input);\n  if (format === 'unknown') {\n    return failure('UNSUPPORTED_FORMAT', 'Placa does not match legacy or Mercosul format');\n  }\n\n  return { ok: true, value: brandPlaca(stripped), format: format as DocumentFormat };\n}\n"]}

package/dist/chunk-4J5IMD7B.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-4J5IMD7B.js.map
+//# sourceMappingURL=chunk-4J5IMD7B.js.map

package/dist/chunk-4J5IMD7B.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-4J5IMD7B.js"}

package/dist/{chunk-BFZPCEYB.js → chunk-54UWHK5L.js}

@@ -1,4 +1,4 @@
-import { validateIeSpRural, applyIeSpRuralMask } from './chunk-Y6IW2LMW.js';
+import { validateIeSpRural, applyIeSpRuralMask } from './chunk-CDNOUZEI.js';
 
 // src/format/inscricao-estadual-produtor-rural.ts
 function formatIeProdutorRural(input) {
@@ -10,5 +10,5 @@ function formatIeProdutorRural(input) {
 }
 
 export { formatIeProdutorRural };
-//# sourceMappingURL=chunk-BFZPCEYB.js.map
-//# sourceMappingURL=chunk-BFZPCEYB.js.map
+//# sourceMappingURL=chunk-54UWHK5L.js.map
+//# sourceMappingURL=chunk-54UWHK5L.js.map

package/dist/{chunk-BFZPCEYB.js.map → chunk-54UWHK5L.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/format/inscricao-estadual-produtor-rural.ts"],"names":[],"mappings":";;;AAIO,SAAS,sBAAsB,KAAA,EAA6B;AACjE,EAAA,MAAM,MAAA,GAAS,kBAAkB,KAAK,CAAA;AACtC,EAAA,IAAI,CAAC,OAAO,EAAA,EAAI;AACd,IAAA,OAAO,EAAE,IAAI,KAAA,EAAO,IAAA,EAAM,OAAO,IAAA,EAAM,OAAA,EAAS,OAAO,OAAA,EAAQ;AAAA,EACjE;AACA,EAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,WAAW,kBAAA,CAAmB,MAAA,CAAO,KAAK,CAAA,EAAE;AACjE","file":"chunk-BFZPCEYB.js","sourcesContent":["import { applyIeSpRuralMask } from '../core/inscricao-estadual/mask.js';\nimport { validateIeSpRural } from '../core/inscricao-estadual/sp-rural.js';\nimport type { FormatResult } from '../types/validation-result.js';\n\nexport function formatIeProdutorRural(input: string): FormatResult {\n  const result = validateIeSpRural(input);\n  if (!result.ok) {\n    return { ok: false, code: result.code, message: result.message };\n  }\n  return { ok: true, formatted: applyIeSpRuralMask(result.value) };\n}\n"]}
+{"version":3,"sources":["../src/format/inscricao-estadual-produtor-rural.ts"],"names":[],"mappings":";;;AAIO,SAAS,sBAAsB,KAAA,EAA6B;AACjE,EAAA,MAAM,MAAA,GAAS,kBAAkB,KAAK,CAAA;AACtC,EAAA,IAAI,CAAC,OAAO,EAAA,EAAI;AACd,IAAA,OAAO,EAAE,IAAI,KAAA,EAAO,IAAA,EAAM,OAAO,IAAA,EAAM,OAAA,EAAS,OAAO,OAAA,EAAQ;AAAA,EACjE;AACA,EAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,WAAW,kBAAA,CAAmB,MAAA,CAAO,KAAK,CAAA,EAAE;AACjE","file":"chunk-54UWHK5L.js","sourcesContent":["import { applyIeSpRuralMask } from '../core/inscricao-estadual/mask.js';\nimport { validateIeSpRural } from '../core/inscricao-estadual/sp-rural.js';\nimport type { FormatResult } from '../types/validation-result.js';\n\nexport function formatIeProdutorRural(input: string): FormatResult {\n  const result = validateIeSpRural(input);\n  if (!result.ok) {\n    return { ok: false, code: result.code, message: result.message };\n  }\n  return { ok: true, formatted: applyIeSpRuralMask(result.value) };\n}\n"]}

package/dist/{chunk-F6PTZY4O.js → chunk-63G7QO73.js}

@@ -1,6 +1,6 @@
 import { stripCpf } from './chunk-UCJPSJN5.js';
 import { computeCheckDigit } from './chunk-OTZHMJYE.js';
-import { brandCpf } from './chunk-MSLJF2FM.js';
+import { brandCpf } from './chunk-NUQSMT4Y.js';
 
 // src/core/cpf/constants.ts
 var CPF_DV1_WEIGHTS = [10, 9, 8, 7, 6, 5, 4, 3, 2];
@@ -69,5 +69,5 @@ function validateCpf(input) {
 }
 
 export { CPF_BASE_LENGTH, CPF_DV1_WEIGHTS, CPF_DV2_WEIGHTS, CPF_GOLDEN_PRIMARY, CPF_GOLDEN_PRIMARY_MASKED, CPF_GOLDEN_SECONDARY, CPF_MASK_PATTERN, CPF_OFFICIAL_SOURCE_URL, isValidCpf, validateCpf };
-//# sourceMappingURL=chunk-F6PTZY4O.js.map
-//# sourceMappingURL=chunk-F6PTZY4O.js.map
+//# sourceMappingURL=chunk-63G7QO73.js.map
+//# sourceMappingURL=chunk-63G7QO73.js.map

package/dist/{chunk-F6PTZY4O.js.map → chunk-63G7QO73.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/cpf/constants.ts","../src/core/cpf/index.ts"],"names":[],"mappings":"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","file":"chunk-F6PTZY4O.js","sourcesContent":["/**\n * CPF constants — modulo 11 weights (RFB standard).\n * @see https://www.gov.br/receitafederal/pt-br/assuntos/cpf\n * @see docs/use-cases/UC-001-validate-cpf.md — golden vector 12345678909\n */\nexport const CPF_DV1_WEIGHTS = [10, 9, 8, 7, 6, 5, 4, 3, 2] as const;\nexport const CPF_DV2_WEIGHTS = [11, 10, 9, 8, 7, 6, 5, 4, 3, 2] as const;\nexport const CPF_LENGTH = 11;\nexport const CPF_BASE_LENGTH = 9;\nexport const CPF_NUMERIC_PATTERN = /^\\d{11}$/;\nexport const CPF_MASK_PATTERN = /^(\\d{3})(\\d{3})(\\d{3})(\\d{2})$/;\n\nexport const CPF_GOLDEN_PRIMARY = '12345678909';\nexport const CPF_GOLDEN_SECONDARY = '11144477735';\nexport const CPF_GOLDEN_PRIMARY_MASKED = '123.456.789-09';\nexport const CPF_OFFICIAL_SOURCE_URL =\n  'https://www.gov.br/receitafederal/pt-br/assuntos/cpf';\n","/**\n * CPF validation — modulo 11 (RFB standard weights).\n * @see https://www.gov.br/receitafederal/pt-br/assuntos/cpf\n * @see docs/use-cases/UC-001-validate-cpf.md — golden vector 12345678909\n */\nimport { stripCpf } from '../../strip/cpf.js';\nimport type { ValidationResult } from '../../types/validation-result.js';\nimport { brandCpf } from '../../types/validation-result.js';\nimport { computeCheckDigit } from '../cnpj/modulo11.js';\nimport {\n  CPF_BASE_LENGTH,\n  CPF_DV1_WEIGHTS,\n  CPF_DV2_WEIGHTS,\n  CPF_LENGTH,\n} from './constants.js';\n\nexport {\n  CPF_GOLDEN_PRIMARY,\n  CPF_GOLDEN_PRIMARY_MASKED,\n  CPF_GOLDEN_SECONDARY,\n  CPF_OFFICIAL_SOURCE_URL,\n} from './constants.js';\n\ntype FailedResult = Extract<ValidationResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string): FailedResult {\n  return { ok: false, code, message };\n}\n\nfunction digitValue(char: string): number {\n  return Number(char);\n}\n\nfunction hasRepeatedDigits(value: string): boolean {\n  const first = value[0];\n  for (let i = 1; i < value.length; i++) {\n    if (value[i] !== first) {\n      return false;\n    }\n  }\n  return true;\n}\n\nfunction isValidCpfChecksum(stripped: string): boolean {\n  const base = stripped.slice(0, CPF_BASE_LENGTH);\n  const dv1Expected = String(computeCheckDigit(base, CPF_DV1_WEIGHTS, digitValue));\n  const dv2Expected = String(\n    computeCheckDigit(base + dv1Expected, CPF_DV2_WEIGHTS, digitValue),\n  );\n\n  return stripped.slice(CPF_BASE_LENGTH) === dv1Expected + dv2Expected;\n}\n\nfunction validateStructure(input: string, stripped: string): FailedResult | null {\n  if (stripped.length === 0) {\n    return failure('EMPTY_INPUT', 'CPF input is empty');\n  }\n\n  const withoutMask = input.replace(/[.-]/g, '');\n  if (/[^0-9]/.test(withoutMask)) {\n    return failure('INVALID_CHARACTER', 'CPF contains invalid characters');\n  }\n\n  if (stripped.length !== CPF_LENGTH) {\n    return failure('INVALID_LENGTH', `CPF must have ${CPF_LENGTH} digits after normalization`);\n  }\n\n  if (hasRepeatedDigits(stripped)) {\n    return failure('KNOWN_INVALID_PATTERN', 'CPF with all identical digits is invalid');\n  }\n\n  return null;\n}\n\nexport function isValidCpf(input: string): boolean {\n  return validateCpf(input).ok;\n}\n\nexport function validateCpf(input: string): ValidationResult {\n  const stripped = stripCpf(input);\n  const structural = validateStructure(input, stripped);\n  if (structural) {\n    return structural;\n  }\n\n  if (isValidCpfChecksum(stripped)) {\n    return { ok: true, value: brandCpf(stripped), format: 'numeric' };\n  }\n\n  return failure('INVALID_CHECK_DIGIT', 'CPF check digits are invalid');\n}\n"]}
+{"version":3,"sources":["../src/core/cpf/constants.ts","../src/core/cpf/index.ts"],"names":[],"mappings":"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","file":"chunk-63G7QO73.js","sourcesContent":["/**\n * CPF constants — modulo 11 weights (RFB standard).\n * @see https://www.gov.br/receitafederal/pt-br/assuntos/cpf\n * @see docs/use-cases/UC-001-validate-cpf.md — golden vector 12345678909\n */\nexport const CPF_DV1_WEIGHTS = [10, 9, 8, 7, 6, 5, 4, 3, 2] as const;\nexport const CPF_DV2_WEIGHTS = [11, 10, 9, 8, 7, 6, 5, 4, 3, 2] as const;\nexport const CPF_LENGTH = 11;\nexport const CPF_BASE_LENGTH = 9;\nexport const CPF_NUMERIC_PATTERN = /^\\d{11}$/;\nexport const CPF_MASK_PATTERN = /^(\\d{3})(\\d{3})(\\d{3})(\\d{2})$/;\n\nexport const CPF_GOLDEN_PRIMARY = '12345678909';\nexport const CPF_GOLDEN_SECONDARY = '11144477735';\nexport const CPF_GOLDEN_PRIMARY_MASKED = '123.456.789-09';\nexport const CPF_OFFICIAL_SOURCE_URL =\n  'https://www.gov.br/receitafederal/pt-br/assuntos/cpf';\n","/**\n * CPF validation — modulo 11 (RFB standard weights).\n * @see https://www.gov.br/receitafederal/pt-br/assuntos/cpf\n * @see docs/use-cases/UC-001-validate-cpf.md — golden vector 12345678909\n */\nimport { stripCpf } from '../../strip/cpf.js';\nimport type { ValidationResult } from '../../types/validation-result.js';\nimport { brandCpf } from '../../types/validation-result.js';\nimport { computeCheckDigit } from '../cnpj/modulo11.js';\nimport {\n  CPF_BASE_LENGTH,\n  CPF_DV1_WEIGHTS,\n  CPF_DV2_WEIGHTS,\n  CPF_LENGTH,\n} from './constants.js';\n\nexport {\n  CPF_GOLDEN_PRIMARY,\n  CPF_GOLDEN_PRIMARY_MASKED,\n  CPF_GOLDEN_SECONDARY,\n  CPF_OFFICIAL_SOURCE_URL,\n} from './constants.js';\n\ntype FailedResult = Extract<ValidationResult, { ok: false }>;\n\nfunction failure(code: FailedResult['code'], message: string): FailedResult {\n  return { ok: false, code, message };\n}\n\nfunction digitValue(char: string): number {\n  return Number(char);\n}\n\nfunction hasRepeatedDigits(value: string): boolean {\n  const first = value[0];\n  for (let i = 1; i < value.length; i++) {\n    if (value[i] !== first) {\n      return false;\n    }\n  }\n  return true;\n}\n\nfunction isValidCpfChecksum(stripped: string): boolean {\n  const base = stripped.slice(0, CPF_BASE_LENGTH);\n  const dv1Expected = String(computeCheckDigit(base, CPF_DV1_WEIGHTS, digitValue));\n  const dv2Expected = String(\n    computeCheckDigit(base + dv1Expected, CPF_DV2_WEIGHTS, digitValue),\n  );\n\n  return stripped.slice(CPF_BASE_LENGTH) === dv1Expected + dv2Expected;\n}\n\nfunction validateStructure(input: string, stripped: string): FailedResult | null {\n  if (stripped.length === 0) {\n    return failure('EMPTY_INPUT', 'CPF input is empty');\n  }\n\n  const withoutMask = input.replace(/[.-]/g, '');\n  if (/[^0-9]/.test(withoutMask)) {\n    return failure('INVALID_CHARACTER', 'CPF contains invalid characters');\n  }\n\n  if (stripped.length !== CPF_LENGTH) {\n    return failure('INVALID_LENGTH', `CPF must have ${CPF_LENGTH} digits after normalization`);\n  }\n\n  if (hasRepeatedDigits(stripped)) {\n    return failure('KNOWN_INVALID_PATTERN', 'CPF with all identical digits is invalid');\n  }\n\n  return null;\n}\n\nexport function isValidCpf(input: string): boolean {\n  return validateCpf(input).ok;\n}\n\nexport function validateCpf(input: string): ValidationResult {\n  const stripped = stripCpf(input);\n  const structural = validateStructure(input, stripped);\n  if (structural) {\n    return structural;\n  }\n\n  if (isValidCpfChecksum(stripped)) {\n    return { ok: true, value: brandCpf(stripped), format: 'numeric' };\n  }\n\n  return failure('INVALID_CHECK_DIGIT', 'CPF check digits are invalid');\n}\n"]}

package/dist/{chunk-3QP6R46N.js → chunk-665E36SC.js}

@@ -1,5 +1,5 @@
-import { IE_DF_LENGTH, IE_DF_PREFIX, computeIeDfCheckDigit, IE_DF_DV1_WEIGHTS, IE_DF_DV2_WEIGHTS, IE_MT_CANONICAL_LENGTH, IE_MT_LEGACY_LENGTH, IE_MT_PREFIX, computeIeMtCheckDigit, IE_SP_LENGTH, computeIeSpCheckDigit, IE_SP_DV1_WEIGHTS, IE_SP_DV2_WEIGHTS, IE_OFFICIAL_SOURCE_URLS, applyIeSpMask, applyIeDfMask, IE_SUPPORTED_UFS, IE_TO_LEGACY_PREFIXES, computeIeToCheckDigit, computeIeCyclicMod11CheckDigit, IE_RR_PREFIX, computeIeRrCheckDigit, computeIeRoCheckDigit, IE_RN_PREFIX, computeIePrStyleCheckDigit, computeIePeCheckDigit, IE_PA_PREFIX, IE_MS_PREFIX, computeIeMgFirstCheckDigit, computeIeMgSecondCheckDigit, IE_MA_PREFIX, IE_GO_PREFIXES, computeIeGoCheckDigit, computeIeCeCheckDigit, computeIeBaModule, computeIeBaCheckDigit, IE_AP_PREFIX, computeIeApCheckDigit, computeIeAmCheckDigit, IE_AL_PREFIX, computeIeAlCheckDigit, IE_AC_PREFIX, computeIeAcCheckDigit } from './chunk-Y6IW2LMW.js';
-import { brandInscricaoEstadual } from './chunk-MSLJF2FM.js';
+import { IE_DF_LENGTH, IE_DF_PREFIX, computeIeDfCheckDigit, IE_DF_DV1_WEIGHTS, IE_DF_DV2_WEIGHTS, IE_MT_CANONICAL_LENGTH, IE_MT_LEGACY_LENGTH, IE_MT_PREFIX, computeIeMtCheckDigit, IE_SP_LENGTH, computeIeSpCheckDigit, IE_SP_DV1_WEIGHTS, IE_SP_DV2_WEIGHTS, IE_OFFICIAL_SOURCE_URLS, applyIeSpMask, applyIeDfMask, IE_SUPPORTED_UFS, IE_TO_LEGACY_PREFIXES, computeIeToCheckDigit, computeIeCyclicMod11CheckDigit, IE_RR_PREFIX, computeIeRrCheckDigit, computeIeRoCheckDigit, IE_RN_PREFIX, computeIePrStyleCheckDigit, computeIePeCheckDigit, IE_PA_PREFIX, IE_MS_PREFIX, computeIeMgFirstCheckDigit, computeIeMgSecondCheckDigit, IE_MA_PREFIX, IE_GO_PREFIXES, computeIeGoCheckDigit, computeIeCeCheckDigit, computeIeBaModule, computeIeBaCheckDigit, IE_AP_PREFIX, computeIeApCheckDigit, computeIeAmCheckDigit, IE_AL_PREFIX, computeIeAlCheckDigit, IE_AC_PREFIX, computeIeAcCheckDigit } from './chunk-CDNOUZEI.js';
+import { brandInscricaoEstadual } from './chunk-NUQSMT4Y.js';
 
 // src/core/inscricao-estadual/df.ts
 var DF_MASK_PATTERN = /^[0-9.-]+$/;
@@ -799,5 +799,5 @@ function formatInscricaoEstadual(input, options) {
 }
 
 export { formatInscricaoEstadual, getIeOfficialSourceUrl, isValidInscricaoEstadual, stripInscricaoEstadual, validateIeDf, validateIeMt, validateIeSp, validateInscricaoEstadual };
-//# sourceMappingURL=chunk-3QP6R46N.js.map
-//# sourceMappingURL=chunk-3QP6R46N.js.map
+//# sourceMappingURL=chunk-665E36SC.js.map
+//# sourceMappingURL=chunk-665E36SC.js.map