Erros de verbatimModuleSyntax no IronPDF for Node.js

Como a opção se comporta

Defina para false (a escolha comum): O TypeScript reescreve as instruções de import e export para corresponder ao sistema de módulo de destino. Com um objetivo CommonJS, ele converte importações no estilo ESM (import ... de '...') into `chamadas require(); com um objetivo ESNext, ele mantém a sintaxe ESM.

Defina para true: O TypeScript preserva a sintaxe de import e export exatamente como escrita. A sintaxe ESM permanece ESM, independentemente do destino, o que falha quando o sistema de módulos não a suporta.

Erros quando habilitado

Com "verbatimModuleSyntax": true, uma construção CommonJS pode falhar com:

A top-level 'export' modifier cannot be used on value declarations in a CommonJS module when 'verbatimModuleSyntax' is enabled.

ESM syntax is not allowed in a CommonJS module when 'verbatimModuleSyntax' is enabled.

O primeiro acontece porque o CommonJS não suporta um export de nível superior; o segundo ocorre quando a sintaxe ESM é deixada não transformada para um módulo CommonJS.

Recomendação

Para a maioria dos projetos, mantenha a opção desativada para que o TypeScript ajuste a sintaxe do módulo para você:

{
  "compilerOptions": {
    "verbatimModuleSyntax": false
  }
}

Se você precisar de uma preservação estrita da sintaxe para um empacotador específico ou ambiente, defina-o para true apenas quando seu sistema de módulo suportar totalmente a sintaxe que sua fonte usa.