feat: add --exclude-from-clean option

README.md

@@ -102,17 +102,22 @@ Options:
   -V, --version                                        output the version number
   -d, --dist <dist>                                    The dist directory to target
   -b, --build-script [buildScript]                     The build script to call after cleaning your dist directory
-  -nb, --no-build [noBuild]                            When enabled (default: false) the build step will not be called. Useful if you want to only bundle types and handle
-                                                       building yourself.
-  -nc, --no-clean [noClean]                            When enabled (default: false) the clean step will not be called. Useful if you want to only bundle types and handle
-                                                       cleaning yourself.
-  -ob, --only-bundle [onlyBundle]                      A shortcut to enabling both `--no-build` and `--no-clean`. This essentially makes it so rollup-type-bundler only
-                                                       deals with bundling types and nothing else.
-  -t, --typings-file-extension [typingsFileExtension]  The file extension for your typings files. Useful if you want to set `.cts` or `.mts`. If you forego adding a
-                                                       prefixing dot (`.`), it will be added for you.
+  -nb, --no-build [noBuild]                            When enabled (default: false) the build step will not be called. Useful if you want to only bundle types and handle building
+                                                       yourself.
+  -nc, --no-clean [noClean]                            When enabled (default: false) the clean step will not be called. Useful if you want to only bundle types and handle cleaning
+                                                       yourself.
+  -ob, --only-bundle [onlyBundle]                      A shortcut to enabling both `--no-build` and `--no-clean`. This essentially makes it so rollup-type-bundler only deals with
+                                                       bundling types and nothing else.
+  -t, --typings-file-extension [typingsFileExtension]  The file extension for your typings files. Useful if you want to set `.cts` or `.mts`. If you forego adding a prefixing dot
+                                                       (`.`), it will be added for you.
   -v, --verbose                                        Print verbose information
   -e, --external [external...]                         Repeatable, each will be treated as a new entry. Library or libraries to treat as external in Rollup (see:
                                                        https://rollupjs.org/guide/en/#warning-treating-module-as-external-dependency)
+  -ec, --exclude-from-clean [excludeFromClean...]      Repeatable, each will be treated as a new entry.
+                                                       Files to be excluded from the clean step, useful if you want to process those files manually yourself later.
+                                                       This is in particular useful if you have multiple entrypoints.
+                                                       Note that a String#endsWith check is used to check if an entry in this array matches a path of a file to delete. So you can
+                                                       either use the full relative path, or just the file name.
   -h, --help                                           display help for command
 ```
 
@@ -131,6 +136,7 @@ package). It should be named `.rollup-type-bundlerrc`, optionally suffixed with
 - `--typings-file-extension` maps to `typingsFileExtension`
 - `--verbose` maps to `verbose`
 - `--external` maps to `external`
+- `--exclude-from-clean` maps to `excludeFromClean`
 
 When using `.rollup-type-bundlerrc` or `.rollup-type-bundlerrc.json` as your
 config file you can also use the JSON schema to get schema validation. To do so,
@@ -178,6 +184,7 @@ This library has opinionated defaults for its options. These are as follows:
 - `--typings-file-extension` will default to `undefined`.
 - `--verbose` will default to `false`.
 - `--external` will default to `[]`.
+- `--exclude-from-clean` will default to `[]`.
 
 ## Buy us some doughnuts
 

assets/rollup-type-bundler.schema.json

@@ -26,6 +26,14 @@
       },
       "default": []
     },
+    "excludeFromClean": {
+      "description": "Files to be excluded from the clean step, useful if you want to process those files manually yourself later.\nThis is in particular useful if you have multiple entrypoints.\nNote that a String#endsWith check is used to check if an entry in this array matches a path of a file to delete. So you can either use the full relative path, or just the file name.",
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "default": []
+    },
     "noBuild": {
       "description": "When enabled (default: false) the build step will not be called. Useful if you want to only bundle types and handle building yourself.",
       "type": "boolean",

src/cli.ts

@@ -45,6 +45,16 @@ const command = new Command()
       'https://rollupjs.org/guide/en/#warning-treating-module-as-external-dependency'
     )})`,
     (value: string, previous: string[]) => (previous ?? []).concat([value])
+  )
+  .option(
+    '-ec, --exclude-from-clean [excludeFromClean...]',
+    [
+      'Repeatable, each will be treated as a new entry.',
+      'Files to be excluded from the clean step, useful if you want to process those files manually yourself later.',
+      'This is in particular useful if you have multiple entrypoints.',
+      'Note that a String#endsWith check is used to check if an entry in this array matches a path of a file to delete. So you can either use the full relative path, or just the file name.'
+    ].join('\n'),
+    (value: string, previous: string[]) => (previous ?? []).concat([value])
   );
 
 const program = command.parse(process.argv);
@@ -73,6 +83,7 @@ logVerboseInfo(
     `${indent}onlyBundle: ${JSON.stringify(options.onlyBundle)}`,
     `${indent}verbose: ${JSON.stringify(options.verbose)}`,
     `${indent}external: ${JSON.stringify(options.external)}`,
+    `${indent}excludeFromClean: ${JSON.stringify(options.excludeFromClean)}`,
     ''
   ],
   options.verbose

src/commands/clean-extraneous-types.ts

@@ -14,10 +14,14 @@ export async function cleanExtraneousTypes(options: Options): Promise<void> {
   try {
     const regexp = /(?:\.d\.[cm]?ts(?:\.map)?|\.tsbuildinfo)$/;
 
+    const inputFileName = `${basename(fileURLToPath(options.dist))}${sep}${getTypingsInputFileName(options)}`;
+
     for await (const path of findFilesRecursivelyRegex(options.dist, regexp)) {
-      if (!path.endsWith(`${basename(fileURLToPath(options.dist))}${sep}${getTypingsInputFileName(options)}`)) {
-        await rm(path);
+      if (path.endsWith(inputFileName) || options.excludeFromClean?.some((filePath) => path.endsWith(filePath))) {
+        continue;
       }
+
+      await rm(path);
     }
   } catch (err) {
     const typedError = err as Error;

src/lib/interfaces.d.ts

@@ -24,6 +24,16 @@ declare module 'commander' {
      * External packages to pass to rollup as external
      */
     external?: string[];
+    /**
+     * Repeatable, each will be treated as a new entry.
+     *
+     * Files to be excluded from the clean step, useful if you want to process those files manually yourself later.
+     *
+     * This is in particular useful if you have multiple entrypoints.
+     *
+     * Note that a `String#endsWith` check is used to check if an entry in this array matches a path of a file to delete. So you can either use the full relative path, or just the file name.
+     */
+    excludeFromClean?: string[];
     /**
      * When enabled the build step will not be called. Useful if you want to only bundle types and handle building yourself.
      * @default false

src/lib/optionsParser.ts

@@ -33,7 +33,8 @@ export async function parseOptionsFile(cliOptions: Options) {
       options = {
         ...fileOptions,
         ...options,
-        external: [...(fileOptions.external ?? []), ...(options.external ?? [])]
+        external: [...(fileOptions.external ?? []), ...(options.external ?? [])],
+        excludeFromClean: [...(fileOptions.excludeFromClean ?? []), ...(options.excludeFromClean ?? [])]
       };
     } catch (err) {
       const typedError = err as Error;
@@ -58,7 +59,8 @@ export async function parseOptionsFile(cliOptions: Options) {
       options = {
         ...fileOptions,
         ...options,
-        external: [...(fileOptions.external ?? []), ...(options.external ?? [])]
+        external: [...(fileOptions.external ?? []), ...(options.external ?? [])],
+        excludeFromClean: [...(fileOptions.excludeFromClean ?? []), ...(options.excludeFromClean ?? [])]
       };
     } catch (err) {
       const typedError = err as Error;
@@ -83,21 +85,23 @@ export async function parseOptionsFile(cliOptions: Options) {
 
 /**
  * Transforms the {@link Options} object to have a `dist` directory relative to the current working directory and as a file {@link URL}
- * Also hydrates the object with defaults in case `buildScript` and `external` were not yet set
+ * Also hydrates the object with defaults in case `buildScript`, `external`, and `excludeFromClean` were not yet set
  * @param options The options to parse
- * @returns The same options object, with the `dist` transformed and `buildScript` and `external` set.
+ * @returns The same options object, with the `dist` transformed and `buildScript`, `external`, and `excludeFromClean` set.
  */
 function transformOptionsDistPathToFileUrl(options: Options): Options {
   const distPath = Reflect.get(options, 'dist') ?? `.${sep}dist`;
   const buildScript = options.buildScript ?? 'build';
   const external = options.external ?? [];
+  const excludeFromClean = options.excludeFromClean ?? [];
   const verbose = options.verbose ?? false;
 
   return {
     ...options,
     dist: pathToFileURL(join(packageCwd, cast<string>(distPath))),
     buildScript,
     external,
+    excludeFromClean,
     verbose
   };
 }