@br-validators/cli 1.5.0 → 1.6.1

package/dist/run-captured.js

@@ -6,7 +6,7 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
 });
 
 // src/constants.ts
-var SUPPORTED_TYPES = ["cnpj", "cpf", "cep", "telefone", "cnh", "renavam", "titulo-eleitor", "nfe-chave", "brcode", "placa", "pis-pasep", "pix", "boleto", "cartao", "ie"];
+var SUPPORTED_TYPES = ["cnpj", "cpf", "cep", "telefone", "cnh", "renavam", "titulo-eleitor", "processo-judicial", "rg", "nfe-chave", "brcode", "placa", "pis-pasep", "pix", "boleto", "cartao", "ie"];
 var EXIT = {
   OK: 0,
   INVALID: 1,
@@ -41,16 +41,31 @@ import {
   getAeroportoPorIcao
 } from "@br-validators/core/aeroportos";
 import { PORTOS_DATA_VERSION, getPortoPorCodigo } from "@br-validators/core/portos";
+import {
+  CNAES_DATA_VERSION,
+  getCnaePorCodigo
+} from "@br-validators/core/cnaes";
+import {
+  CFOP_DATA_VERSION,
+  getCfopPorCodigo
+} from "@br-validators/core/cfop";
+import { NCM_DATA_VERSION, getNcmPorCodigo } from "@br-validators/core/ncm";
+import { CBO_DATA_VERSION, getCboPorCodigo } from "@br-validators/core/cbo";
 var REFERENCE_LOOKUP_COMMANDS = [
   "natureza-juridica",
   "nbs",
   "cest",
+  "cnae",
+  "cfop",
+  "ncm",
+  "cbo",
   "moedas",
   "paises-bacen",
   "incoterms",
   "portos",
   "aeroportos"
 ];
+var REFERENCE_SEARCH_COMMANDS = ["cnae", "cfop", "ncm", "cbo"];
 function lookupAeroporto(input) {
   const normalized = input.trim().toUpperCase();
   if (/^[A-Z0-9]{3}$/.test(normalized)) {
@@ -95,6 +110,50 @@ var REFERENCE_LOOKUP_MODULES = {
       return `${row.codigo} \u2014 ${row.descricao}`;
     }
   },
+  cnae: {
+    command: "cnae",
+    description: "IBGE CNAE 2.3 subclasses \u2014 offline lookup",
+    resultKey: "cnae",
+    capturadoEm: CNAES_DATA_VERSION.capturadoEm,
+    lookup: (input) => getCnaePorCodigo(input),
+    formatHuman: (result) => {
+      const row = result;
+      return `${row.codigo} \u2014 ${row.descricao}`;
+    }
+  },
+  cfop: {
+    command: "cfop",
+    description: "CONFAZ CFOP fiscal operations \u2014 offline lookup",
+    resultKey: "cfop",
+    capturadoEm: CFOP_DATA_VERSION.capturadoEm,
+    lookup: (input) => getCfopPorCodigo(input),
+    formatHuman: (result) => {
+      const row = result;
+      return `${row.codigo} \u2014 ${row.descricao}`;
+    }
+  },
+  ncm: {
+    command: "ncm",
+    description: "Siscomex NCM Mercosur codes \u2014 offline lookup",
+    resultKey: "ncm",
+    capturadoEm: NCM_DATA_VERSION.capturadoEm,
+    lookup: (input) => getNcmPorCodigo(input),
+    formatHuman: (result) => {
+      const row = result;
+      return `${row.codigo} \u2014 ${row.descricao}`;
+    }
+  },
+  cbo: {
+    command: "cbo",
+    description: "MTE CBO 2002 occupations \u2014 offline lookup",
+    resultKey: "cbo",
+    capturadoEm: CBO_DATA_VERSION.capturadoEm,
+    lookup: (input) => getCboPorCodigo(input),
+    formatHuman: (result) => {
+      const row = result;
+      return `${row.codigo} \u2014 ${row.descricao}`;
+    }
+  },
   moedas: {
     command: "moedas",
     description: "ISO 4217 + Bacen PTAX currencies \u2014 offline lookup",
@@ -156,6 +215,9 @@ var REFERENCE_LOOKUP_MODULES = {
 function isReferenceLookupCommand(value) {
   return REFERENCE_LOOKUP_COMMANDS.includes(value);
 }
+function isReferenceSearchCommand(value) {
+  return REFERENCE_SEARCH_COMMANDS.includes(value);
+}
 
 // src/commands/bancos/list.ts
 import { BANCOS_DATA_VERSION as BANCOS_DATA_VERSION2, getBancos } from "@br-validators/core/bancos";
@@ -293,6 +355,418 @@ function runReferenceLookup(command, value, options, io = { stdout: [], stderr:
   return runReferenceLookupCommand(command, value.trim(), options, io);
 }
 
+// src/commands/reference-lookup/search.ts
+import { searchCbo } from "@br-validators/core/cbo";
+import { searchCnaes } from "@br-validators/core/cnaes";
+import { searchCfop } from "@br-validators/core/cfop";
+import { searchNcm } from "@br-validators/core/ncm";
+function runSearch(command, query, limit) {
+  switch (command) {
+    case "cnae":
+      return searchCnaes(query, { limit });
+    case "cfop":
+      return searchCfop(query, { limit });
+    case "ncm":
+      return searchNcm(query, { limit });
+    case "cbo":
+      return searchCbo(query, { limit });
+  }
+}
+function formatSearchHuman(command, results) {
+  const module = REFERENCE_LOOKUP_MODULES[command];
+  return results.map((row) => module.formatHuman(row));
+}
+function runReferenceSearchCommand(command, query, options, io = { stdout: [], stderr: [] }) {
+  const trimmed = query.trim();
+  if (trimmed.length === 0) {
+    io.stderr.push(`Missing search query. Pass a description fragment for ${command}.`);
+    return EXIT.USAGE;
+  }
+  const limit = options.limit !== void 0 && options.limit > 0 ? options.limit : 10;
+  const results = runSearch(command, trimmed, limit);
+  const module = REFERENCE_LOOKUP_MODULES[command];
+  const resultKey = `${module.resultKey}s`;
+  if (options.json) {
+    const payload = {
+      ok: true,
+      query: trimmed,
+      total: results.length,
+      [resultKey]: results,
+      ...options.verbose ? { capturadoEm: module.capturadoEm } : {}
+    };
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  if (results.length === 0) {
+    io.stderr.push(`No matches for: ${trimmed}`);
+    return EXIT.INVALID;
+  }
+  for (const line of formatSearchHuman(command, results)) {
+    io.stdout.push(line);
+  }
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${module.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runReferenceSearch(command, query, options, io = { stdout: [], stderr: [] }) {
+  if (!isReferenceSearchCommand(command)) {
+    io.stderr.push(`Unknown reference search command: ${command}`);
+    return EXIT.USAGE;
+  }
+  if (!query?.trim()) {
+    io.stderr.push(`Missing query. Usage: br-validators ${command} search <query>`);
+    return EXIT.USAGE;
+  }
+  return runReferenceSearchCommand(command, query.trim(), options, io);
+}
+
+// src/commands/ibge/lookup.ts
+import {
+  getMunicipioPorCodigo,
+  IBGE_DATA_VERSION
+} from "@br-validators/core/ibge";
+function normalizeIbgeMunicipioCode(raw) {
+  const digits = raw.replace(/\D/g, "");
+  if (digits.length !== 7) {
+    return null;
+  }
+  return Number(digits);
+}
+function formatMunicipioHuman(municipio) {
+  return `${municipio.codigo} \u2014 ${municipio.nome} (${municipio.uf})`;
+}
+function runIbgeLookupCommand(input, options, io = { stdout: [], stderr: [] }) {
+  const codigo = normalizeIbgeMunicipioCode(input);
+  if (codigo === null) {
+    io.stderr.push("Invalid IBGE municipality code. Use 7 digits (e.g. 3550308).");
+    return EXIT.USAGE;
+  }
+  const municipio = getMunicipioPorCodigo(codigo);
+  if (!municipio) {
+    io.stderr.push(`Municipality not found: ${input}`);
+    return EXIT.INVALID;
+  }
+  if (options.json) {
+    const payload = {
+      ok: true,
+      municipio
+    };
+    if (options.verbose) {
+      payload.capturadoEm = IBGE_DATA_VERSION.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  io.stdout.push(formatMunicipioHuman(municipio));
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${IBGE_DATA_VERSION.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runIbgeLookup(value, options, io = { stdout: [], stderr: [] }) {
+  if (!value?.trim()) {
+    io.stderr.push("Missing IBGE municipality code. Pass a 7-digit code.");
+    return EXIT.USAGE;
+  }
+  return runIbgeLookupCommand(value.trim(), options, io);
+}
+
+// src/commands/ibge/list.ts
+import {
+  getEstados,
+  getMunicipios,
+  IBGE_DATA_VERSION as IBGE_DATA_VERSION2
+} from "@br-validators/core/ibge";
+function sliceRows(rows, limit) {
+  if (limit === void 0 || !Number.isFinite(limit) || limit <= 0) {
+    return rows;
+  }
+  return rows.slice(0, limit);
+}
+function formatEstadoHuman(estado) {
+  return `${estado.codigo} \u2014 ${estado.sigla} \u2014 ${estado.nome}`;
+}
+function runIbgeListEstadosCommand(options, io = { stdout: [], stderr: [] }) {
+  const estados = sliceRows(getEstados(), options.limit);
+  if (options.json) {
+    const payload = {
+      ok: true,
+      total: estados.length,
+      estados
+    };
+    if (options.verbose) {
+      payload.capturadoEm = IBGE_DATA_VERSION2.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  for (const estado of estados) {
+    io.stdout.push(formatEstadoHuman(estado));
+  }
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${IBGE_DATA_VERSION2.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runIbgeListMunicipiosCommand(options, io = { stdout: [], stderr: [] }) {
+  const uf = options.uf?.trim().toUpperCase();
+  const municipios = sliceRows(getMunicipios(uf ? { uf } : void 0), options.limit);
+  if (options.json) {
+    const payload = {
+      ok: true,
+      total: municipios.length,
+      municipios,
+      ...uf ? { uf } : {}
+    };
+    if (options.verbose) {
+      payload.capturadoEm = IBGE_DATA_VERSION2.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  for (const municipio of municipios) {
+    io.stdout.push(formatMunicipioHuman(municipio));
+  }
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${IBGE_DATA_VERSION2.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runIbgeList(target, options, io = { stdout: [], stderr: [] }) {
+  if (target === "estados") {
+    return runIbgeListEstadosCommand(options, io);
+  }
+  return runIbgeListMunicipiosCommand(options, io);
+}
+
+// src/commands/feriados/list.ts
+import {
+  FERIADOS_DATA_VERSION,
+  getFeriadosNacionais
+} from "@br-validators/core/feriados";
+function resolveYear(year) {
+  if (year !== void 0 && Number.isInteger(year) && year >= 1900 && year <= 2100) {
+    return year;
+  }
+  return (/* @__PURE__ */ new Date()).getUTCFullYear();
+}
+function formatFeriadoHuman(feriado) {
+  return `${feriado.data} \u2014 ${feriado.nome} (${feriado.tipo})`;
+}
+function runFeriadosListCommand(options, io = { stdout: [], stderr: [] }) {
+  const year = resolveYear(options.year);
+  const feriados = getFeriadosNacionais(year);
+  if (options.json) {
+    const payload = {
+      ok: true,
+      year,
+      total: feriados.length,
+      feriados
+    };
+    if (options.verbose) {
+      payload.capturadoEm = FERIADOS_DATA_VERSION.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  for (const feriado of feriados) {
+    io.stdout.push(formatFeriadoHuman(feriado));
+  }
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${FERIADOS_DATA_VERSION.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runFeriadosList(options, io = { stdout: [], stderr: [] }) {
+  return runFeriadosListCommand(options, io);
+}
+
+// src/commands/tse-municipios/lookup.ts
+import {
+  getCodigosTsePorMunicipio,
+  getMunicipioIbgePorCodigoTse,
+  TSE_MUNICIPIOS_DATA_VERSION
+} from "@br-validators/core/tse-municipios";
+import { getMunicipioPorCodigo as getMunicipioPorCodigo2 } from "@br-validators/core/ibge";
+function normalizeTseInput(raw) {
+  const digits = raw.replace(/\D/g, "");
+  if (digits.length === 5) {
+    return { kind: "tse", value: digits.padStart(5, "0") };
+  }
+  if (digits.length === 7) {
+    return { kind: "ibge", value: Number(digits) };
+  }
+  return null;
+}
+function lookupTseMunicipio(raw) {
+  const normalized = normalizeTseInput(raw);
+  if (!normalized) {
+    return void 0;
+  }
+  if (normalized.kind === "tse") {
+    const ibgeCodigo = getMunicipioIbgePorCodigoTse(normalized.value);
+    if (ibgeCodigo === void 0) {
+      return void 0;
+    }
+    return { kind: "tse-to-ibge", codigoTse: normalized.value, ibgeCodigo };
+  }
+  const codigosTse = getCodigosTsePorMunicipio(normalized.value);
+  if (codigosTse.length === 0) {
+    return void 0;
+  }
+  return { kind: "ibge-to-tse", ibgeCodigo: normalized.value, codigosTse };
+}
+function formatTseLookupHuman(result) {
+  if (result.kind === "tse-to-ibge") {
+    const municipio2 = getMunicipioPorCodigo2(result.ibgeCodigo);
+    const name2 = municipio2 ? `${municipio2.nome} (${municipio2.uf})` : String(result.ibgeCodigo);
+    return `TSE ${result.codigoTse} \u2192 IBGE ${result.ibgeCodigo} \u2014 ${name2}`;
+  }
+  const municipio = getMunicipioPorCodigo2(result.ibgeCodigo);
+  const name = municipio ? `${municipio.nome} (${municipio.uf})` : String(result.ibgeCodigo);
+  return `IBGE ${result.ibgeCodigo} \u2014 ${name} \u2192 TSE ${result.codigosTse.join(", ")}`;
+}
+function runTseMunicipiosLookupCommand(input, options, io = { stdout: [], stderr: [] }) {
+  const normalized = normalizeTseInput(input);
+  if (!normalized) {
+    io.stderr.push("Invalid code. Use 5-digit TSE or 7-digit IBGE municipality code.");
+    return EXIT.USAGE;
+  }
+  const result = lookupTseMunicipio(input);
+  if (!result) {
+    io.stderr.push(`Mapping not found: ${input}`);
+    return EXIT.INVALID;
+  }
+  if (options.json) {
+    const payload = {
+      ok: true,
+      mapping: result
+    };
+    if (options.verbose) {
+      payload.capturadoEm = TSE_MUNICIPIOS_DATA_VERSION.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  io.stdout.push(formatTseLookupHuman(result));
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${TSE_MUNICIPIOS_DATA_VERSION.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runTseMunicipiosLookup(value, options, io = { stdout: [], stderr: [] }) {
+  if (!value?.trim()) {
+    io.stderr.push("Missing code. Pass a 5-digit TSE or 7-digit IBGE municipality code.");
+    return EXIT.USAGE;
+  }
+  return runTseMunicipiosLookupCommand(value.trim(), options, io);
+}
+
+// src/commands/cep/faixa.ts
+import {
+  CEP_FAIXA_DATA_VERSION,
+  getCepFaixaInfo
+} from "@br-validators/core/cep";
+function normalizePrefix(raw) {
+  const digits = raw.replace(/\D/g, "");
+  if (digits.length < 5) {
+    return null;
+  }
+  return digits.slice(0, 5);
+}
+function formatCepFaixaHuman(faixa) {
+  return `${faixa.prefixo} \u2014 ${faixa.cidade} (${faixa.uf}) \xB7 IBGE ${faixa.codigoIbge}`;
+}
+function runCepFaixaCommand(input, options, io = { stdout: [], stderr: [] }) {
+  const prefix = normalizePrefix(input);
+  if (prefix === null) {
+    io.stderr.push("Invalid CEP prefix. Use at least 5 digits (e.g. 01310).");
+    return EXIT.USAGE;
+  }
+  const faixa = getCepFaixaInfo(prefix);
+  if (!faixa) {
+    io.stderr.push(`CEP prefix not found: ${input}`);
+    return EXIT.INVALID;
+  }
+  if (options.json) {
+    const payload = {
+      ok: true,
+      faixa
+    };
+    if (options.verbose) {
+      payload.capturadoEm = CEP_FAIXA_DATA_VERSION.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  io.stdout.push(formatCepFaixaHuman(faixa));
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${CEP_FAIXA_DATA_VERSION.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runCepFaixa(value, options, io = { stdout: [], stderr: [] }) {
+  if (!value?.trim()) {
+    io.stderr.push("Missing CEP prefix. Pass at least 5 digits.");
+    return EXIT.USAGE;
+  }
+  return runCepFaixaCommand(value.trim(), options, io);
+}
+
+// src/commands/ddd/lookup.ts
+import {
+  getDddInfo,
+  TELEFONE_DDD_DATA_VERSION
+} from "@br-validators/core/telefone";
+function normalizeDdd(raw) {
+  const digits = raw.replace(/\D/g, "");
+  if (digits.length === 0) {
+    return null;
+  }
+  return digits.padStart(2, "0").slice(-2);
+}
+function formatDddHuman(info) {
+  const municipios = info.municipios.slice(0, 3).join(", ");
+  const suffix = info.municipios.length > 3 ? "\u2026" : "";
+  return `DDD ${info.ddd} \u2014 ${info.uf} / ${info.regiao} \u2014 ${municipios}${suffix}`;
+}
+function runDddLookupCommand(input, options, io = { stdout: [], stderr: [] }) {
+  const ddd = normalizeDdd(input);
+  if (ddd === null) {
+    io.stderr.push("Invalid DDD. Use 2 digits (e.g. 11).");
+    return EXIT.USAGE;
+  }
+  const info = getDddInfo(ddd);
+  if (!info) {
+    io.stderr.push(`DDD not found: ${input}`);
+    return EXIT.INVALID;
+  }
+  if (options.json) {
+    const payload = {
+      ok: true,
+      ddd: info
+    };
+    if (options.verbose) {
+      payload.capturadoEm = TELEFONE_DDD_DATA_VERSION.capturadoEm;
+    }
+    io.stdout.push(JSON.stringify(payload, null, 2));
+    return EXIT.OK;
+  }
+  io.stdout.push(formatDddHuman(info));
+  if (options.verbose) {
+    io.stdout.push(`capturadoEm: ${TELEFONE_DDD_DATA_VERSION.capturadoEm}`);
+  }
+  return EXIT.OK;
+}
+function runDddLookup(value, options, io = { stdout: [], stderr: [] }) {
+  if (!value?.trim()) {
+    io.stderr.push("Missing DDD code. Pass 2 digits (e.g. 11).");
+    return EXIT.USAGE;
+  }
+  return runDddLookupCommand(value.trim(), options, io);
+}
+
 // src/commands/brcode.ts
 import {
   BRCODE_OFFICIAL_SOURCE_URL,
@@ -453,6 +927,45 @@ function printNfeChaveValidation(result, options, io = { stdout: [], stderr: []
   io.stderr.push(`message: ${result.message}`);
   return EXIT.INVALID;
 }
+function printProcessoJudicialValidation(result, options, io = { stdout: [], stderr: [] }) {
+  if (options.json) {
+    io.stdout.push(
+      JSON.stringify(
+        result.ok ? {
+          ok: true,
+          value: result.value,
+          format: result.format,
+          segments: result.segments,
+          ...options.source ? { source: options.source } : {}
+        } : { ok: false, code: result.code, message: result.message },
+        null,
+        2
+      )
+    );
+    return result.ok ? EXIT.OK : EXIT.INVALID;
+  }
+  if (options.quiet) {
+    return result.ok ? EXIT.OK : EXIT.INVALID;
+  }
+  if (result.ok) {
+    io.stdout.push(`valid: yes (${result.format})`);
+    io.stdout.push(`value: ${result.value}`);
+    io.stdout.push(`sequencial: ${result.segments.sequencial}`);
+    io.stdout.push(`checkDigits: ${result.segments.checkDigits}`);
+    io.stdout.push(`ano: ${result.segments.ano}`);
+    io.stdout.push(`segmentoJustica: ${result.segments.segmentoJustica}`);
+    io.stdout.push(`tribunal: ${result.segments.tribunal}`);
+    io.stdout.push(`origem: ${result.segments.origem}`);
+    if (options.source) {
+      io.stdout.push(`source: ${options.source}`);
+    }
+    return EXIT.OK;
+  }
+  io.stderr.push("valid: no");
+  io.stderr.push(`code: ${result.code}`);
+  io.stderr.push(`message: ${result.message}`);
+  return EXIT.INVALID;
+}
 function printFormat(result, options, io = { stdout: [], stderr: [] }) {
   if (options.json) {
     io.stdout.push(JSON.stringify(result, null, 2));
@@ -623,6 +1136,146 @@ function runCnh(action, value, options, io = { stdout: [], stderr: [] }) {
   return runCnhCommand(action, input, options, io);
 }
 
+// src/commands/processo-judicial.ts
+import {
+  PROCESSO_JUDICIAL_OFFICIAL_SOURCE_URL,
+  formatProcessoJudicial,
+  stripProcessoJudicial,
+  validateProcessoJudicial
+} from "@br-validators/core/processo-judicial";
+function resolveInput5(value, fileContent) {
+  const input = value ?? fileContent?.trim();
+  if (!input) {
+    return null;
+  }
+  return input;
+}
+function runProcessoJudicialCommand(action, input, options, io = { stdout: [], stderr: [] }) {
+  const source = options.source ? PROCESSO_JUDICIAL_OFFICIAL_SOURCE_URL : void 0;
+  switch (action) {
+    case "validate":
+      return printValidation(validateProcessoJudicial(input), { json: options.json, quiet: options.quiet, source }, io);
+    case "parse":
+      return printProcessoJudicialValidation(validateProcessoJudicial(input), { json: options.json, quiet: options.quiet, source }, io);
+    case "format":
+      return printFormat(formatProcessoJudicial(input), { json: options.json, quiet: options.quiet }, io);
+    case "strip":
+      return printStrip(stripProcessoJudicial(input), { json: options.json }, io);
+    default: {
+      const _exhaustive = action;
+      io.stderr.push(`Unknown action: ${_exhaustive}`);
+      return EXIT.USAGE;
+    }
+  }
+}
+function runProcessoJudicial(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput5(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing processo judicial value. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  return runProcessoJudicialCommand(action, input, options, io);
+}
+
+// src/commands/rg.ts
+import {
+  RG_SUPPORTED_UFS,
+  formatRg,
+  getRgOfficialSourceUrl,
+  stripRg,
+  validateRg
+} from "@br-validators/core/rg";
+function resolveInput6(value, fileContent) {
+  const input = value ?? fileContent?.trim();
+  if (!input) {
+    return null;
+  }
+  return input;
+}
+function resolveRgUf(uf) {
+  if (uf === void 0) {
+    return null;
+  }
+  const normalized = uf.toUpperCase();
+  if (RG_SUPPORTED_UFS.includes(normalized)) {
+    return normalized;
+  }
+  return null;
+}
+function printRgValidation(result, options, io = { stdout: [], stderr: [] }) {
+  if (options.json) {
+    io.stdout.push(
+      JSON.stringify(
+        result.ok ? {
+          ok: true,
+          value: result.value,
+          uf: result.uf,
+          format: result.format,
+          checkDigitValidated: result.checkDigitValidated,
+          ...options.source ? { source: options.source } : {}
+        } : {
+          ok: false,
+          code: result.code,
+          message: result.message,
+          ...result.uf ? { uf: result.uf } : {}
+        },
+        null,
+        2
+      )
+    );
+    return result.ok ? EXIT.OK : EXIT.INVALID;
+  }
+  if (options.quiet) {
+    return result.ok ? EXIT.OK : EXIT.INVALID;
+  }
+  if (result.ok) {
+    io.stdout.push(`valid: yes (${result.uf})`);
+    io.stdout.push(`checkDigitValidated: ${result.checkDigitValidated ? "yes" : "no"}`);
+    io.stdout.push(`value: ${result.value}`);
+    io.stdout.push(`format: ${result.format}`);
+    if (options.source) {
+      io.stdout.push(`source: ${options.source}`);
+    }
+    return EXIT.OK;
+  }
+  io.stderr.push("valid: no");
+  io.stderr.push(`code: ${result.code}`);
+  io.stderr.push(`message: ${result.message}`);
+  if (result.uf) {
+    io.stderr.push(`uf: ${result.uf}`);
+  }
+  return EXIT.INVALID;
+}
+function runRgCommand(action, input, options, io = { stdout: [], stderr: [] }) {
+  const uf = resolveRgUf(options.uf);
+  if (!uf) {
+    io.stderr.push(`Missing or invalid --uf. Use one of: ${RG_SUPPORTED_UFS.join(", ")}.`);
+    return EXIT.USAGE;
+  }
+  const source = options.source ? getRgOfficialSourceUrl(uf) : void 0;
+  switch (action) {
+    case "validate":
+      return printRgValidation(validateRg(input, { uf }), { json: options.json, quiet: options.quiet, source }, io);
+    case "format":
+      return printFormat(formatRg(input, { uf }), { json: options.json, quiet: options.quiet }, io);
+    case "strip":
+      return printStrip(stripRg(input, { uf }), { json: options.json }, io);
+    default: {
+      const _exhaustive = action;
+      io.stderr.push(`Unknown action: ${_exhaustive}`);
+      return EXIT.USAGE;
+    }
+  }
+}
+function runRg(action, value, options, io = { stdout: [], stderr: [] }) {
+  const input = resolveInput6(value, options.file);
+  if (input === null) {
+    io.stderr.push("Missing RG value. Pass an argument or use --file.");
+    return EXIT.USAGE;
+  }
+  return runRgCommand(action, input, options, io);
+}
+
 // src/commands/renavam.ts
 import {
   RENAVAM_OFFICIAL_SOURCE_URL,
@@ -630,7 +1283,7 @@ import {
   stripRenavam,
   validateRenavam
 } from "@br-validators/core";
-function resolveInput5(value, fileContent) {
+function resolveInput7(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -654,7 +1307,7 @@ function runRenavamCommand(action, input, options, io = { stdout: [], stderr: []
   }
 }
 function runRenavam(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput5(value, options.file);
+  const input = resolveInput7(value, options.file);
   if (input === null) {
     io.stderr.push("Missing RENAVAM value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -669,7 +1322,7 @@ import {
   stripTituloEleitor,
   validateTituloEleitor
 } from "@br-validators/core";
-function resolveInput6(value, fileContent) {
+function resolveInput8(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -693,7 +1346,7 @@ function runTituloEleitorCommand(action, input, options, io = { stdout: [], stde
   }
 }
 function runTituloEleitor(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput6(value, options.file);
+  const input = resolveInput8(value, options.file);
   if (input === null) {
     io.stderr.push("Missing T\xEDtulo de Eleitor value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -709,7 +1362,7 @@ import {
   stripNfeChave,
   validateNfeChave
 } from "@br-validators/core";
-function resolveInput7(value, fileContent) {
+function resolveInput9(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -735,7 +1388,7 @@ function runNfeChaveCommand(action, input, options, io = { stdout: [], stderr: [
   }
 }
 function runNfeChave(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput7(value, options.file);
+  const input = resolveInput9(value, options.file);
   if (input === null) {
     io.stderr.push("Missing NF-e chave de acesso value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -750,7 +1403,7 @@ import {
   stripCnpj,
   validateCnpj
 } from "@br-validators/core";
-function resolveInput8(value, fileContent) {
+function resolveInput10(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -774,7 +1427,7 @@ function runCnpjCommand(action, input, options, io = { stdout: [], stderr: [] })
   }
 }
 function runCnpj(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput8(value, options.file);
+  const input = resolveInput10(value, options.file);
   if (input === null) {
     io.stderr.push("Missing CNPJ value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -789,7 +1442,7 @@ import {
   stripCpf,
   validateCpf
 } from "@br-validators/core";
-function resolveInput9(value, fileContent) {
+function resolveInput11(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -813,7 +1466,7 @@ function runCpfCommand(action, input, options, io = { stdout: [], stderr: [] })
   }
 }
 function runCpf(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput9(value, options.file);
+  const input = resolveInput11(value, options.file);
   if (input === null) {
     io.stderr.push("Missing CPF value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -829,7 +1482,7 @@ import {
   stripPlaca,
   validatePlaca
 } from "@br-validators/core";
-function resolveInput10(value, fileContent) {
+function resolveInput12(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -855,7 +1508,7 @@ function runPlacaCommand(action, input, options, io = { stdout: [], stderr: [] }
   }
 }
 function runPlaca(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput10(value, options.file);
+  const input = resolveInput12(value, options.file);
   if (input === null) {
     io.stderr.push("Missing placa value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -870,7 +1523,7 @@ import {
   stripPisPasep,
   validatePisPasep
 } from "@br-validators/core";
-function resolveInput11(value, fileContent) {
+function resolveInput13(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -894,7 +1547,7 @@ function runPisPasepCommand(action, input, options, io = { stdout: [], stderr: [
   }
 }
 function runPisPasep(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput11(value, options.file);
+  const input = resolveInput13(value, options.file);
   if (input === null) {
     io.stderr.push("Missing PIS/PASEP value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -909,7 +1562,7 @@ import {
   formatPixKey,
   validatePixKey
 } from "@br-validators/core";
-function resolveInput12(value, fileContent) {
+function resolveInput14(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -984,7 +1637,7 @@ function runPixCommand(action, input, options, io = { stdout: [], stderr: [] })
   }
 }
 function runPix(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput12(value, options.file);
+  const input = resolveInput14(value, options.file);
   if (input === null) {
     io.stderr.push("Missing PIX key value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -1003,7 +1656,7 @@ import {
   stripLinhaDigitavel,
   validateBoleto
 } from "@br-validators/core";
-function resolveInput13(value, fileContent) {
+function resolveInput15(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -1138,7 +1791,7 @@ function runBoletoCommand(action, input, options, direction, io = { stdout: [],
   }
 }
 function runBoleto(action, value, options, direction, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput13(value, options.file);
+  const input = resolveInput15(value, options.file);
   if (input === null) {
     io.stderr.push("Missing boleto value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -1154,7 +1807,7 @@ import {
   stripCartaoCredito,
   validateCartaoCredito
 } from "@br-validators/core";
-function resolveInput14(value, fileContent) {
+function resolveInput16(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -1230,7 +1883,7 @@ function runCartaoCommand(action, input, options, io = { stdout: [], stderr: []
   }
 }
 function runCartao(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput14(value, options.file);
+  const input = resolveInput16(value, options.file);
   if (input === null) {
     io.stderr.push("Missing credit card PAN value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -1251,7 +1904,7 @@ import {
   validateIeProdutorRural,
   validateInscricaoEstadual
 } from "@br-validators/core";
-function resolveInput15(value, fileContent) {
+function resolveInput17(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -1348,7 +2001,7 @@ function runIeCommand(action, input, options, io = { stdout: [], stderr: [] }) {
   }
 }
 function runIe(action, value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput15(value, options.file);
+  const input = resolveInput17(value, options.file);
   if (input === null) {
     io.stderr.push("Missing IE value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -1358,7 +2011,7 @@ function runIe(action, value, options, io = { stdout: [], stderr: [] }) {
 
 // src/commands/detect.ts
 import { detect } from "@br-validators/core";
-function resolveInput16(value, fileContent) {
+function resolveInput18(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -1392,7 +2045,7 @@ function printDetect(result, options, io = { stdout: [], stderr: [] }) {
   return EXIT.INVALID;
 }
 function runDetect(value, options, io = { stdout: [], stderr: [] }) {
-  const input = resolveInput16(value, options.file);
+  const input = resolveInput18(value, options.file);
   if (input === null) {
     io.stderr.push("Missing value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -1423,7 +2076,7 @@ var SANITIZABLE_TYPES = [
 function isSanitizableType(type) {
   return SANITIZABLE_TYPES.includes(type);
 }
-function resolveInput17(value, fileContent) {
+function resolveInput19(value, fileContent) {
   const input = value ?? fileContent?.trim();
   if (!input) {
     return null;
@@ -1454,7 +2107,7 @@ function runSanitize(type, value, options, io = { stdout: [], stderr: [] }) {
     io.stderr.push(`Unsupported sanitize type: ${type}`);
     return EXIT.USAGE;
   }
-  const input = resolveInput17(value, options.file);
+  const input = resolveInput19(value, options.file);
   if (input === null) {
     io.stderr.push("Missing value. Pass an argument or use --file.");
     return EXIT.USAGE;
@@ -1824,6 +2477,27 @@ function handleTituloEleitorCli(action, value, opts, io = { stdout: [], stderr:
     io
   );
 }
+function handleProcessoJudicialCli(action, value, opts, io = { stdout: [], stderr: [] }) {
+  let fileContent;
+  if (opts.file) {
+    const content = readInputFile(opts.file, io);
+    if (content === null) {
+      return EXIT.USAGE;
+    }
+    fileContent = content;
+  }
+  return runProcessoJudicial(
+    action,
+    value,
+    {
+      json: Boolean(opts.json),
+      quiet: Boolean(opts.quiet),
+      source: Boolean(opts.source),
+      file: fileContent
+    },
+    io
+  );
+}
 function handleNfeChaveCli(action, value, opts, io = { stdout: [], stderr: [] }) {
   let fileContent;
   if (opts.file) {
@@ -1888,6 +2562,28 @@ function handleIeCli(action, value, opts, io = { stdout: [], stderr: [] }) {
     io
   );
 }
+function handleRgCli(action, value, opts, io = { stdout: [], stderr: [] }) {
+  let fileContent;
+  if (opts.file) {
+    const content = readInputFile(opts.file, io);
+    if (content === null) {
+      return EXIT.USAGE;
+    }
+    fileContent = content;
+  }
+  return runRg(
+    action,
+    value,
+    {
+      json: Boolean(opts.json),
+      quiet: Boolean(opts.quiet),
+      source: Boolean(opts.source),
+      uf: opts.uf,
+      file: fileContent
+    },
+    io
+  );
+}
 function handleDetectCli(value, opts, io = { stdout: [], stderr: [] }) {
   let fileContent;
   if (opts.file) {
@@ -1975,10 +2671,50 @@ function handleReferenceLookupCli(command, value, opts, io = { stdout: [], stder
     io
   );
 }
+function handleReferenceSearchCli(command, query, opts, io = { stdout: [], stderr: [] }) {
+  return runReferenceSearch(
+    command,
+    query,
+    {
+      json: Boolean(opts.json),
+      verbose: Boolean(opts.verbose),
+      limit: opts.limit
+    },
+    io
+  );
+}
+function handleIbgeLookupCli(value, opts, io = { stdout: [], stderr: [] }) {
+  return runIbgeLookup(value, { json: Boolean(opts.json), verbose: Boolean(opts.verbose) }, io);
+}
+function handleIbgeListCli(target, opts, io = { stdout: [], stderr: [] }) {
+  return runIbgeList(target, {
+    json: Boolean(opts.json),
+    verbose: Boolean(opts.verbose),
+    uf: opts.uf,
+    limit: opts.limit
+  }, io);
+}
+function handleFeriadosListCli(opts, io = { stdout: [], stderr: [] }) {
+  return runFeriadosList({
+    json: Boolean(opts.json),
+    verbose: Boolean(opts.verbose),
+    year: opts.year
+  }, io);
+}
+function handleTseMunicipiosLookupCli(value, opts, io = { stdout: [], stderr: [] }) {
+  return runTseMunicipiosLookup(value, { json: Boolean(opts.json), verbose: Boolean(opts.verbose) }, io);
+}
+function handleCepFaixaCli(value, opts, io = { stdout: [], stderr: [] }) {
+  return runCepFaixa(value, { json: Boolean(opts.json), verbose: Boolean(opts.verbose) }, io);
+}
+function handleDddLookupCli(value, opts, io = { stdout: [], stderr: [] }) {
+  return runDddLookup(value, { json: Boolean(opts.json), verbose: Boolean(opts.verbose) }, io);
+}
 
 // src/argv-dispatch.ts
 var STANDARD_ACTIONS = ["validate", "format", "strip"];
 var NFE_ACTIONS = ["validate", "parse", "format", "strip"];
+var PROCESSO_JUDICIAL_ACTIONS = ["validate", "parse", "format", "strip"];
 var BRCODE_ACTIONS = ["parse", "validate"];
 var PLACA_ACTIONS = ["validate", "format", "strip", "convert"];
 var PIX_ACTIONS = ["detect", "validate", "format"];
@@ -2047,6 +2783,11 @@ function parseArgv(tokens) {
       index += 1;
       continue;
     }
+    if (token === "--year") {
+      opts.year = Number(tokens[index + 1]);
+      index += 1;
+      continue;
+    }
     if (token.startsWith("-")) {
       continue;
     }
@@ -2069,7 +2810,7 @@ function dispatchArgv(tokens, io) {
   if (tokens.length === 0 || tokens.includes("--help") || tokens.includes("-h")) {
     io.stdout.push("br-validators \u2014 100% open-source Brazilian document validators");
     io.stdout.push("Usage: br-validators <command> ...");
-    io.stdout.push("Commands: list \xB7 cpf \xB7 cnpj \xB7 cep \xB7 telefone \xB7 cnh \xB7 renavam \xB7 titulo-eleitor \xB7 nfe-chave \xB7 brcode \xB7 placa \xB7 pis-pasep \xB7 pix \xB7 boleto \xB7 cartao \xB7 cartao-credito \xB7 ie \xB7 bancos \xB7 natureza-juridica \xB7 nbs \xB7 cest \xB7 moedas \xB7 paises-bacen \xB7 incoterms \xB7 portos \xB7 aeroportos \xB7 detect \xB7 sanitize \xB7 generate");
+    io.stdout.push("Commands: list \xB7 cpf \xB7 cnpj \xB7 cep \xB7 telefone \xB7 cnh \xB7 renavam \xB7 titulo-eleitor \xB7 processo-judicial \xB7 rg \xB7 nfe-chave \xB7 brcode \xB7 placa \xB7 pis-pasep \xB7 pix \xB7 boleto \xB7 cartao \xB7 cartao-credito \xB7 ie \xB7 bancos \xB7 ibge \xB7 feriados \xB7 tse-municipios \xB7 ddd \xB7 natureza-juridica \xB7 nbs \xB7 cest \xB7 cnae \xB7 cfop \xB7 ncm \xB7 cbo \xB7 moedas \xB7 paises-bacen \xB7 incoterms \xB7 portos \xB7 aeroportos \xB7 detect \xB7 sanitize \xB7 generate");
     return EXIT.OK;
   }
   if (tokens.includes("--version") || tokens.includes("-V")) {
@@ -2088,8 +2829,18 @@ function dispatchArgv(tokens, io) {
       return dispatchStandard(rest, opts, io, handleCnpjCli);
     case "cpf":
       return dispatchStandard(rest, opts, io, handleCpfCli);
-    case "cep":
-      return dispatchStandard(rest, opts, io, handleCepCli);
+    case "cep": {
+      const action = rest[0];
+      if (action === "faixa") {
+        const value2 = rest.slice(1).join(" ") || void 0;
+        return handleCepFaixaCli(value2, opts, io);
+      }
+      if (!action || !STANDARD_ACTIONS.includes(action)) {
+        return usage(io, "Expected action: validate | format | strip | faixa <prefix>");
+      }
+      const value = rest.slice(1).join(" ") || void 0;
+      return handleCepCli(action, value, opts, io);
+    }
     case "telefone":
       return dispatchStandard(rest, opts, io, handleTelefoneCli);
     case "cnh":
@@ -2098,6 +2849,19 @@ function dispatchArgv(tokens, io) {
       return dispatchStandard(rest, opts, io, handleRenavamCli);
     case "titulo-eleitor":
       return dispatchStandard(rest, opts, io, handleTituloEleitorCli);
+    case "processo-judicial": {
+      const action = rest[0];
+      if (!action || !PROCESSO_JUDICIAL_ACTIONS.includes(action)) {
+        return usage(io, "Expected action: validate | parse | format | strip");
+      }
+      const value = rest.slice(1).join(" ") || void 0;
+      return handleProcessoJudicialCli(
+        action,
+        value,
+        opts,
+        io
+      );
+    }
     case "nfe-chave": {
       const action = rest[0];
       if (!action || !NFE_ACTIONS.includes(action)) {
@@ -2171,6 +2935,13 @@ function dispatchArgv(tokens, io) {
         io,
         (action, value, ieOpts, ioArg) => handleIeCli(action, value, ieOpts, ioArg)
       );
+    case "rg":
+      return dispatchStandard(
+        rest,
+        opts,
+        io,
+        (action, value, rgOpts, ioArg) => handleRgCli(action, value, rgOpts, ioArg)
+      );
     case "bancos": {
       const action = rest[0];
       if (action === "lookup") {
@@ -2182,6 +2953,47 @@ function dispatchArgv(tokens, io) {
       }
       return usage(io, "Expected: bancos lookup <codigo|ispb> | bancos list [--limit n]");
     }
+    case "ibge": {
+      const action = rest[0];
+      if (action === "lookup") {
+        const value = rest.slice(1).join(" ") || void 0;
+        return handleIbgeLookupCli(value, opts, io);
+      }
+      if (action === "list") {
+        const target = rest[1];
+        if (target === "estados") {
+          return handleIbgeListCli("estados", opts, io);
+        }
+        if (target === "municipios") {
+          return handleIbgeListCli("municipios", opts, io);
+        }
+        return usage(io, "Expected: ibge list estados | ibge list municipios [--uf UF] [--limit n]");
+      }
+      return usage(io, "Expected: ibge lookup <codigo> | ibge list estados | ibge list municipios");
+    }
+    case "feriados": {
+      const action = rest[0];
+      if (action === "list") {
+        return handleFeriadosListCli(opts, io);
+      }
+      return usage(io, "Expected: feriados list [--year YYYY]");
+    }
+    case "tse-municipios": {
+      const action = rest[0];
+      if (action === "lookup") {
+        const value = rest.slice(1).join(" ") || void 0;
+        return handleTseMunicipiosLookupCli(value, opts, io);
+      }
+      return usage(io, "Expected: tse-municipios lookup <codigo-tse|codigo-ibge>");
+    }
+    case "ddd": {
+      const action = rest[0];
+      if (action === "lookup") {
+        const value = rest.slice(1).join(" ") || void 0;
+        return handleDddLookupCli(value, opts, io);
+      }
+      return usage(io, "Expected: ddd lookup <code>");
+    }
     case "detect":
       return handleDetectCli(rest.join(" ") || void 0, opts, io);
     case "sanitize":
@@ -2195,7 +3007,12 @@ function dispatchArgv(tokens, io) {
           const value = rest.slice(1).join(" ") || void 0;
           return handleReferenceLookupCli(root, value, opts, io);
         }
-        return usage(io, `Expected: ${root} lookup <codigo>`);
+        if (action === "search" && isReferenceSearchCommand(root)) {
+          const value = rest.slice(1).join(" ") || void 0;
+          return handleReferenceSearchCli(root, value, opts, io);
+        }
+        const searchHint = isReferenceSearchCommand(root) ? " | search <query>" : "";
+        return usage(io, `Expected: ${root} lookup <codigo>${searchHint}`);
       }
       return usage(io, `Unknown command: ${root}`);
     }