Para instalar as definições de tipo para as APIs built-in do Bun, instale @types/bun.

bun add -d @types/bun # dependência de desenvolvimento

Neste ponto, você deve ser capaz de referenciar o global Bun nos seus arquivos TypeScript sem ver erros no seu editor.

console.log(Bun.version);

compilerOptions Sugeridos

O Bun suporta coisas como top-level await, JSX, e imports com extensão .ts, que o TypeScript não permite por padrão. Abaixo está um conjunto de compilerOptions recomendados para um projeto Bun, para que você possa usar estes recursos sem ver avisos do compilador do TypeScript.

{
  "compilerOptions": {
    // Configuração do ambiente & últimas features
    "lib": ["ESNext"],
    "target": "ESNext",
    "module": "Preserve",
    "moduleDetection": "force",
    "jsx": "react-jsx",
    "allowJs": true,

    // Modo bundler
    "moduleResolution": "bundler",
    "allowImportingTsExtensions": true,
    "verbatimModuleSyntax": true,
    "noEmit": true,

    // Melhores práticas
    "strict": true,
    "skipLibCheck": true,
    "noFallthroughCasesInSwitch": true,
    "noUncheckedIndexedAccess": true,
    "noImplicitOverride": true,

    // Algumas flags mais estritas (desabilitadas por padrão)
    "noUnusedLocals": false,
    "noUnusedParameters": false,
    "noPropertyAccessFromIndexSignature": false,
  },
}

Se você executar bun init em um novo diretório, este tsconfig.json será gerado para você. (As flags mais estritas são desabilitadas por padrão.)

bun init