@jmlweb/tsup-config-base 1.0.1 → 1.1.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @jmlweb/tsup-config-base
 
+## 1.1.0
+
+### Minor Changes
+
+- 41b71c1: Add CLI preset with shebang support via createTsupCliConfig function
+
 ## 1.0.1
 
 ### Patch Changes

package/README.md

@@ -7,22 +7,23 @@
 
 > Base tsup configuration for jmlweb projects. Provides sensible defaults and a clean API for creating consistent build configurations.
 
-## Features
+## ✨ Features
 
-- **Sensible Defaults**: Pre-configured with common settings for TypeScript libraries
-- **Dual Format**: Generates both CommonJS and ESM outputs by default
-- **TypeScript Declarations**: Automatic `.d.ts` generation enabled
-- **Clean API**: Simple function to create configurations with external dependencies
-- **Zero Config**: Works out of the box with minimal setup
-- **Fully Typed**: Complete TypeScript support with exported types
+- 🎯 **Sensible Defaults**: Pre-configured with common settings for TypeScript libraries
+- 📦 **Dual Format**: Generates both CommonJS and ESM outputs by default
+- 📝 **TypeScript Declarations**: Automatic `.d.ts` generation enabled
+- 🔧 **Clean API**: Simple function to create configurations with external dependencies
+- ⚡ **Zero Config**: Works out of the box with minimal setup
+- 🛠️ **Fully Typed**: Complete TypeScript support with exported types
+- 🖥️ **CLI Preset**: Specialized configuration for CLI packages with shebang support
 
-## Installation
+## 📦 Installation
 
 ```bash
 npm install --save-dev @jmlweb/tsup-config-base tsup
 ```
 
-## Quick Start
+## 🚀 Quick Start
 
 Create a `tsup.config.ts` file in your project root:
 
@@ -32,7 +33,7 @@ import { createTsupConfig } from '@jmlweb/tsup-config-base';
 export default createTsupConfig();
 ```
 
-## Examples
+## 💡 Examples
 
 ### Basic Setup (No Externals)
 
@@ -113,7 +114,61 @@ export default createTsupConfig({
 });
 ```
 
-## Configuration Details
+### Object-Style Entry Points
+
+```typescript
+// tsup.config.ts
+import { createTsupConfig } from '@jmlweb/tsup-config-base';
+
+export default createTsupConfig({
+  entry: {
+    index: 'src/index.ts',
+    utils: 'src/utils/index.ts',
+  },
+});
+```
+
+### CLI Package Configuration
+
+For CLI packages that need shebang injection, use `createTsupCliConfig`:
+
+```typescript
+// tsup.config.ts
+import { createTsupCliConfig } from '@jmlweb/tsup-config-base';
+
+export default createTsupCliConfig();
+// Output: dist/cli.js with #!/usr/bin/env node shebang
+```
+
+### CLI with Custom Entry
+
+```typescript
+// tsup.config.ts
+import { createTsupCliConfig } from '@jmlweb/tsup-config-base';
+
+export default createTsupCliConfig({
+  entry: { bin: 'src/bin.ts' },
+  external: ['commander'],
+});
+```
+
+### CLI with Library API
+
+```typescript
+// tsup.config.ts
+import { createTsupCliConfig } from '@jmlweb/tsup-config-base';
+
+export default createTsupCliConfig({
+  entry: {
+    cli: 'src/cli.ts',
+    index: 'src/index.ts',
+  },
+  shebang: 'cli', // Only add shebang to cli entry
+  external: ['commander'],
+});
+```
+
+## 📋 Configuration Details
 
 ### Default Settings
 
@@ -130,41 +185,101 @@ export default createTsupConfig({
 
 #### `createTsupConfig(options?: TsupConfigOptions): Options`
 
-Creates a tsup configuration with sensible defaults.
+Creates a tsup configuration with sensible defaults for library packages.
 
 **Parameters:**
 
-| Option     | Type                           | Default            | Description                      |
-| ---------- | ------------------------------ | ------------------ | -------------------------------- |
-| `entry`    | `string[]`                     | `['src/index.ts']` | Entry point files                |
-| `format`   | `('cjs' \| 'esm' \| 'iife')[]` | `['cjs', 'esm']`   | Output formats                   |
-| `dts`      | `boolean`                      | `true`             | Generate declaration files       |
-| `clean`    | `boolean`                      | `true`             | Clean output before build        |
-| `outDir`   | `string`                       | `'dist'`           | Output directory                 |
-| `external` | `(string \| RegExp)[]`         | `[]`               | Packages to exclude from bundle  |
-| `options`  | `Partial<Options>`             | `{}`               | Additional tsup options to merge |
+| Option     | Type                                 | Default            | Description                      |
+| ---------- | ------------------------------------ | ------------------ | -------------------------------- |
+| `entry`    | `string[] \| Record<string, string>` | `['src/index.ts']` | Entry point files                |
+| `format`   | `('cjs' \| 'esm' \| 'iife')[]`       | `['cjs', 'esm']`   | Output formats                   |
+| `dts`      | `boolean`                            | `true`             | Generate declaration files       |
+| `clean`    | `boolean`                            | `true`             | Clean output before build        |
+| `outDir`   | `string`                             | `'dist'`           | Output directory                 |
+| `external` | `(string \| RegExp)[]`               | `[]`               | Packages to exclude from bundle  |
+| `options`  | `Partial<Options>`                   | `{}`               | Additional tsup options to merge |
 
 **Returns:** A complete tsup `Options` object.
 
-#### `BASE_DEFAULTS`
+#### `createTsupCliConfig(options?: TsupCliConfigOptions): Options | Options[]`
+
+Creates a CLI-specific tsup configuration with shebang support.
+
+**Parameters:**
+
+| Option     | Type                                 | Default                 | Description                                 |
+| ---------- | ------------------------------------ | ----------------------- | ------------------------------------------- |
+| `entry`    | `string[] \| Record<string, string>` | `{ cli: 'src/cli.ts' }` | Entry point files                           |
+| `format`   | `('cjs' \| 'esm' \| 'iife')[]`       | `['esm']`               | Output formats (ESM only by default)        |
+| `dts`      | `boolean`                            | `true`                  | Generate declaration files                  |
+| `clean`    | `boolean`                            | `true`                  | Clean output before build                   |
+| `outDir`   | `string`                             | `'dist'`                | Output directory                            |
+| `external` | `(string \| RegExp)[]`               | `[]`                    | Packages to exclude from bundle             |
+| `target`   | `NodeTarget`                         | `'node18'`              | Node.js target version                      |
+| `shebang`  | `boolean \| string \| string[]`      | `true`                  | Add shebang to entries (true = all entries) |
+| `options`  | `Partial<Options>`                   | `{}`                    | Additional tsup options to merge            |
 
-Exported constant containing the default configuration values for reference.
+**Returns:** A tsup `Options` object, or an array of `Options` when selective shebang is used.
 
-#### `Options` (re-exported from tsup)
+#### Exported Constants
 
-The tsup Options type is re-exported for convenience when extending configurations.
+- `BASE_DEFAULTS` - Default library configuration values
+- `CLI_DEFAULTS` - Default CLI configuration values
+- `Options` - Re-exported from tsup
 
-## When to Use
+#### Type Exports
+
+- `EntryConfig` - Entry point configuration type (`string[] | Record<string, string>`)
+- `NodeTarget` - Node.js target version type (`'node16' | 'node18' | 'node20' | 'node22' | ...`)
+- `TsupConfigOptions` - Options for `createTsupConfig`
+- `TsupCliConfigOptions` - Options for `createTsupCliConfig`
+
+## 🎯 When to Use
 
 Use this configuration when you want:
 
-- Consistent build configuration across multiple packages
-- Dual-format output (CommonJS + ESM) for maximum compatibility
-- Automatic TypeScript declaration generation
-- A clean, simple API for specifying externals
-- Easy customization without repeating boilerplate
+- ✅ Consistent build configuration across multiple packages
+- ✅ Dual-format output (CommonJS + ESM) for maximum compatibility
+- ✅ Automatic TypeScript declaration generation
+- ✅ A clean, simple API for specifying externals
+- ✅ Easy customization without repeating boilerplate
+- ✅ CLI packages with proper shebang injection
+
+## 🔧 Extending the Configuration
+
+You can extend the configuration for your specific needs:
+
+### Adding Custom Options
+
+```typescript
+// tsup.config.ts
+import { createTsupConfig } from '@jmlweb/tsup-config-base';
+
+export default createTsupConfig({
+  external: ['vitest'],
+  options: {
+    minify: true,
+    sourcemap: true,
+    splitting: true,
+    target: 'es2022',
+  },
+});
+```
+
+### Overriding Defaults
+
+```typescript
+// tsup.config.ts
+import { createTsupConfig } from '@jmlweb/tsup-config-base';
+
+export default createTsupConfig({
+  format: ['esm'], // ESM only
+  dts: false, // Disable type declarations
+  outDir: 'build', // Custom output directory
+});
+```
 
-## Externals Strategy
+### Externals Strategy
 
 When configuring `external`, include:
 
@@ -188,7 +303,7 @@ export default createTsupConfig({
 });
 ```
 
-## Usage with Scripts
+## 📝 Usage with Scripts
 
 Add build scripts to your `package.json`:
 
@@ -209,24 +324,24 @@ npm run build    # Build the package
 npm run clean    # Clean build output
 ```
 
-## Requirements
+## 📋 Requirements
 
 - **Node.js** >= 18.0.0
 - **tsup** >= 8.0.0
 
-## Peer Dependencies
+## 📦 Peer Dependencies
 
 This package requires the following peer dependency:
 
 - `tsup` (>=8.0.0)
 
-## Related Packages
+## 🔗 Related Packages
 
 - [`@jmlweb/eslint-config-base`](../eslint-config-base) - ESLint config for TypeScript projects
 - [`@jmlweb/prettier-config-base`](../prettier-config-base) - Prettier config for consistent formatting
 - [`@jmlweb/tsconfig-base`](../tsconfig-base) - TypeScript configuration
 - [`@jmlweb/vitest-config`](../vitest-config) - Vitest configuration for testing
 
-## License
+## 📄 License
 
 MIT

package/dist/index.cjs

@@ -21,6 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   BASE_DEFAULTS: () => BASE_DEFAULTS,
+  CLI_DEFAULTS: () => CLI_DEFAULTS,
+  createTsupCliConfig: () => createTsupCliConfig,
   createTsupConfig: () => createTsupConfig
 });
 module.exports = __toCommonJS(index_exports);
@@ -31,6 +33,15 @@ var BASE_DEFAULTS = {
   clean: true,
   outDir: "dist"
 };
+var CLI_DEFAULTS = {
+  entry: { cli: "src/cli.ts" },
+  format: ["esm"],
+  dts: true,
+  clean: true,
+  outDir: "dist",
+  target: "node18",
+  shebang: true
+};
 var createTsupConfig = (config = {}) => {
   const {
     entry = BASE_DEFAULTS.entry,
@@ -51,8 +62,114 @@ var createTsupConfig = (config = {}) => {
     ...options
   };
 };
+var SHEBANG = "#!/usr/bin/env node";
+var createTsupCliConfig = (config = {}) => {
+  const {
+    entry = CLI_DEFAULTS.entry,
+    format = CLI_DEFAULTS.format,
+    dts = CLI_DEFAULTS.dts,
+    clean = CLI_DEFAULTS.clean,
+    outDir = CLI_DEFAULTS.outDir,
+    external = [],
+    target = CLI_DEFAULTS.target,
+    shebang = CLI_DEFAULTS.shebang,
+    options = {}
+  } = config;
+  const shebangEntries = normalizeShebangConfig(shebang);
+  if (shebangEntries === "all") {
+    return {
+      entry,
+      format,
+      dts,
+      clean,
+      outDir,
+      target,
+      banner: { js: SHEBANG },
+      ...external.length > 0 && { external },
+      ...options
+    };
+  }
+  if (shebangEntries.length === 0) {
+    return {
+      entry,
+      format,
+      dts,
+      clean,
+      outDir,
+      target,
+      ...external.length > 0 && { external },
+      ...options
+    };
+  }
+  const entryObject = normalizeEntry(entry);
+  const shebangSet = new Set(shebangEntries);
+  const withShebang = {};
+  const withoutShebang = {};
+  for (const [name, path] of Object.entries(entryObject)) {
+    if (shebangSet.has(name)) {
+      withShebang[name] = path;
+    } else {
+      withoutShebang[name] = path;
+    }
+  }
+  const configs = [];
+  if (Object.keys(withShebang).length > 0) {
+    configs.push({
+      entry: withShebang,
+      format,
+      dts,
+      clean,
+      outDir,
+      target,
+      banner: { js: SHEBANG },
+      ...external.length > 0 && { external },
+      ...options
+    });
+  }
+  if (Object.keys(withoutShebang).length > 0) {
+    configs.push({
+      entry: withoutShebang,
+      format,
+      dts,
+      // Only clean on first config
+      clean: configs.length === 0 ? clean : false,
+      outDir,
+      target,
+      ...external.length > 0 && { external },
+      ...options
+    });
+  }
+  return configs.length === 1 ? configs[0] : configs;
+};
+var normalizeEntry = (entry) => {
+  if (Array.isArray(entry)) {
+    return entry.reduce(
+      (acc, path) => {
+        const name = path.replace(/^.*\//, "").replace(/\.[^.]+$/, "");
+        acc[name] = path;
+        return acc;
+      },
+      {}
+    );
+  }
+  return entry;
+};
+var normalizeShebangConfig = (shebang) => {
+  if (shebang === true) {
+    return "all";
+  }
+  if (shebang === false) {
+    return [];
+  }
+  if (typeof shebang === "string") {
+    return [shebang];
+  }
+  return shebang;
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BASE_DEFAULTS,
+  CLI_DEFAULTS,
+  createTsupCliConfig,
   createTsupConfig
 });

package/dist/index.d.cts

@@ -1,15 +1,32 @@
 import { Options } from 'tsup';
 export { Options } from 'tsup';
 
+/**
+ * Entry points configuration - can be an array of paths or an object mapping names to paths
+ */
+type EntryConfig = string[] | Record<string, string>;
+/**
+ * Node.js target version for CLI builds
+ */
+type NodeTarget = 'node16' | 'node18' | 'node20' | 'node22' | `node${number}`;
 /**
  * Options for creating a base tsup configuration
  */
 interface TsupConfigOptions {
     /**
      * Entry points for the build
+     * Can be an array of paths or an object mapping output names to source paths
      * @default ['src/index.ts']
+     * @example
+     * ```typescript
+     * // Array format
+     * entry: ['src/index.ts', 'src/cli.ts']
+     *
+     * // Object format (named entries)
+     * entry: { index: 'src/index.ts', cli: 'src/cli.ts' }
+     * ```
      */
-    entry?: string[];
+    entry?: EntryConfig;
     /**
      * Output formats
      * @default ['cjs', 'esm']
@@ -41,16 +58,102 @@ interface TsupConfigOptions {
      */
     options?: Omit<Options, 'entry' | 'format' | 'dts' | 'clean' | 'outDir' | 'external'>;
 }
+/**
+ * Options for creating a CLI-specific tsup configuration
+ */
+interface TsupCliConfigOptions {
+    /**
+     * Entry points for the build
+     * Can be an array of paths or an object mapping output names to source paths
+     * @default { cli: 'src/cli.ts' }
+     * @example
+     * ```typescript
+     * // Single CLI entry
+     * entry: { cli: 'src/cli.ts' }
+     *
+     * // CLI with library API
+     * entry: { cli: 'src/cli.ts', index: 'src/index.ts' }
+     *
+     * // Array format
+     * entry: ['src/cli.ts', 'src/index.ts']
+     * ```
+     */
+    entry?: EntryConfig;
+    /**
+     * Output formats
+     * @default ['esm']
+     */
+    format?: ('cjs' | 'esm' | 'iife')[];
+    /**
+     * Generate TypeScript declaration files
+     * @default true
+     */
+    dts?: boolean;
+    /**
+     * Clean output directory before build
+     * @default true
+     */
+    clean?: boolean;
+    /**
+     * Output directory
+     * @default 'dist'
+     */
+    outDir?: string;
+    /**
+     * External packages to exclude from the bundle
+     * @default []
+     */
+    external?: (string | RegExp)[];
+    /**
+     * Node.js target version for the build
+     * @default 'node18'
+     */
+    target?: NodeTarget;
+    /**
+     * Add shebang (#!/usr/bin/env node) to the output
+     * When true, adds shebang to all entry points
+     * When a string or array, only adds shebang to matching entry names
+     * @default true
+     * @example
+     * ```typescript
+     * // Add shebang to all entries
+     * shebang: true
+     *
+     * // Add shebang only to 'cli' entry
+     * shebang: 'cli'
+     *
+     * // Add shebang to specific entries
+     * shebang: ['cli', 'bin']
+     * ```
+     */
+    shebang?: boolean | string | string[];
+    /**
+     * Additional tsup options to merge with the base configuration
+     */
+    options?: Omit<Options, 'entry' | 'format' | 'dts' | 'clean' | 'outDir' | 'external' | 'target'>;
+}
 /**
  * Base tsup configuration defaults used across all @jmlweb packages
  */
 declare const BASE_DEFAULTS: {
-    entry: string[];
+    entry: EntryConfig;
     format: ("cjs" | "esm")[];
     dts: true;
     clean: true;
     outDir: string;
 };
+/**
+ * CLI-specific tsup configuration defaults
+ */
+declare const CLI_DEFAULTS: {
+    entry: EntryConfig;
+    format: ("esm")[];
+    dts: true;
+    clean: true;
+    outDir: string;
+    target: NodeTarget;
+    shebang: boolean | string | string[];
+};
 /**
  * Creates a base tsup configuration with sensible defaults
  *
@@ -84,5 +187,42 @@ declare const BASE_DEFAULTS: {
  * ```
  */
 declare const createTsupConfig: (config?: TsupConfigOptions) => Options;
+/**
+ * Creates a CLI-specific tsup configuration with shebang support
+ *
+ * This preset is optimized for CLI packages with:
+ * - ESM-only output by default
+ * - Automatic shebang injection
+ * - Node.js target specification
+ * - Support for object-style entry points
+ *
+ * @example
+ * ```typescript
+ * // Simple CLI with shebang
+ * import { createTsupCliConfig } from '@jmlweb/tsup-config-base';
+ * export default createTsupCliConfig();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // CLI with library API (shebang only on cli entry)
+ * import { createTsupCliConfig } from '@jmlweb/tsup-config-base';
+ * export default createTsupCliConfig({
+ *   entry: { cli: 'src/cli.ts', index: 'src/index.ts' },
+ *   shebang: 'cli', // Only add shebang to cli entry
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // CLI targeting Node.js 22
+ * import { createTsupCliConfig } from '@jmlweb/tsup-config-base';
+ * export default createTsupCliConfig({
+ *   target: 'node22',
+ *   external: ['commander'],
+ * });
+ * ```
+ */
+declare const createTsupCliConfig: (config?: TsupCliConfigOptions) => Options | Options[];
 
-export { BASE_DEFAULTS, type TsupConfigOptions, createTsupConfig };
+export { BASE_DEFAULTS, CLI_DEFAULTS, type EntryConfig, type NodeTarget, type TsupCliConfigOptions, type TsupConfigOptions, createTsupCliConfig, createTsupConfig };

package/dist/index.d.ts

@@ -1,15 +1,32 @@
 import { Options } from 'tsup';
 export { Options } from 'tsup';
 
+/**
+ * Entry points configuration - can be an array of paths or an object mapping names to paths
+ */
+type EntryConfig = string[] | Record<string, string>;
+/**
+ * Node.js target version for CLI builds
+ */
+type NodeTarget = 'node16' | 'node18' | 'node20' | 'node22' | `node${number}`;
 /**
  * Options for creating a base tsup configuration
  */
 interface TsupConfigOptions {
     /**
      * Entry points for the build
+     * Can be an array of paths or an object mapping output names to source paths
      * @default ['src/index.ts']
+     * @example
+     * ```typescript
+     * // Array format
+     * entry: ['src/index.ts', 'src/cli.ts']
+     *
+     * // Object format (named entries)
+     * entry: { index: 'src/index.ts', cli: 'src/cli.ts' }
+     * ```
      */
-    entry?: string[];
+    entry?: EntryConfig;
     /**
      * Output formats
      * @default ['cjs', 'esm']
@@ -41,16 +58,102 @@ interface TsupConfigOptions {
      */
     options?: Omit<Options, 'entry' | 'format' | 'dts' | 'clean' | 'outDir' | 'external'>;
 }
+/**
+ * Options for creating a CLI-specific tsup configuration
+ */
+interface TsupCliConfigOptions {
+    /**
+     * Entry points for the build
+     * Can be an array of paths or an object mapping output names to source paths
+     * @default { cli: 'src/cli.ts' }
+     * @example
+     * ```typescript
+     * // Single CLI entry
+     * entry: { cli: 'src/cli.ts' }
+     *
+     * // CLI with library API
+     * entry: { cli: 'src/cli.ts', index: 'src/index.ts' }
+     *
+     * // Array format
+     * entry: ['src/cli.ts', 'src/index.ts']
+     * ```
+     */
+    entry?: EntryConfig;
+    /**
+     * Output formats
+     * @default ['esm']
+     */
+    format?: ('cjs' | 'esm' | 'iife')[];
+    /**
+     * Generate TypeScript declaration files
+     * @default true
+     */
+    dts?: boolean;
+    /**
+     * Clean output directory before build
+     * @default true
+     */
+    clean?: boolean;
+    /**
+     * Output directory
+     * @default 'dist'
+     */
+    outDir?: string;
+    /**
+     * External packages to exclude from the bundle
+     * @default []
+     */
+    external?: (string | RegExp)[];
+    /**
+     * Node.js target version for the build
+     * @default 'node18'
+     */
+    target?: NodeTarget;
+    /**
+     * Add shebang (#!/usr/bin/env node) to the output
+     * When true, adds shebang to all entry points
+     * When a string or array, only adds shebang to matching entry names
+     * @default true
+     * @example
+     * ```typescript
+     * // Add shebang to all entries
+     * shebang: true
+     *
+     * // Add shebang only to 'cli' entry
+     * shebang: 'cli'
+     *
+     * // Add shebang to specific entries
+     * shebang: ['cli', 'bin']
+     * ```
+     */
+    shebang?: boolean | string | string[];
+    /**
+     * Additional tsup options to merge with the base configuration
+     */
+    options?: Omit<Options, 'entry' | 'format' | 'dts' | 'clean' | 'outDir' | 'external' | 'target'>;
+}
 /**
  * Base tsup configuration defaults used across all @jmlweb packages
  */
 declare const BASE_DEFAULTS: {
-    entry: string[];
+    entry: EntryConfig;
     format: ("cjs" | "esm")[];
     dts: true;
     clean: true;
     outDir: string;
 };
+/**
+ * CLI-specific tsup configuration defaults
+ */
+declare const CLI_DEFAULTS: {
+    entry: EntryConfig;
+    format: ("esm")[];
+    dts: true;
+    clean: true;
+    outDir: string;
+    target: NodeTarget;
+    shebang: boolean | string | string[];
+};
 /**
  * Creates a base tsup configuration with sensible defaults
  *
@@ -84,5 +187,42 @@ declare const BASE_DEFAULTS: {
  * ```
  */
 declare const createTsupConfig: (config?: TsupConfigOptions) => Options;
+/**
+ * Creates a CLI-specific tsup configuration with shebang support
+ *
+ * This preset is optimized for CLI packages with:
+ * - ESM-only output by default
+ * - Automatic shebang injection
+ * - Node.js target specification
+ * - Support for object-style entry points
+ *
+ * @example
+ * ```typescript
+ * // Simple CLI with shebang
+ * import { createTsupCliConfig } from '@jmlweb/tsup-config-base';
+ * export default createTsupCliConfig();
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // CLI with library API (shebang only on cli entry)
+ * import { createTsupCliConfig } from '@jmlweb/tsup-config-base';
+ * export default createTsupCliConfig({
+ *   entry: { cli: 'src/cli.ts', index: 'src/index.ts' },
+ *   shebang: 'cli', // Only add shebang to cli entry
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // CLI targeting Node.js 22
+ * import { createTsupCliConfig } from '@jmlweb/tsup-config-base';
+ * export default createTsupCliConfig({
+ *   target: 'node22',
+ *   external: ['commander'],
+ * });
+ * ```
+ */
+declare const createTsupCliConfig: (config?: TsupCliConfigOptions) => Options | Options[];
 
-export { BASE_DEFAULTS, type TsupConfigOptions, createTsupConfig };
+export { BASE_DEFAULTS, CLI_DEFAULTS, type EntryConfig, type NodeTarget, type TsupCliConfigOptions, type TsupConfigOptions, createTsupCliConfig, createTsupConfig };

package/dist/index.js

@@ -6,6 +6,15 @@ var BASE_DEFAULTS = {
   clean: true,
   outDir: "dist"
 };
+var CLI_DEFAULTS = {
+  entry: { cli: "src/cli.ts" },
+  format: ["esm"],
+  dts: true,
+  clean: true,
+  outDir: "dist",
+  target: "node18",
+  shebang: true
+};
 var createTsupConfig = (config = {}) => {
   const {
     entry = BASE_DEFAULTS.entry,
@@ -26,7 +35,113 @@ var createTsupConfig = (config = {}) => {
     ...options
   };
 };
+var SHEBANG = "#!/usr/bin/env node";
+var createTsupCliConfig = (config = {}) => {
+  const {
+    entry = CLI_DEFAULTS.entry,
+    format = CLI_DEFAULTS.format,
+    dts = CLI_DEFAULTS.dts,
+    clean = CLI_DEFAULTS.clean,
+    outDir = CLI_DEFAULTS.outDir,
+    external = [],
+    target = CLI_DEFAULTS.target,
+    shebang = CLI_DEFAULTS.shebang,
+    options = {}
+  } = config;
+  const shebangEntries = normalizeShebangConfig(shebang);
+  if (shebangEntries === "all") {
+    return {
+      entry,
+      format,
+      dts,
+      clean,
+      outDir,
+      target,
+      banner: { js: SHEBANG },
+      ...external.length > 0 && { external },
+      ...options
+    };
+  }
+  if (shebangEntries.length === 0) {
+    return {
+      entry,
+      format,
+      dts,
+      clean,
+      outDir,
+      target,
+      ...external.length > 0 && { external },
+      ...options
+    };
+  }
+  const entryObject = normalizeEntry(entry);
+  const shebangSet = new Set(shebangEntries);
+  const withShebang = {};
+  const withoutShebang = {};
+  for (const [name, path] of Object.entries(entryObject)) {
+    if (shebangSet.has(name)) {
+      withShebang[name] = path;
+    } else {
+      withoutShebang[name] = path;
+    }
+  }
+  const configs = [];
+  if (Object.keys(withShebang).length > 0) {
+    configs.push({
+      entry: withShebang,
+      format,
+      dts,
+      clean,
+      outDir,
+      target,
+      banner: { js: SHEBANG },
+      ...external.length > 0 && { external },
+      ...options
+    });
+  }
+  if (Object.keys(withoutShebang).length > 0) {
+    configs.push({
+      entry: withoutShebang,
+      format,
+      dts,
+      // Only clean on first config
+      clean: configs.length === 0 ? clean : false,
+      outDir,
+      target,
+      ...external.length > 0 && { external },
+      ...options
+    });
+  }
+  return configs.length === 1 ? configs[0] : configs;
+};
+var normalizeEntry = (entry) => {
+  if (Array.isArray(entry)) {
+    return entry.reduce(
+      (acc, path) => {
+        const name = path.replace(/^.*\//, "").replace(/\.[^.]+$/, "");
+        acc[name] = path;
+        return acc;
+      },
+      {}
+    );
+  }
+  return entry;
+};
+var normalizeShebangConfig = (shebang) => {
+  if (shebang === true) {
+    return "all";
+  }
+  if (shebang === false) {
+    return [];
+  }
+  if (typeof shebang === "string") {
+    return [shebang];
+  }
+  return shebang;
+};
 export {
   BASE_DEFAULTS,
+  CLI_DEFAULTS,
+  createTsupCliConfig,
   createTsupConfig
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jmlweb/tsup-config-base",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Base tsup configuration for jmlweb projects with sensible defaults",
   "type": "module",
   "main": "./dist/index.cjs",