@theholocron/tsdown-config 7.14.4 → 7.15.0

package/README.md

@@ -8,9 +8,11 @@ Shared [tsdown](https://tsdown.dev) configurations for `@theholocron` packages.
 pnpm add -D @theholocron/tsdown-config tsdown
 ```
 
-## Usage
+## Presets
 
-For a standard published ESM library (single entry, generates types, doesn't bundle `@theholocron/*` peers):
+### `library` — published ESM library
+
+Single entry point (`src/index.ts`), generates `.d.ts` type declarations, does not bundle `@theholocron/*` peers.
 
 ```ts
 // tsdown.config.ts
@@ -27,3 +29,23 @@ export default library({
 	entry: ["src/index.ts", "src/capabilities/index.ts"],
 });
 ```
+
+### `cli` — CLI binary
+
+Single entry point (`src/cli.ts`), no type declarations (binaries don't need them), sourcemap enabled, injects `#!/usr/bin/env node` shebang so the output is directly executable.
+
+```ts
+// tsdown.config.ts
+export { default } from "@theholocron/tsdown-config/presets/cli";
+```
+
+To customise the entry point or other options, use the `cli()` factory:
+
+```ts
+// tsdown.config.ts
+import { cli } from "@theholocron/tsdown-config/presets/cli";
+
+export default cli({
+	entry: ["src/my-cli.ts"],
+});
+```

package/dist/index.d.ts

@@ -1,2 +1,3 @@
+import { cli } from "./presets/cli.js";
 import { library } from "./presets/library.js";
-export { library };
+export { cli, library };

package/dist/index.js

@@ -1,2 +1,3 @@
+import { cli } from "./presets/cli.js";
 import { library } from "./presets/library.js";
-export { library };
+export { cli, library };

package/dist/presets/cli.d.ts

@@ -0,0 +1,11 @@
+import { UserConfig } from "tsdown";
+//#region presets/cli.d.ts
+/**
+ * tsdown preset for a CLI binary.
+ * Builds src/cli.ts → dist/cli.mjs with a Node.js shebang banner.
+ * No type declarations — binaries don't need them.
+ */
+declare function cli(options?: UserConfig): UserConfig;
+declare const _default: UserConfig;
+//#endregion
+export { cli, _default as default };

package/dist/presets/cli.js

@@ -0,0 +1,21 @@
+import { defineConfig } from "tsdown";
+//#region presets/cli.ts
+/**
+* tsdown preset for a CLI binary.
+* Builds src/cli.ts → dist/cli.mjs with a Node.js shebang banner.
+* No type declarations — binaries don't need them.
+*/
+function cli(options = {}) {
+	return defineConfig({
+		entry: ["src/cli.ts"],
+		format: "esm",
+		dts: false,
+		clean: true,
+		sourcemap: true,
+		banner: { js: "#!/usr/bin/env node" },
+		...options
+	});
+}
+var cli_default = cli();
+//#endregion
+export { cli, cli_default as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/tsdown-config",
-  "version": "7.14.4",
+  "version": "7.15.0",
   "description": "Shared tsdown configurations for @theholocron packages.",
   "homepage": "https://github.com/theholocron/configs/tree/main/packages/tsdown-config#readme",
   "bugs": "https://github.com/theholocron/configs/issues",
@@ -24,8 +24,8 @@
     "typescript": "^5.9.3",
     "vitest": "^4.1.10",
     "@vitest/coverage-v8": "^4.1.10",
-    "@theholocron/tsconfig": "7.14.4",
-    "@theholocron/vitest-config": "7.14.4"
+    "@theholocron/tsconfig": "7.15.0",
+    "@theholocron/vitest-config": "7.15.0"
   },
   "exports": {
     ".": {
@@ -33,6 +33,11 @@
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./presets/cli": {
+      "types": "./dist/presets/cli.d.ts",
+      "import": "./dist/presets/cli.js",
+      "default": "./dist/presets/cli.js"
+    },
     "./presets/library": {
       "types": "./dist/presets/library.d.ts",
       "import": "./dist/presets/library.js",