mirror of
https://github.com/acamarata/tsconfig.git
synced 2026-07-01 11:24:29 +00:00
47b729f6c7
Four JSON tsconfig presets for acamarata packages: base (strict/ES2022/bundler), library (declaration output), node (CommonJS), react (jsx:react-jsx/DOM). JSON-only package — no build step. Includes validation script and CI workflow.
66 lines
1.8 KiB
Markdown
66 lines
1.8 KiB
Markdown
# @acamarata/tsconfig
|
|
|
|
Shared TypeScript configs for acamarata packages. Four variants covering the common cases: a strict base, a publishable library, a Node.js tool, and a React app.
|
|
|
|
## Install
|
|
|
|
```sh
|
|
pnpm add -D @acamarata/tsconfig
|
|
```
|
|
|
|
## Variants
|
|
|
|
| Config | Extends | Use case |
|
|
|--------|---------|----------|
|
|
| `tsconfig.base.json` | — | Strict base. All other variants extend this. Use it directly only if none of the others fit. |
|
|
| `tsconfig.library.json` | base | Publishable npm libraries. ESNext modules, `declaration: true`, `declarationMap: true`, `sourceMap: true`. |
|
|
| `tsconfig.node.json` | base | Node.js tools and scripts. CommonJS output, `@types/node` included. |
|
|
| `tsconfig.react.json` | base | React apps. Adds `jsx: react-jsx` and the DOM lib. |
|
|
|
|
## Usage
|
|
|
|
In your `tsconfig.json`, set `extends` to the variant that matches your project:
|
|
|
|
```json
|
|
{
|
|
"extends": "@acamarata/tsconfig/tsconfig.library.json",
|
|
"compilerOptions": {
|
|
"rootDir": "src"
|
|
},
|
|
"include": ["src"]
|
|
}
|
|
```
|
|
|
|
For a Node.js CLI tool:
|
|
|
|
```json
|
|
{
|
|
"extends": "@acamarata/tsconfig/tsconfig.node.json",
|
|
"compilerOptions": {
|
|
"rootDir": "src"
|
|
},
|
|
"include": ["src"]
|
|
}
|
|
```
|
|
|
|
For a React app:
|
|
|
|
```json
|
|
{
|
|
"extends": "@acamarata/tsconfig/tsconfig.react.json",
|
|
"include": ["src"]
|
|
}
|
|
```
|
|
|
|
## What the base config enables
|
|
|
|
- `strict: true` — the full strict family of checks
|
|
- `skipLibCheck: true` — skips checking declaration files in `node_modules`
|
|
- `noUncheckedIndexedAccess: true` — array index access includes `undefined` in the type
|
|
- `exactOptionalPropertyTypes: true` — distinguishes `{ x?: string }` from `{ x: string | undefined }`
|
|
- `target: ES2022` — modern output; no polyfill overhead for `async/await`, `class fields`, `at()`
|
|
- `moduleResolution: bundler` — resolves `.ts` extensions naturally in bundler pipelines (tsup, Vite, esbuild)
|
|
|
|
## License
|
|
|
|
MIT
|