@infinitetoken/tsconfig 0.1.3 → 0.2.0

package/README.md

@@ -1,24 +1,50 @@
 # @infinitetoken/tsconfig
 
-Shared base `tsconfig.json` for InfiniteToken TypeScript packages. Holds the compiler flags every repo agrees on (strictness, declaration output, consistent casing). Build-mechanics options that vary per repo (`target`, `module`, `moduleResolution`, `rootDir`, `types`, `include`/`exclude`) stay local to each consumer.
+Shared base `tsconfig.json` for InfiniteToken TypeScript packages. Holds the compiler flags every repo agrees on (strictness, declaration output, consistent casing). Also ships an opt-in `tsup` build config factory (`@infinitetoken/tsconfig/tsup`) — see [tsup config](#tsup-config) below.
+
+## Presets
+
+| Export | Use for |
+| --- | --- |
+| `@infinitetoken/tsconfig` / `@infinitetoken/tsconfig/tsconfig.json` | Universal core — strictness-only flags (`strict`, `declaration`, `noUnusedLocals`, etc). Rarely used directly; every variant below extends it. |
+| `@infinitetoken/tsconfig/node` | Node/kit packages, RN library packages (via `/react-native`, below) — `target: esnext`, `module: preserve`, `moduleResolution: bundler`, `types: [jest, node]` |
+| `@infinitetoken/tsconfig/server` | Express/server apps (unpublished) — `module: commonjs`, `resolveJsonModule: true`, `types: [jest, node]`, and relaxes six strictness flags (`declaration`, `declarationMap`, `noUnusedLocals`, `noUnusedParameters`, `noImplicitReturns`, `noFallthroughCasesInSwitch`) back to `false` |
+| `@infinitetoken/tsconfig/react-native` | React Native packages — extends `/node`, adds `target: ES2020`, `lib: [ES2020, DOM]`, `jsx: react-jsx`, `module: ESNext`, `sourceMap: true`, `allowSyntheticDefaultImports: true`, `resolveJsonModule: true` |
 
 ## Usage
 
 ```json
 {
-  "extends": "@infinitetoken/tsconfig/tsconfig.json",
+  "extends": "@infinitetoken/tsconfig/node",
   "compilerOptions": {
-    "target": "esnext",
-    "module": "preserve",
-    "moduleResolution": "bundler",
     "rootDir": "./src",
-    "types": ["jest", "node"]
+    "outDir": "./dist"
   },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
+  "include": ["src/**/*"]
 }
 ```
 
+That's the whole file for a typical Node/kit package — every other compiler option now comes from the preset. `rootDir`, `outDir`, `include` (and `exclude`, if you actually need one — see below) are the only things that ever need to be local, because of a real TypeScript limitation: an inherited path-valued `compilerOptions` entry, or an inherited `include`/`exclude`, resolves relative to the file that *declared* it, not the file that extends it. If this package tried to ship `rootDir`/`include`/`exclude` itself, an unoverridden consumer would have TypeScript looking for source files inside `node_modules/@infinitetoken/tsconfig/`. `target`/`module`/`moduleResolution`/`types`/`lib`/etc. don't have this problem — plain `compilerOptions` values merge normally through `extends`, which is exactly why the presets above can carry them for you.
+
+**You very likely don't need an `exclude` array at all.** `include: ["src/**/*"]` already scopes the whole program to `src/` — anything living outside it (`node_modules`, `dist`, `.claude/worktrees`, `examples`, etc.) was never going to be included in the first place, so excluding it again is redundant. Only add `exclude` if you have something that genuinely lives *inside* `src/` that you need to keep out of the program.
+
+`rootDir` specifically can't be dropped even though `include` looks like it should imply it: without it, `tsc`'s declaration-emit output layout breaks (`TS5011`), so it has to stay explicit whenever you're emitting declarations.
+
+## tsup config
+
+Opt-in — only relevant if the package builds with `tsup`. Unlike `tsconfig.json`, a `tsup.config` file is executable code with no path-resolution sharing limitation, so this is a plain factory function — same shape as `@infinitetoken/jest-config`'s presets, a bare function you call, nothing invoked by name off an object. Use a `tsup.config.cjs` (not `.ts`) so it loads directly with `require()` instead of going through tsup's ESM-bundling loader.
+
+```js
+// tsup.config.cjs
+module.exports = require('@infinitetoken/tsconfig/tsup')()
+```
+
+That's the whole file for one library entry point — cjs+esm, with declarations, cleaning `dist/` first. Pass a different entry or override anything tsup accepts: `require('@infinitetoken/tsconfig/tsup')('src/main.ts', { minify: true })`.
+
+A package with more than one entry point (a library plus a CLI bin, say) isn't covered by this factory yet — write `tsup.config.cjs` by hand with `tsup`'s own `defineConfig([...])` for that case, same as before this package existed.
+
+`createTsupConfig` defaults `dts: true` — a package doing `tsup && tsc --emitDeclarationOnly` as two separate steps (rather than letting tsup's own entry-scoped `dts` option handle it) will end up shipping declarations for every file `tsconfig.json`'s `include` matches, `__tests__` included, not just the real entry point.
+
 ## Release
 
 Tag-based, using npm trusted publishing (OIDC, no token required):

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@infinitetoken/tsconfig",
-  "version": "0.1.3",
-  "description": "Shared base tsconfig for InfiniteToken TypeScript packages",
+  "version": "0.2.0",
+  "description": "Shared base tsconfig for InfiniteToken TypeScript packages, with an opt-in tsup build config",
   "keywords": [
     "config",
     "tsconfig",
-    "typescript"
+    "typescript",
+    "tsup"
   ],
   "homepage": "https://github.com/infinitetoken/tsconfig#readme",
   "bugs": {
@@ -25,13 +26,15 @@
     "./package.json": "./package.json",
     "./react-native": "./react-native.json",
     "./server": "./server.json",
-    "./tsconfig.json": "./tsconfig.json"
+    "./tsconfig.json": "./tsconfig.json",
+    "./tsup": "./tsup.cjs"
   },
   "files": [
     "tsconfig.json",
     "node.json",
     "react-native.json",
-    "server.json"
+    "server.json",
+    "tsup.cjs"
   ],
   "scripts": {
     "fix": "eslint . --fix",
@@ -40,16 +43,29 @@
     "release:major": "npm version major && npm run release",
     "release:minor": "npm version minor && npm run release",
     "release:patch": "npm version patch && npm run release",
-    "test": "tsc --noEmit -p test/tsconfig.json",
+    "test": "node scripts/verify-presets.cjs && node scripts/verify-tsup.cjs",
     "verify": "npm run lint && npm test",
     "preversion": "npm run verify"
   },
   "prettier": "@infinitetoken/eslint-config/prettier",
   "devDependencies": {
     "@infinitetoken/eslint-config": "^0.1.4",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^26.4.0",
+    "@types/react": "^19.2.18",
     "eslint": "^9.39.4",
+    "react": "^19.2.8",
+    "tsup": "^8.5.1",
     "typescript": "^6.0.3"
   },
+  "peerDependencies": {
+    "tsup": "^8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "tsup": {
+      "optional": true
+    }
+  },
   "publishConfig": {
     "access": "public"
   }

package/tsup.cjs

@@ -0,0 +1,21 @@
+const { defineConfig } = require('tsup')
+
+/**
+ * One library entry point, cjs+esm, with declarations and a clean build.
+ * Covers the common case fleet-wide.
+ *
+ * @param {string|string[]} [entry]
+ * @param {import('tsup').Options} [overrides]
+ * @returns {import('tsup').Options}
+ */
+function createTsupConfig(entry = 'src/index.ts', overrides = {}) {
+  return defineConfig({
+    entry: Array.isArray(entry) ? entry : [entry],
+    format: ['cjs', 'esm'],
+    dts: true,
+    clean: true,
+    ...overrides
+  })
+}
+
+module.exports = createTsupConfig