@infinitetoken/tsconfig 0.1.4 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # @infinitetoken/tsconfig
 
-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.
+Shared base `tsconfig.json` for InfiniteToken TypeScript packages. Holds the compiler flags every repo agrees on (strictness, declaration output, consistent casing). Also ships opt-in `tsup` build config factories for a library, a CLI, or both — see [tsup config](#tsup-config) below.
 
 ## Presets
 
@@ -32,29 +32,48 @@ That's the whole file for a typical Node/kit package — every other compiler op
 
 ## 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.
+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 these are plain factory functions — 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. Pick the export that matches what the package actually ships:
 
-The common case — one library entry, cjs+esm, with declarations, cleaning `dist/` first:
+| Export | Use for |
+| --- | --- |
+| `@infinitetoken/tsconfig/tsup/lib` | A library with no CLI — one entry, cjs+esm, declarations, cleans `dist/` |
+| `@infinitetoken/tsconfig/tsup/cli` | A CLI with no separate library export (`main`/`exports` point straight at the built bin) — one entry, esm-only, Node shebang banner, no declarations |
+| `@infinitetoken/tsconfig/tsup/lib-cli` | A package that ships both — a real, separately-importable library **and** a CLI bin — the library entry (cjs+esm, declarations, cleans `dist/`) plus the CLI entry (esm-only, shebang, no declarations) |
+
+The plain library case — one entry point, nothing else:
+
+```js
+// tsup.config.cjs
+module.exports = require('@infinitetoken/tsconfig/tsup/lib')()
+```
+
+Pass a different entry or override anything tsup accepts: `require('@infinitetoken/tsconfig/tsup/lib')('src/main.ts', { minify: true })`.
+
+A CLI-only package:
+
+```js
+// tsup.config.cjs
+module.exports = require('@infinitetoken/tsconfig/tsup/cli')()
+```
+
+A package with both a library and a CLI:
 
 ```js
 // tsup.config.cjs
-module.exports = require('@infinitetoken/tsconfig/tsup').createTsupConfig()
+module.exports = require('@infinitetoken/tsconfig/tsup/lib-cli')()
 ```
 
-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:
+That returns the full two-entry array (`createTsupLibCliConfig(libEntry?, cliEntry?, { lib?, cli? })` — defaults to `src/index.ts` / `src/cli.ts`). A package with an extra entry beyond those two (e.g. a separate subpath export) can spread it and append its own:
 
 ```js
 // tsup.config.cjs
-const { defineConfig, entryConfig, cliConfig } = require('@infinitetoken/tsconfig/tsup')
+const { defineConfig } = require('tsup')
+const createTsupLibCliConfig = require('@infinitetoken/tsconfig/tsup/lib-cli')
 
-module.exports = defineConfig([
-  entryConfig('src/index.ts', { clean: true }),
-  entryConfig('src/shapes.ts'),
-  cliConfig('src/cli.ts')
-])
+module.exports = defineConfig([...createTsupLibCliConfig(), { entry: ['src/shapes.ts'], format: ['esm', 'cjs'], dts: true }])
 ```
 
-`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.
+All three default `dts: true` on every entry that represents real importable code (never on a CLI entry — nobody imports a bin as a typed library) — 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
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infinitetoken/tsconfig",
-  "version": "0.1.4",
+  "version": "0.3.0",
   "description": "Shared base tsconfig for InfiniteToken TypeScript packages, with an opt-in tsup build config",
   "keywords": [
     "config",
@@ -21,20 +21,18 @@
   "sideEffects": false,
   "type": "commonjs",
   "exports": {
-    ".": "./tsconfig.json",
-    "./node": "./node.json",
+    ".": "./src/tsconfig.json",
+    "./node": "./src/node.json",
     "./package.json": "./package.json",
-    "./react-native": "./react-native.json",
-    "./server": "./server.json",
-    "./tsconfig.json": "./tsconfig.json",
-    "./tsup": "./tsup.cjs"
+    "./react-native": "./src/react-native.json",
+    "./server": "./src/server.json",
+    "./tsconfig.json": "./src/tsconfig.json",
+    "./tsup/cli": "./src/tsup/cli.cjs",
+    "./tsup/lib": "./src/tsup/lib.cjs",
+    "./tsup/lib-cli": "./src/tsup/lib-cli.cjs"
   },
   "files": [
-    "tsconfig.json",
-    "node.json",
-    "react-native.json",
-    "server.json",
-    "tsup.cjs"
+    "src"
   ],
   "scripts": {
     "fix": "eslint . --fix",

package/src/tsup/cli.cjs

@@ -0,0 +1,24 @@
+const { defineConfig } = require('tsup')
+
+/**
+ * A CLI-only package with no separate library export — the bin IS the package
+ * (no `dts`: there's no typed API for anyone to import). ESM-only with a Node
+ * shebang banner. Modeled on the CLI half of the fleet's package+CLI packages,
+ * not on any existing CLI-only package — those still need aligning onto this
+ * shape, not the other way around.
+ *
+ * @param {string|string[]} [entry]
+ * @param {import('tsup').Options} [overrides]
+ * @returns {import('tsup').Options}
+ */
+function createTsupCliConfig(entry = 'src/cli.ts', overrides = {}) {
+  return defineConfig({
+    entry: Array.isArray(entry) ? entry : [entry],
+    format: ['esm'],
+    banner: { js: '#!/usr/bin/env node' },
+    clean: true,
+    ...overrides
+  })
+}
+
+module.exports = createTsupCliConfig

package/src/tsup/lib-cli.cjs

@@ -0,0 +1,33 @@
+const { defineConfig } = require('tsup')
+
+/**
+ * A package that also ships a CLI bin: one library entry (cjs+esm, declarations,
+ * cleans dist/ first) plus one CLI entry (esm-only, Node shebang banner, no
+ * declarations — nobody imports a bin as a typed library). Returns the full
+ * two-entry array; a package with more entries than this (e.g. an extra
+ * subpath) can spread it and append its own: `[...createTsupLibCliConfig(), extraEntry]`.
+ *
+ * @param {string|string[]} [libEntry]
+ * @param {string|string[]} [cliEntry]
+ * @param {{ lib?: import('tsup').Options, cli?: import('tsup').Options }} [overrides]
+ * @returns {import('tsup').Options[]}
+ */
+function createTsupLibCliConfig(libEntry = 'src/index.ts', cliEntry = 'src/cli.ts', overrides = {}) {
+  return defineConfig([
+    {
+      entry: Array.isArray(libEntry) ? libEntry : [libEntry],
+      format: ['cjs', 'esm'],
+      dts: true,
+      clean: true,
+      ...overrides.lib
+    },
+    {
+      entry: Array.isArray(cliEntry) ? cliEntry : [cliEntry],
+      format: ['esm'],
+      banner: { js: '#!/usr/bin/env node' },
+      ...overrides.cli
+    }
+  ])
+}
+
+module.exports = createTsupLibCliConfig

package/src/tsup/lib.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

package/tsup.cjs

@@ -1,61 +0,0 @@
-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 }