tsconfig.json

// Solution-style tsconfig: lists referenced projects so the TypeScript
// language server[1] can map any file to the right project. See:
// https://www.typescriptlang.org/docs/handbook/project-references.html
//
// `compilerOptions` here are inherited by the referenced projects via
// `extends`. `files: []` means this config itself compiles nothing.
//
// [1] Not committed in this repository, but used by some developers in their
// local development environments.
{
  "files": [],
  "references": [
    {
      "path": "./tsconfig_docs.json"
    },
    {
      "path": "./tsconfig_node.json"
    }
  ],
  "compilerOptions": {
    // NOTE: This version should stay in sync with the version used by
    // `esbuild`. See `Makefile`.
    // TODO: (#0) Upgrade the target when it has aged enough.
    "target": "ES2025",
    "module": "ESNext",
    // TODO: (#0) Supplying `node` and `jest` types globally is not ideal.
    "types": [
      "node",
      "jest"
    ],
    "noEmit": true,
    "noEmitOnError": true,
    "preserveConstEnums": true,
    "esModuleInterop": true,
    "forceConsistentCasingInFileNames": true,
    "strict": true,
    "noImplicitAny": true,
    "strictNullChecks": true,
    "strictFunctionTypes": true,
    "strictBindCallApply": true,
    "strictPropertyInitialization": true,
    "noImplicitThis": true,
    "useUnknownInCatchVariables": true,
    "alwaysStrict": true,
    "noUnusedLocals": true,
    "noUnusedParameters": true,
    "exactOptionalPropertyTypes": true,
    "noImplicitReturns": true,
    "noFallthroughCasesInSwitch": true,
    "noUncheckedIndexedAccess": true,
    "noImplicitOverride": true,
    "noPropertyAccessFromIndexSignature": true,
    "skipLibCheck": true,
    "verbatimModuleSyntax": true
  }
}