tsconfig

name	tsconfig
description	TypeScript config conventions for this monorepo: the two-base layering, the eight leaf tiers, and the never-redeclare list. Use when adding a package, editing any tsconfig.json, picking a tier for a new app, or debugging module resolution.
metadata	{"author":"epicenter","version":"1.0"}

tsconfig conventions

Every package here is source-only .ts: exports point at ./src/*.ts, there is no build step, and consumers (Bun, Vite, WXT, Tauri, the Cloudflare Worker) operate on raw .ts. That single fact decides the whole config.

One exception, and it is the audience, not the package. packages/app (@epicenter/app) is published for toolchains we do not control, so shipping source would subject it to a stranger's compiler settings. It emits .js and .d.ts (ADR-0186). Its leaf tsconfig.json is an ordinary tier from the table below; the emit lives in a sibling tsconfig.build.json that extends the leaf and turns on exactly what emitting needs. Do not add outDir, declaration, or noEmit: false to any leaf. If a second package ever earns a build, copy that split.

The one rule

A leaf tsconfig.json may set only: types, library-only strictness (noUnusedLocals/noUnusedParameters), checkJs (SvelteKit), and genuinely package-specific options (, , , ).