@robonen/tsconfig

Shared TypeScript configurations.

Install

pnpm install -D @robonen/tsconfig

Presets

| Preset | Extends | Use for | | --- | --- | --- | | tsconfig.base.json | — | Node / isomorphic libraries (lib: ESNext, no DOM) | | tsconfig.dom.json | base | Browser libraries (adds DOM, DOM.Iterable) | | tsconfig.vue.json | dom | Vue SFC libraries / apps (adds jsx, vueCompilerOptions) | | tsconfig.node.json | base | Build/test tooling files (*.config.ts) — adds types: ["node"], no DOM | | tsconfig.json | base | Default alias for base (bare @robonen/tsconfig import) |

Usage

Pick the preset that matches the package and extend it:

// Node / isomorphic library
{ "extends": "@robonen/tsconfig/tsconfig.base.json" }

// Browser library
{ "extends": "@robonen/tsconfig/tsconfig.dom.json" }

// Vue package, with path aliases
{
  "extends": "@robonen/tsconfig/tsconfig.vue.json",
  "compilerOptions": {
    "paths": { "@/*": ["./src/*"] }
  }
}

Path aliases resolve relative to the tsconfig.json location — baseUrl is intentionally omitted (deprecated, removed in TypeScript 7.0).

Project references (DOM + Node split)

Most packages contain two environments: browser/library src (DOM) and Node tooling files (vite.config.ts, vitest.config.ts, tsdown.config.ts). They are split into separate projects wired with references, so src never sees Node globals and config files never see DOM:

// tsconfig.json — solution root, tools (tsdown/vitest/editor) target src below
{
  "files": [],
  "references": [
    { "path": "./tsconfig.src.json" },
    { "path": "./tsconfig.node.json" }
  ]
}

// tsconfig.src.json — the library code
{
  "extends": "@robonen/tsconfig/tsconfig.dom.json",
  "compilerOptions": {
    "composite": true,
    "types": [],
    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.src.tsbuildinfo"
  },
  "include": ["src/**/*.ts"]
}

// tsconfig.node.json — build/test tooling files
{
  "extends": "@robonen/tsconfig/tsconfig.node.json",
  "compilerOptions": {
    "composite": true,
    "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo"
  },
  "include": ["*.config.ts"]
}

Type-check the whole package (both projects) with tsc -b / vue-tsc -b. Point tsdown at the src project (tsconfig: './tsconfig.src.json') since the root has no compilerOptions.

What's included (base)

• Target / Module: ESNext with module: Preserve + Bundler resolution
• Strict mode: strict, noUncheckedIndexedAccess, noImplicitOverride, noImplicitReturns, noFallthroughCasesInSwitch, noUncheckedSideEffectImports
• Module safety: verbatimModuleSyntax, isolatedModules, moduleDetection: force
• Type-check only: noEmit (declarations/output are produced by tsdown)
• Interop: esModuleInterop, resolveJsonModule