tsconfig.base.json

{
  "compilerOptions": {
    /* uncontroversial defaults */
    "esModuleInterop": true,
    "skipDefaultLibCheck": true,
    "skipLibCheck": true,
    "allowSyntheticDefaultImports": true,
    "resolveJsonModule": true,
    "jsx": "react-jsxdev",
    "forceConsistentCasingInFileNames": true,

    /* modern defaults */
    "isolatedModules": true,
    // "verbatimModuleSyntax": true, // TODO: enable. for some reason it fails for this repo
    "types": [], // no automatic type elision
    "composite": true,
    "exactOptionalPropertyTypes": false, // too disruptive, and usually unhelpful
    "erasableSyntaxOnly": false, // one day when enums are part of native JS, this could be enabled
    "noUncheckedSideEffectImports": true,
    "moduleDetection": "force", // no need for dud `export {}` anymore

    /* strictness */
    "strict": true,
    "checkJs": true,
    "noUncheckedIndexedAccess": true,
    "noPropertyAccessFromIndexSignature": true,
    "noFallthroughCasesInSwitch": true,
    "noImplicitOverride": true,

    /* ESM */
    "lib": ["esnext"], // explicitly add DOM if you need it
    "target": "esnext",
    "module": "nodenext",
    "moduleResolution": "nodenext",

    /* emit */
    "noEmit": true, // off by default; these settings apply if emit is enabled
    "rootDir": "${configDir}/src",
    "outDir": "${configDir}/dist",
    "sourceMap": true,
    "declaration": true,
    "declarationMap": true,
    "stripInternal": true
  },
  "exclude": ["**/node_modules", "**/coverage"]
}