tsconfig.json

{
  "compilerOptions": {
    // --- Project Settings ---
    "target": "ESNext", // Compile to a modern ECMAScript version
    "module": "ESNext", // Emit native ESM for packaged runtime
    "moduleResolution": "Bundler", // Keep source imports extensionless; post-build rewrites dist for Node
    "outDir": "./dist", // Where to output compiled JavaScript
    "rootDir": ".", // The root directory of your source files
    "paths": {
      "@/*": ["./src/*"],
      "#/*": ["./tests/*"]
    },

    // --- Type Checking ---
    "strict": true, // Enable all strict type-checking options
    "noUncheckedIndexedAccess": true, // Adds 'undefined' to any un-checked index access

    // --- Interoperability ---
    "esModuleInterop": true, // Allows default imports from CommonJS modules
    "resolveJsonModule": true,
    "forceConsistentCasingInFileNames": true, // Disallow inconsistently-cased references to the same file.

    // --- Completeness ---
    "skipLibCheck": true // Skip type checking of all declaration files (*.d.ts).
  },
  "exclude": ["node_modules", "dist"] // Which files to exclude
}