@infinitetoken/tsconfig 0.1.2 → 0.1.4

package/README.md

@@ -1,24 +1,61 @@
 # @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, not a JSON preset. Use a `tsup.config.cjs` (not `.ts`) so it loads directly with `require()` instead of going through tsup's ESM-bundling loader.
+
+The common case — one library entry, cjs+esm, with declarations, cleaning `dist/` first:
+
+```js
+// tsup.config.cjs
+module.exports = require('@infinitetoken/tsconfig/tsup').createTsupConfig()
+```
+
+For a package with more than one entry point (e.g. a library plus a CLI bin), compose `entryConfig`/`cliConfig` yourself. Only the first entry should set `clean: true` — later entries with `clean: true` would wipe out what the earlier ones just wrote:
+
+```js
+// tsup.config.cjs
+const { defineConfig, entryConfig, cliConfig } = require('@infinitetoken/tsconfig/tsup')
+
+module.exports = defineConfig([
+  entryConfig('src/index.ts', { clean: true }),
+  entryConfig('src/shapes.ts'),
+  cliConfig('src/cli.ts')
+])
+```
+
+`createTsupConfig(entry?, overrides?)` and `entryConfig` both default `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/node.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "target": "esnext",
+    "module": "preserve",
+    "moduleResolution": "bundler",
+    "types": ["jest", "node"]
+  }
+}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@infinitetoken/tsconfig",
-  "version": "0.1.2",
-  "description": "Shared base tsconfig for InfiniteToken TypeScript packages",
+  "version": "0.1.4",
+  "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": {
@@ -21,24 +22,50 @@
   "type": "commonjs",
   "exports": {
     ".": "./tsconfig.json",
+    "./node": "./node.json",
     "./package.json": "./package.json",
-    "./tsconfig.json": "./tsconfig.json"
+    "./react-native": "./react-native.json",
+    "./server": "./server.json",
+    "./tsconfig.json": "./tsconfig.json",
+    "./tsup": "./tsup.cjs"
   },
   "files": [
-    "tsconfig.json"
+    "tsconfig.json",
+    "node.json",
+    "react-native.json",
+    "server.json",
+    "tsup.cjs"
   ],
   "scripts": {
-    "ci": "npm test",
+    "fix": "eslint . --fix",
+    "lint": "eslint .",
     "release": "git push --follow-tags",
     "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",
-    "preversion": "npm run ci"
+    "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/react-native.json

@@ -0,0 +1,12 @@
+{
+  "extends": "./node.json",
+  "compilerOptions": {
+    "target": "ES2020",
+    "lib": ["ES2020", "DOM"],
+    "jsx": "react-jsx",
+    "module": "ESNext",
+    "sourceMap": true,
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true
+  }
+}

package/server.json

@@ -0,0 +1,15 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "resolveJsonModule": true,
+    "types": ["jest", "node"],
+    "declaration": false,
+    "declarationMap": false,
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noImplicitReturns": false,
+    "noFallthroughCasesInSwitch": false,
+    "preserveConstEnums": false
+  }
+}

package/tsup.cjs

@@ -0,0 +1,61 @@
+const { defineConfig } = require('tsup')
+
+const BASE_DEFAULTS = {
+  format: ['cjs', 'esm'],
+  dts: true
+}
+
+const CLI_DEFAULTS = {
+  format: ['esm'],
+  banner: { js: '#!/usr/bin/env node' }
+}
+
+/**
+ * A single tsup build-entry object, for composing a multi-entry array yourself
+ * (e.g. a library entry plus a separate subpath entry). `clean` is deliberately
+ * NOT defaulted here — with multiple entries in one array, only the first should
+ * clean `dist/`, or later entries wipe out earlier ones' output.
+ *
+ * @param {string|string[]} entry
+ * @param {import('tsup').Options} [overrides]
+ * @returns {import('tsup').Options}
+ */
+function entryConfig(entry, overrides = {}) {
+  return {
+    entry: Array.isArray(entry) ? entry : [entry],
+    ...BASE_DEFAULTS,
+    ...overrides
+  }
+}
+
+/**
+ * A CLI bin entry: ESM-only with a Node shebang banner, no declarations.
+ *
+ * @param {string|string[]} entry
+ * @param {import('tsup').Options} [overrides]
+ * @returns {import('tsup').Options}
+ */
+function cliConfig(entry, overrides = {}) {
+  return {
+    entry: Array.isArray(entry) ? entry : [entry],
+    ...CLI_DEFAULTS,
+    ...overrides
+  }
+}
+
+/**
+ * The common case: one library entry point, cjs+esm, with declarations and a
+ * clean build. Covers most packages in the fleet outright.
+ *
+ * For a package with multiple entries (e.g. a CLI bin alongside the library),
+ * skip this and compose `entryConfig`/`cliConfig` yourself under `defineConfig([...])`.
+ *
+ * @param {string|string[]} [entry]
+ * @param {import('tsup').Options} [overrides]
+ * @returns {import('tsup').Options}
+ */
+function createTsupConfig(entry = 'src/index.ts', overrides = {}) {
+  return defineConfig(entryConfig(entry, { clean: true, ...overrides }))
+}
+
+module.exports = { createTsupConfig, entryConfig, cliConfig, defineConfig }