tsconfig.json

{
  "$schema": "https://json.schemastore.org/tsconfig",
  "compilerOptions": {
    // no emit by default, build config enables it
    "noEmit": true,

    // remove comments from output
    "removeComments": true,

    // the stricter, the better
    // https://whatislove.dev/articles/the-strictest-typescript-config/
    "allowJs": false,
    "exactOptionalPropertyTypes": true,
    "noPropertyAccessFromIndexSignature": true,
    "noUncheckedIndexedAccess": true,
    "strict": true,
    "strictNullChecks": true,

    // esm
    "esModuleInterop": true,
    "isolatedModules": true,
    "lib": ["ESNext"],
    "module": "ESNext",
    "target": "esnext",

    // follow esm conventions
    // tsc-alias needs outDir to be set
    "moduleDetection": "force",
    "moduleResolution": "bundler",
    "outDir": "./build",

    // paths for imports
    // 🧪 is neat, don't be a hater
    "baseUrl": ".",
    "paths": { "~/*": ["./src/*"], "🧪/*": ["./test/*"] },
    "rootDir": ".",

    // pnpm compatibility
    "preserveSymlinks": true,

    // importing json happens more often than you think
    "resolveJsonModule": true,

    // don't try to check for errors on imported libs
    "skipLibCheck": true
  },

  "exclude": ["node_modules", "build", "coverage", "dist"]
}