Para instalar las definiciones de tipo para las APIs integradas de Bun, instala @types/bun.

bun add -d @types/bun # dependencia de desarrollo

En este punto, deberías poder referenciar el global Bun en tus archivos TypeScript sin ver errores en tu editor.

console.log(Bun.version);

compilerOptions Sugeridos

Bun soporta cosas como await de nivel superior, JSX, e importaciones con extensión .ts, que TypeScript no permite por defecto. A continuación hay un conjunto de compilerOptions recomendados para un proyecto Bun, para que puedas usar estas características sin ver advertencias del compilador de TypeScript.

{
  "compilerOptions": {
    // Configuración del entorno y últimas características
    "lib": ["ESNext"],
    "target": "ESNext",
    "module": "Preserve",
    "moduleDetection": "force",
    "jsx": "react-jsx",
    "allowJs": true,

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

    // Mejores prácticas
    "strict": true,
    "skipLibCheck": true,
    "noFallthroughCasesInSwitch": true,
    "noUncheckedIndexedAccess": true,
    "noImplicitOverride": true,

    // Algunas banderas más estrictas (deshabilitadas por defecto)
    "noUnusedLocals": false,
    "noUnusedParameters": false,
    "noPropertyAccessFromIndexSignature": false,
  },
}

Si ejecutas bun init en un directorio nuevo, este tsconfig.json se generará para ti. (Las banderas más estrictas están deshabilitadas por defecto).

bun init