.agent/rules/tsconfig-ignore-deprecations.md

type	name	description	scope	trigger	globs	updatedAt
rule	tsconfig-ignore-deprecations	Workaround obrigatório para tsup v8.5.0 que injeta baseUrl depreciado no TS 6.0	global	glob	**/tsconfig*.json	2026-09-28

Regra: ignoreDeprecations no tsconfig.json

Contexto

O tsup v8.5.0 injeta internamente baseUrl: "." no rollup-dts-plugin durante a geração de arquivos .d.ts (DTS Build). O TypeScript 6.0 trata baseUrl como depreciado (erro TS5101), causando falha fatal no build DTS.

Regra

Todo tsconfig.json de pacotes que usam tsup DEVE incluir:

{
  "compilerOptions": {
    "ignoreDeprecations": "6.0"
  }
}

Isso silencia todas as deprecações da era 5.x/6.0 sem efeito colateral.

Quando remover

Esta regra é um workaround temporário. Deve ser removida quando o tsup lançar uma versão que não injete baseUrl automaticamente. Monitorar releases do tsup para deprecar esta rule.

Exemplos

// ✅ Correto — com workaround
{
  "compilerOptions": {
    "moduleResolution": "bundler",
    "module": "ESNext",
    "ignoreDeprecations": "6.0"
  }
}

// ❌ Incorreto — build DTS falhará
{
  "compilerOptions": {
    "moduleResolution": "bundler",
    "module": "ESNext"
  }
}

Impacto

Sem ignoreDeprecations, o comando pnpm run build falhará com erro TS5101 em qualquer pacote que gere arquivos .d.ts via tsup.

Referências

• Memória Azteca: código 53
• Rule: global/rules/typescript-module-resolution
• Código responsável: node_modules/tsup/dist/rollup.js