@sinete/nfe 0.1.0 → 0.3.0

package/src/build/values.ts

@@ -6,8 +6,8 @@
 
 import type { DecimalInput, RoundingMode } from '../decimal.ts';
 import { Decimal } from '../decimal.ts';
-import type { DecimalFormat } from '../format.ts';
-import { formatDecimal, formatProblem } from '../format.ts';
+import type { FormatoDecimal } from '../format.ts';
+import { formatarDecimal, problemaDeFormato } from '../format.ts';
 import type { Issues } from '../issues.ts';
 
 /** Famílias de campo com modo de arredondamento próprio (`data/arredondamento.json`). */
@@ -32,23 +32,23 @@ export class Ctx {
   }
 
   /** Entrada opcional; inválida vira ocorrência e `undefined`. */
-  opt(value: DecimalInput | undefined, path: string, format: DecimalFormat): Decimal | undefined {
+  opt(value: DecimalInput | undefined, path: string, format: FormatoDecimal): Decimal | undefined {
     if (value === undefined) return undefined;
     const d = Decimal.tryOf(value);
     if (d === undefined) {
       this.issues.add(path, 'decimal_invalido', 'número decimal inválido (use ponto como separador, sem milhar)');
       return undefined;
     }
-    const problem = formatProblem(d, format);
+    const problem = problemaDeFormato(d, format);
     if (problem !== undefined) {
-      this.issues.add(path, 'decimal_invalido', `${problem} (${format.name})`);
+      this.issues.add(path, 'decimal_invalido', `${problem} (${format.nome})`);
       return undefined;
     }
     return d;
   }
 
   /** Entrada obrigatória; ausente ou inválida vira ocorrência e zero, para que a montagem siga e junte tudo. */
-  req(value: DecimalInput | undefined, path: string, format: DecimalFormat): Decimal {
+  req(value: DecimalInput | undefined, path: string, format: FormatoDecimal): Decimal {
     if (value === undefined) {
       this.issues.add(path, 'campo_obrigatorio', 'campo obrigatório');
       return Decimal.ZERO;
@@ -57,7 +57,7 @@ export class Ctx {
   }
 
   /** Arredonda um valor calculado no formato do campo pelo modo da família. */
-  round(value: Decimal, format: DecimalFormat, familia: Familia): Decimal {
+  round(value: Decimal, format: FormatoDecimal, familia: Familia): Decimal {
     return value.round(format.max, this.modes[familia]);
   }
 
@@ -73,7 +73,7 @@ export class Ctx {
     given: DecimalInput | undefined,
     padrao: Decimal,
     path: string,
-    format: DecimalFormat,
+    format: FormatoDecimal,
     familia: Familia,
   ): Decimal {
     return this.opt(given, path, format) ?? this.round(padrao, format, familia);
@@ -83,7 +83,7 @@ export class Ctx {
     given: DecimalInput | undefined,
     computed: Decimal,
     path: string,
-    format: DecimalFormat,
+    format: FormatoDecimal,
     familia: Familia,
   ): Decimal {
     const r = this.round(computed, format, familia);
@@ -101,15 +101,15 @@ export class Ctx {
   }
 
   /** Texto no formato do campo. */
-  s(value: Decimal, format: DecimalFormat): string {
-    return formatDecimal(value, format);
+  s(value: Decimal, format: FormatoDecimal): string {
+    return formatarDecimal(value, format);
   }
 
   /** Texto opcional: ausente fica ausente, e zero some nos formatos que não aceitam zero. */
-  so(value: Decimal | undefined, format: DecimalFormat): string | undefined {
+  so(value: Decimal | undefined, format: FormatoDecimal): string | undefined {
     if (value === undefined) return undefined;
-    if (format.nonZero && value.isZero()) return undefined;
-    return formatDecimal(value, format);
+    if (format.naoNulo && value.isZero()) return undefined;
+    return formatarDecimal(value, format);
   }
 }
 

package/src/data/arredondamento.json

@@ -1,5 +1,5 @@
 {
-  "descricao": "Modo de arredondamento dos valores calculados pelo builder, por família de campo. HALF_UP é o arredondamento comercial; HALF_EVEN é o bancário (NBR 5891). Quem emite pode sobrepor por família em BuildNfeOptions.arredondamento.",
+  "descricao": "Modo de arredondamento dos valores calculados pelo builder, por família de campo. HALF_UP é o arredondamento comercial; HALF_EVEN é o bancário (NBR 5891). Quem emite pode sobrepor por família em MontarNfeOpcoes.arredondamento.",
   "atualizadoEm": "2026-09-26",
   "familias": {
     "produto": {

package/src/data/cstat.json

@@ -23,14 +23,14 @@
   "consumoIndevido": ["656"],
   "dicas": {
     "656": {
-      "probableCause": "Consumo indevido: consultas repetidas à Distribuição DF-e sem documento novo (ultNSU igual a maxNSU) ou acima do limite de requisições por hora.",
-      "suggestedFix": "Aguardar uma hora antes de consultar de novo e só repetir a consulta quando ultNSU for menor que maxNSU; guardar o ultNSU devolvido e continuar dele.",
-      "source": "NT 2014.002 v1.02 (Distribuição DF-e), regras de consumo indevido"
+      "causaProvavel": "Consumo indevido: consultas repetidas à Distribuição DF-e sem documento novo (ultNSU igual a maxNSU) ou acima do limite de requisições por hora.",
+      "comoCorrigir": "Aguardar uma hora antes de consultar de novo e só repetir a consulta quando ultNSU for menor que maxNSU; guardar o ultNSU devolvido e continuar dele.",
+      "fonte": "NT 2014.002 v1.02 (Distribuição DF-e), regras de consumo indevido"
     },
     "217": {
-      "probableCause": "A chave consultada não consta na base do autorizador consultado: a nota não foi recebida, ou foi autorizada em outro ambiente ou autorizador (SVC).",
-      "suggestedFix": "Se o envio ficou sem resposta, reenviar exatamente o mesmo XML assinado; se foi emitida em contingência SVC, consultar no SVC.",
-      "source": "MOC 7.0 Anexo I, serviço de consulta protocolo"
+      "causaProvavel": "A chave consultada não consta na base do autorizador consultado: a nota não foi recebida, ou foi autorizada em outro ambiente ou autorizador (SVC).",
+      "comoCorrigir": "Se o envio ficou sem resposta, reenviar exatamente o mesmo XML assinado; se foi emitida em contingência SVC, consultar no SVC.",
+      "fonte": "MOC 7.0 Anexo I, serviço de consulta protocolo"
     }
   }
 }

package/src/data/fusos.json

@@ -1,5 +1,5 @@
 {
-  "descricao": "Deslocamento do horário legal de cada UF em relação a UTC, em minutos, usado para formatar dhEmi, dhSaiEnt, dhCont e dhEvento quando quem emite não informa o fuso. Sem horário de verão desde 2019. UFs com mais de um fuso usam o da capital; o emitente de outro fuso informa offsetMinutes.",
+  "descricao": "Deslocamento do horário legal de cada UF em relação a UTC, em minutos, usado para formatar dhEmi, dhSaiEnt, dhCont e dhEvento quando quem emite não informa o fuso. Sem horário de verão desde 2019. UFs com mais de um fuso usam o da capital; o emitente de outro fuso informa deslocamentoMin.",
   "atualizadoEm": "2026-09-26",
   "fontes": [
     "Lei 11.662/2008 e Lei 12.876/2013 (fusos horários do Brasil; Acre em UTC-5)",

package/src/data/nfce-urls.json

@@ -1,10 +1,10 @@
 {
-  "descricao": "Endereços da NFC-e (modelo 65) por UF e ambiente: a consulta via QR Code (1ª parte da URL do infNFeSupl/qrCode, sem o '?p=' que o builder acrescenta) e a consulta por chave de acesso (infNFeSupl/urlChave, impressa no DANFC-e). Cada UF tem uma lista de endereços com a data de início ('desde', AAAA-MM-DD, 00:00 de Brasília); vale o mais recente cujo início não passou da data de emissão. As tabelas do ENCAT foram transcritas como publicadas, com três ajustes: o '?' final e o exemplo de parâmetros (AM: '?chNFe=1315....') foram retirados, porque o builder monta a query; o espaço dentro do endereço de homologação do MA ('homolog acao') foi juntado; e o endereço de MG por chave de acesso vem da página de web services da própria SEFAZ-MG, mais nova que a do ENCAT. Onde a tabela não dá o protocolo ('http://' ou 'https://'), a URL do QR Code fica null: o schema exige o protocolo e não há fonte para escolher um; informe BuildNfeOptions.urlQrCode. A regra ZX02-20 (rejeição 395) compara o endereço sem diferenciar maiúsculas e minúsculas; ZX03-20 (rejeição 878) é opcional por UF.",
+  "descricao": "Endereços da NFC-e (modelo 65) por UF e ambiente: a consulta via QR Code (1ª parte da URL do infNFeSupl/qrCode, sem o '?p=' que o builder acrescenta) e a consulta por chave de acesso (infNFeSupl/urlChave, impressa no DANFC-e). Cada UF tem uma lista de endereços com a data de início ('desde', AAAA-MM-DD, 00:00 de Brasília); vale o mais recente cujo início não passou da data de emissão. As tabelas do ENCAT foram transcritas como publicadas, com três ajustes: o '?' final e o exemplo de parâmetros (AM: '?chNFe=1315....') foram retirados, porque o builder monta a query; o espaço dentro do endereço de homologação do MA ('homolog acao') foi juntado; e o endereço de MG por chave de acesso vem da página de web services da própria SEFAZ-MG, mais nova que a do ENCAT. Onde a tabela não dá o protocolo ('http://' ou 'https://'), a URL do QR Code fica null: o schema exige o protocolo e não há fonte para escolher um; informe MontarNfeOpcoes.urlQrCode. A regra ZX02-20 (rejeição 395) compara o endereço sem diferenciar maiúsculas e minúsculas; ZX03-20 (rejeição 878) é opcional por UF.",
   "atualizadoEm": "2026-09-26",
   "fontes": [
     "Portal Nacional da NFC-e (ENCAT), URL por UF utilizada QR code: https://nfce.encat.org/desenvolvedor/qrcode/ (coletada em 26/09/2026)",
     "Portal Nacional da NFC-e (ENCAT), URL por UF utilizada para consulta chave, QR Code versão 2.0: https://nfce.encat.org/desenvolvedor/httpnfce-encat-orgconsulte-sua-nota-qr-code-versao-2-0/ (coletada em 26/09/2026)",
-    "SEFAZ-MG, web services da NFC-e: https://portalsped.fazenda.mg.gov.br/spedmg/nfce/web-services/ (a mesma fonte do nfceConsultaUrls do @sinete/transport) (coletada em 26/09/2026)",
+    "SEFAZ-MG, web services da NFC-e: https://portalsped.fazenda.mg.gov.br/spedmg/nfce/web-services/ (a mesma fonte do urlsConsultaNfce do @sinete/transport) (coletada em 26/09/2026)",
     "MOC 7.0 Anexo I, regras ZX02-20 e ZX03-20; NT 2025.001 v1.03, grupo ZX (campos ZX02 qrCode e ZX03 urlChave)"
   ],
   "qrCode": {

package/src/data/produtor-rural.json

@@ -1,5 +1,5 @@
 {
-  "descricao": "Regras do produtor rural que variam no tempo ou por UF. refNFP: a nota fiscal de produtor em papel (modelo 04) foi extinta; uma NF-e ainda pode referenciar uma nota modelo 04 emitida antes do fim da vigência na UF da nota referenciada. vedadaDesde é o primeiro AAMM em que a UF não aceita mais nota modelo 04 emitida; a referência a nota com AAMM igual ou posterior é recusada pelo builder. series: faixas de série por tipo de emitente na emissão pelo contribuinte (procEmi 0, a única que o buildNfe monta).",
+  "descricao": "Regras do produtor rural que variam no tempo ou por UF. refNFP: a nota fiscal de produtor em papel (modelo 04) foi extinta; uma NF-e ainda pode referenciar uma nota modelo 04 emitida antes do fim da vigência na UF da nota referenciada. vedadaDesde é o primeiro AAMM em que a UF não aceita mais nota modelo 04 emitida; a referência a nota com AAMM igual ou posterior é recusada pelo builder. series: faixas de série por tipo de emitente na emissão pelo contribuinte (procEmi 0, a única que o montarNfe monta).",
   "atualizadoEm": "2026-09-28",
   "refNFP": {
     "modelo04": {

package/src/data/resp-tec.json

@@ -1,5 +1,5 @@
 {
-  "descricao": "Exigência do grupo infRespTec e do CSRT por UF do emitente, com vigência por ambiente. infRespTec: 'obrigatorio' faz o builder recusar a nota sem responsável técnico; 'opcional' só o inclui quando informado. csrt: 'obrigatorio' exige idCSRT e hashCSRT (rejeição 975). Datas no formato AAAA-MM-DD, a partir de 00:00 de Brasília. UF ausente usa o padrão. A adesão é de cada UF (NT 2018.005); quem emite pode sobrepor em BuildNfeOptions.",
+  "descricao": "Exigência do grupo infRespTec e do CSRT por UF do emitente, com vigência por ambiente. infRespTec: 'obrigatorio' faz o builder recusar a nota sem responsável técnico; 'opcional' só o inclui quando informado. csrt: 'obrigatorio' exige idCSRT e hashCSRT (rejeição 975). Datas no formato AAAA-MM-DD, a partir de 00:00 de Brasília. UF ausente usa o padrão. A adesão é de cada UF (NT 2018.005); quem emite pode sobrepor em MontarNfeOpcoes.",
   "atualizadoEm": "2026-09-26",
   "fonte": "NT 2018.005 v1.50 (responsável técnico e CSRT, adesão a critério da UF)",
   "padrao": { "infRespTec": "opcional", "csrt": "opcional" },

package/src/decimal.ts

@@ -12,7 +12,7 @@
  * Qual modo vale para qual campo é dado (`data/arredondamento.json`), não regra espalhada no código.
  */
 
-import { ConfigError } from '@sinete/core';
+import { ErroDeConfiguracao } from '@sinete/core';
 
 export type RoundingMode = 'HALF_EVEN' | 'HALF_UP' | 'DOWN';
 
@@ -44,7 +44,8 @@ export class Decimal {
 
   /** Constrói a partir do coeficiente e da escala (`fromParts(1234n, 2)` = 12.34). */
   static fromParts(coef: bigint, scale: number): Decimal {
-    if (!Number.isInteger(scale) || scale < 0 || scale > MAX_SCALE) throw new ConfigError(`escala inválida: ${scale}`);
+    if (!Number.isInteger(scale) || scale < 0 || scale > MAX_SCALE)
+      throw new ErroDeConfiguracao(`escala inválida: ${scale}`);
     return new Decimal(coef, scale);
   }
 
@@ -54,7 +55,7 @@ export class Decimal {
    */
   static of(input: DecimalInput): Decimal {
     const d = Decimal.tryOf(input);
-    if (d === undefined) throw new ConfigError(`número decimal inválido: ${JSON.stringify(String(input))}`);
+    if (d === undefined) throw new ErroDeConfiguracao(`número decimal inválido: ${JSON.stringify(String(input))}`);
     return d;
   }
 
@@ -114,7 +115,7 @@ export class Decimal {
   /** Divisão com o resultado arredondado em `scale` casas pelo modo dado. */
   dividedBy(other: DecimalInput, scale: number, mode: RoundingMode): Decimal {
     const o = Decimal.of(other);
-    if (o.coef === 0n) throw new ConfigError('divisão por zero');
+    if (o.coef === 0n) throw new ErroDeConfiguracao('divisão por zero');
     // (a / 10^sa) / (b / 10^sb) = a * 10^(sb + scale + 1 - sa) / b, com uma casa de guarda para o arredondamento.
     const shift = o.scale + scale + 1 - this.scale;
     const num = shift >= 0 ? this.coef * pow10(shift) : this.coef;
@@ -140,7 +141,7 @@ export class Decimal {
 
   /** Arredonda para `scale` casas. Com `scale` maior que a atual, só completa com zeros. */
   round(scale: number, mode: RoundingMode): Decimal {
-    if (!Number.isInteger(scale) || scale < 0) throw new ConfigError(`casas decimais inválidas: ${scale}`);
+    if (!Number.isInteger(scale) || scale < 0) throw new ErroDeConfiguracao(`casas decimais inválidas: ${scale}`);
     if (scale >= this.scale) return new Decimal(this.coef * pow10(scale - this.scale), scale);
     return roundCoef(this.coef, this.scale, scale, mode, false);
   }
@@ -219,13 +220,13 @@ function roundCoef(coef: bigint, from: number, to: number, mode: RoundingMode, s
 }
 
 /** Atalho para `Decimal.of`. */
-export function dec(input: DecimalInput): Decimal {
-  return Decimal.of(input);
+export function dec(valor: DecimalInput): Decimal {
+  return Decimal.of(valor);
 }
 
 /** Soma uma lista (vazia = zero). */
-export function sum(values: Iterable<Decimal>): Decimal {
+export function sum(valores: Iterable<Decimal>): Decimal {
   let acc = Decimal.ZERO;
-  for (const v of values) acc = acc.plus(v);
+  for (const v of valores) acc = acc.plus(v);
   return acc;
 }

package/src/format.ts

@@ -5,60 +5,61 @@
 
 import type { Decimal, RoundingMode } from './decimal.ts';
 
-export interface DecimalFormat {
+export interface FormatoDecimal {
   /** Nome curto, para mensagens. */
-  readonly name: string;
+  readonly nome: string;
   /** Casas mínimas (completa com zeros até aqui). */
   readonly min: number;
   /** Casas máximas aceitas pelo pattern. */
   readonly max: number;
   /** Casas exigidas quando a parte inteira é zero e o valor não é zero (`TDec_0803v`: `0\.[0-9]{3}`). */
-  readonly minBelowOne?: number;
+  readonly minimoAbaixoDeUm?: number;
   /** O pattern recusa zero (`TDec_1302Opc`, `TDec_0302a04Opc`): o campo zerado deve ser omitido. */
-  readonly nonZero?: boolean;
+  readonly naoNulo?: boolean;
   /** Maior quantidade de dígitos inteiros aceita. */
-  readonly intDigits: number;
+  readonly digitosInteiros: number;
 }
 
 /** `TDec_1302`, `TDec1302RTC`: 13 inteiros e exatamente 2 casas. */
-export const D1302: DecimalFormat = { name: 'TDec_1302', min: 2, max: 2, intDigits: 13 };
+export const D1302: FormatoDecimal = { nome: 'TDec_1302', min: 2, max: 2, digitosInteiros: 13 };
 /** `TDec_1302Opc`: como `TDec_1302`, sem zero. */
-export const D1302_OPC: DecimalFormat = { name: 'TDec_1302Opc', min: 2, max: 2, intDigits: 13, nonZero: true };
+export const D1302_OPC: FormatoDecimal = { nome: 'TDec_1302Opc', min: 2, max: 2, digitosInteiros: 13, naoNulo: true };
 /** `TDec_0302a04`, `TDec_0302_04RTC`, `TDec_0302a04Max100`: 3 inteiros e 2 a 4 casas. */
-export const D0302A04: DecimalFormat = { name: 'TDec_0302a04', min: 2, max: 4, intDigits: 3 };
+export const D0302A04: FormatoDecimal = { nome: 'TDec_0302a04', min: 2, max: 4, digitosInteiros: 3 };
 /** `TDec_0302a04Opc`: o pattern (`0\.[0-9]{2,4}|...`) aceita zero, ao contrário de `TDec_1302Opc`. */
-export const D0302A04_OPC: DecimalFormat = { name: 'TDec_0302a04Opc', min: 2, max: 4, intDigits: 3 };
+export const D0302A04_OPC: FormatoDecimal = { nome: 'TDec_0302a04Opc', min: 2, max: 4, digitosInteiros: 3 };
 /** `TDec_0302Max100`: 2 casas exatas. */
-export const D0302: DecimalFormat = { name: 'TDec_0302Max100', min: 2, max: 2, intDigits: 3 };
+export const D0302: FormatoDecimal = { nome: 'TDec_0302Max100', min: 2, max: 2, digitosInteiros: 3 };
 /** `TDec_1104v`: 11 inteiros e 0 a 4 casas. */
-export const D1104V: DecimalFormat = { name: 'TDec_1104v', min: 0, max: 4, intDigits: 11 };
+export const D1104V: FormatoDecimal = { nome: 'TDec_1104v', min: 0, max: 4, digitosInteiros: 11 };
 /** `TDec_1104`, `TDec1104RTC`: 11 inteiros e 4 casas. */
-export const D1104: DecimalFormat = { name: 'TDec_1104', min: 4, max: 4, intDigits: 11 };
+export const D1104: FormatoDecimal = { nome: 'TDec_1104', min: 4, max: 4, digitosInteiros: 11 };
 /** `TDec_1110v`: 11 inteiros e 0 a 10 casas. */
-export const D1110V: DecimalFormat = { name: 'TDec_1110v', min: 0, max: 10, intDigits: 11 };
+export const D1110V: FormatoDecimal = { nome: 'TDec_1110v', min: 0, max: 10, digitosInteiros: 11 };
 /** `TDec_1204v`: 12 inteiros e 0 a 4 casas. */
-export const D1204V: DecimalFormat = { name: 'TDec_1204v', min: 0, max: 4, intDigits: 12 };
+export const D1204V: FormatoDecimal = { nome: 'TDec_1204v', min: 0, max: 4, digitosInteiros: 12 };
 /** `TDec_1204`: 12 inteiros e 4 casas quando há fração (4 fixas aqui, que o pattern aceita sempre). */
-export const D1204: DecimalFormat = { name: 'TDec_1204', min: 4, max: 4, intDigits: 12 };
+export const D1204: FormatoDecimal = { nome: 'TDec_1204', min: 4, max: 4, digitosInteiros: 12 };
 /** `TDec_1203`: 12 inteiros e 3 casas. */
-export const D1203: DecimalFormat = { name: 'TDec_1203', min: 3, max: 3, intDigits: 12 };
+export const D1203: FormatoDecimal = { nome: 'TDec_1203', min: 3, max: 3, digitosInteiros: 12 };
 /** `TDec_0803v`: 8 inteiros e até 3 casas; abaixo de 1, exatamente 3. */
-export const D0803V: DecimalFormat = { name: 'TDec_0803v', min: 0, max: 3, intDigits: 8, minBelowOne: 3 };
+export const D0803V: FormatoDecimal = { nome: 'TDec_0803v', min: 0, max: 3, digitosInteiros: 8, minimoAbaixoDeUm: 3 };
 
 /** Texto do valor já arredondado no formato (arredonda em `max` casas pelo modo dado). */
-export function formatDecimal(value: Decimal, format: DecimalFormat, mode: RoundingMode = 'HALF_UP'): string {
-  const r = value.round(format.max, mode);
-  let places = Math.max(format.min, Math.min(format.max, r.significantScale()));
-  if (format.minBelowOne !== undefined && !r.isZero() && r.abs().lt(1)) places = Math.max(places, format.minBelowOne);
-  return r.toFixed(places, mode);
+export function formatarDecimal(valor: Decimal, formato: FormatoDecimal, modo: RoundingMode = 'HALF_UP'): string {
+  const r = valor.round(formato.max, modo);
+  let places = Math.max(formato.min, Math.min(formato.max, r.significantScale()));
+  if (formato.minimoAbaixoDeUm !== undefined && !r.isZero() && r.abs().lt(1))
+    places = Math.max(places, formato.minimoAbaixoDeUm);
+  return r.toFixed(places, modo);
 }
 
 /** Por que o valor não cabe no formato, ou `undefined` se cabe sem perder dígitos. */
-export function formatProblem(value: Decimal, format: DecimalFormat): string | undefined {
-  if (value.isNegative()) return 'valor negativo';
-  if (format.nonZero && value.isZero()) return 'valor zero não é aceito neste campo';
-  if (value.significantScale() > format.max) return `mais de ${format.max} casas decimais`;
-  const intDigits = value.round(0, 'DOWN').abs().toString().replace(/^0$/, '').length;
-  if (intDigits > format.intDigits) return `mais de ${format.intDigits} dígitos inteiros`;
+export function problemaDeFormato(valor: Decimal, formato: FormatoDecimal): string | undefined {
+  if (valor.isNegative()) return 'valor negativo';
+  if (formato.naoNulo && valor.isZero()) return 'valor zero não é aceito neste campo';
+  if (valor.significantScale() > formato.max) return `mais de ${formato.max} casas decimais`;
+  const intDigits = valor.round(0, 'DOWN').abs().toString().replace(/^0$/, '').length;
+  if (intDigits > formato.digitosInteiros) return `mais de ${formato.digitosInteiros} dígitos inteiros`;
   return undefined;
 }

package/src/ibs-cbs.ts

@@ -3,87 +3,92 @@
  * `@sinete/ibs-cbs-dados` diretamente.
  *
  * Reexporta o motor inteiro (`@sinete/ibs-cbs`: alíquotas, cálculo, regras da NT 2025.002 e determinação de CST e
- * cClassTrib) e o leitor do dataset (`@sinete/ibs-cbs-dados`: `loadDataset`, `verifyDataset`, diff, tipos). O dataset
+ * cClassTrib) e o leitor do dataset (`@sinete/ibs-cbs-dados`: `carregarDataset`, `conferirDataset`, diff, tipos). O dataset
  * embarcado não entra aqui, para não ir para o bundle de quem não o usa: `carregarDatasetEmbarcado()`, na raiz do
- * `@sinete/nfe`, o importa sob demanda. `Dec`, `IsoDate` e `Validity` vêm do motor (os de `Dec` e `IsoDate` são os
- * mesmos; a `Validity` dos dados, com os campos do dataset, fica acessível pelos tipos que a usam).
+ * `@sinete/nfe`, o importa sob demanda. `Dec`, `DataIso` e `Vigencia` vêm do motor (os de `Dec` e `DataIso` são os
+ * mesmos; a `Vigencia` dos dados, com os campos do dataset, fica acessível pelos tipos que a usam).
+ *
+ * Experimental (ADR 0016, seção 5) até o `@sinete/ibs-cbs` sair 1.0: a calculadora espera a norma da base de cálculo
+ * (NT 2025.002, UB16-10), e este subpath pode mudar em minor, sempre com changeset.
+ *
+ * @experimental
  */
 
 // biome-ignore lint/performance/noReExportAll: o subpath existe para reexportar o motor inteiro, e as duas pontas são do mesmo repo.
 export * from '@sinete/ibs-cbs';
 export type {
-  ActorClassTribRecord,
-  ActorFilter,
-  ActorGroupRecord,
-  ActorRecord,
-  ActorRole,
-  AnnexRecord,
-  Applicability,
-  ApplicabilityRecord,
-  ApplicabilityResult,
-  ByTributo,
-  CbsTransferRecord,
-  ChangeKind,
-  ClassTribCredit,
-  ClassTribFilter,
-  ClassTribGroups,
-  ClassTribLegal,
-  ClassTribRecord,
-  CredPresCalculation,
-  CredPresGroups,
-  CredPresInForce,
-  CredPresRates,
-  CredPresRecord,
-  CstGroups,
-  CstRecord,
-  DataSource,
-  DatasetBundle,
-  DatasetDiff,
-  DatasetManifest,
-  DatasetTables,
-  DfeLink,
-  DfeTypeRecord,
-  Family,
-  FieldChange,
-  FixedRateRecord,
-  GovPurchaseReducerRecord,
-  IbsCbsDataErrorCode,
-  IbsCbsDataset,
-  Indicator,
-  LegalBasis,
-  NfseNbsRecord,
-  Nomenclature,
-  PrefixException,
-  RateKind,
-  RecordChange,
-  ReductionRecord,
-  SourceId,
-  TableDiff,
-  TableManifest,
-  TableName,
-  TaxContent,
-  TreatmentExpressions,
-  TreatmentFlags,
-  TreatmentLink,
-  TreatmentRecord,
+  AliquotasCredPres,
+  Aplicabilidade,
+  BaseLegal,
+  BaseLegalClassTrib,
+  BundleDoDataset,
+  CalculoCredPres,
+  CodigoErroDadosIbsCbs,
+  ConteudoTributario,
+  CreditoClassTrib,
+  CredPresVigente,
+  DatasetIbsCbs,
+  DiferencaDeDatasets,
+  DiferencaDeTabela,
+  ExcecaoDePrefixo,
+  ExpressoesDoTratamento,
+  Familia,
+  FiltroClassTrib,
+  FiltroDeAtores,
+  FonteDoDataset,
+  GruposClassTrib,
+  GruposCredPres,
+  GruposCst,
+  IdDaFonte,
+  Indicador,
+  IndicadoresDoTratamento,
+  ManifestoDaTabela,
+  ManifestoDoDataset,
+  MudancaDeCampo,
+  MudancaDeRegistro,
+  NomeDaTabela,
+  Nomenclatura,
+  PapelDoAtor,
+  PorTributo,
+  RegistroAliquotaFixa,
+  RegistroAnexo,
+  RegistroAplicabilidade,
+  RegistroAtor,
+  RegistroAtorClassTrib,
+  RegistroClassTrib,
+  RegistroCredPres,
+  RegistroCst,
+  RegistroGrupoDeAtores,
+  RegistroNfseNbs,
+  RegistroReducao,
+  RegistroRedutorCompraGov,
+  RegistroTipoDfe,
+  RegistroTransferenciaCbs,
+  RegistroTratamento,
+  ResultadoAplicabilidade,
+  TabelasDoDataset,
+  TipoDeAliquota,
+  TipoDeMudanca,
   Tributo,
+  VinculoDfe,
+  VinculoTratamento,
 } from '@sinete/ibs-cbs-dados';
 export {
-  applicability,
-  BRASILIA_OFFSET_MINUTES,
-  canonicalJson,
-  canonicalTable,
-  changeKind,
-  civilDate,
-  contentVersionOf,
-  DATA_SCHEMA_VERSION,
-  diffDatasets,
-  formatDiff,
-  IbsCbsDataError,
-  inForce,
-  isIsoDate,
-  loadDataset,
-  requireIsoDate,
-  TABLE_NAMES,
-  verifyDataset,
+  aplicabilidade,
+  carregarDataset,
+  compararDatasets,
+  conferirDataset,
+  DESLOCAMENTO_BRASILIA_MIN,
+  dataCivil,
+  ErroDadosIbsCbs,
+  ehDataIso,
+  exigirDataIso,
+  formatarDiferenca,
+  jsonCanonico,
+  NOMES_DAS_TABELAS,
+  tabelaCanonica,
+  tipoDeMudanca,
+  VERSAO_DO_FORMATO_DOS_DADOS,
+  versaoDoConteudo,
+  vigente,
 } from '@sinete/ibs-cbs-dados';

package/src/index.ts

@@ -1,25 +1,25 @@
 /**
- * `@sinete/nfe`: NF-e modelo 55 e NFC-e modelo 65. Entrada do domínio (`NfeInput`), montagem com totais em decimal exato e validação
- * estrita (`buildNfe`), assinatura por splice (`signNfe`) e os serviços da SEFAZ sobre `@sinete/transport`
- * (`createNfeClient`). IBS/CBS pelo motor do sinete por padrão (`ibsCbsCalculator`), com o dataset carregado sob
+ * `@sinete/nfe`: NF-e modelo 55 e NFC-e modelo 65. Entrada do domínio (`DadosNfe`), montagem com totais em decimal exato e validação
+ * estrita (`montarNfe`), assinatura por splice (`assinarNfe`) e os serviços da SEFAZ sobre `@sinete/transport`
+ * (`criarClienteNfe`). IBS/CBS pelo motor do sinete por padrão (`calculadoraIbsCbs`), com o dataset carregado sob
  * demanda. O emissor (bytes gravados antes do envio, trava, retomada, cancelamento com recuperação) está em
  * `@sinete/emissor/nfe` (ADR 0010).
  */
 
 export type {
-  BuildNfeOptions,
-  BuildNfeResult,
-  BuiltNfe,
   ExigenciaRespTec,
+  MontarNfeOpcoes,
+  NfeMontada,
+  ResultadoMontagemNfe,
 } from './build/build.ts';
 export {
+  assinarNfe,
   assinaturaQrCode,
-  buildNfe,
   comQrCode,
   exigenciaRespTec,
   hashCsrt,
+  montarNfe,
   NFE_NS,
-  signNfe,
   XNOME_HOMOLOGACAO,
   XPROD_HOMOLOGACAO_NFCE,
 } from './build/build.ts';
@@ -29,16 +29,17 @@ export { conferirEmitenteDoCertificado } from './build/rejeicoes.ts';
 export type { Familia } from './build/values.ts';
 export type { DecimalInput, RoundingMode } from './decimal.ts';
 export { Decimal, dec, sum } from './decimal.ts';
-export type { DecimalFormat } from './format.ts';
-export { formatDecimal, formatProblem } from './format.ts';
-export type { NfeIssueCode } from './issues.ts';
-export { NFE_ISSUE_CODES } from './issues.ts';
+export type { FormatoDecimal } from './format.ts';
+export { formatarDecimal, problemaDeFormato } from './format.ts';
+export type { CodigoOcorrenciaNfe } from './issues.ts';
+export { CODIGOS_OCORRENCIA_NFE } from './issues.ts';
 export type {
   ClassificacaoIbsCbs,
   Cobranca,
   Contingencia,
   Crt,
   CstPisCofinsOutras,
+  DadosNfe,
   Desoneracao,
   DesoneracaoSt,
   Destinatario,
@@ -89,7 +90,6 @@ export type {
   ModBC,
   ModBCST,
   ModFrete,
-  NfeInput,
   Origem,
   Pagamento,
   PisCofins,
@@ -107,47 +107,49 @@ export type {
   Volume,
 } from './model.ts';
 export { MotivoDesoneracaoIcms, TipoPagamento } from './model.ts';
-export type { IbsCbsCalculator, IbsCbsItemRequest, IbsCbsNotaRequest, IbsCbsResponse } from './ports.ts';
+export type { CalculadoraIbsCbs, PedidoIbsCbsItem, PedidoIbsCbsNota, RespostaIbsCbs } from './ports.ts';
 export { rotuloDoCaminho } from './rotulo.ts';
-export type { GrupoIbsCbs, IbsCbsCalculatorOptions } from './rtc.ts';
-export { carregarDatasetEmbarcado, ibsCbsCalculator, localDaOperacao } from './rtc.ts';
+export type { CalculadoraIbsCbsOpcoes, GrupoIbsCbs } from './rtc.ts';
+export { calculadoraIbsCbs, carregarDatasetEmbarcado, localDaOperacao } from './rtc.ts';
 export type {
   AutorDocumento,
-  AutorizacaoOutcome,
   AutorizarOpcoes,
   Cadastro,
   CadastroPedido,
   CancelamentoPedido,
   CancelamentoSubstituicaoPedido,
   CartaCorrecaoPedido,
+  ClienteNfe,
+  ClienteNfeOpcoes,
   ConsultaNfe,
-  ConsultaOutcome,
   ConsultaReciboOpcoes,
   Distribuicao,
   DistribuicaoConsulta,
   DistribuicaoOpcoes,
   DocumentoDistribuido,
-  EventoOutcome,
+  EnvioOpcoes,
+  Espera,
   EventoRegistrado,
   Inutilizacao,
-  InutilizacaoOutcome,
   InutilizacaoPedido,
   ManifestacaoPedido,
   ManifestacaoTipo,
-  NfeClient,
-  NfeClientOptions,
   PoliticaRecibo,
   ProtocoloNfe,
-  Sleep,
+  ResultadoAutorizacao,
+  ResultadoConsulta,
+  ResultadoEvento,
+  ResultadoInutilizacao,
   StatusServico,
+  StatusServicoOpcoes,
 } from './services/client.ts';
-export { autorizadorContingencia, createNfeClient } from './services/client.ts';
-export { gunzipBase64 } from './services/gzip.ts';
+export { autorizadorContingencia, criarClienteNfe } from './services/client.ts';
+export { descomprimirGzipBase64 } from './services/gzip.ts';
 export type { DocumentoAssinado } from './services/proc.ts';
-export { documentoAssinado, nfeAssinadaDoProc, sliceElement } from './services/proc.ts';
+export { documentoAssinado, nfeAssinadaDoProc, recortarElemento } from './services/proc.ts';
 export type { RecuperacaoEvento } from './services/recuperar.ts';
 export { recuperarEventoRegistrado } from './services/recuperar.ts';
 export type { ConteudoDoProtocolo, ResolucaoEnvio } from './services/resolver.ts';
 export { chaveDaDuplicidade, resolverEnvioSemResposta } from './services/resolver.ts';
 export type { Instante } from './time.ts';
-export { formatDh, offsetDaUf } from './time.ts';
+export { deslocamentoDaUf, formatarDh } from './time.ts';