feat: add --clean flag for build to auto rimraf dist

Author: stipsan

playground/babel-plugin/package.json

@@ -17,7 +17,7 @@
   "main": "./dist/index.cjs",
   "types": "./dist/index.d.ts",
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf dist"
   },
   "devDependencies": {

playground/browser-bundle/package.json

@@ -16,7 +16,7 @@
   },
   "main": "./dist/index.cjs",
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf dist"
   }
 }

playground/custom-dist/package.json

@@ -18,7 +18,7 @@
   "module": "./lib/index.esm.js",
   "types": "./lib/index.d.ts",
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf lib"
   }
 }

playground/default-export/package.json

@@ -16,7 +16,7 @@
   },
   "main": "./dist/index.cjs",
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf dist"
   }
 }

playground/dummy-commonjs/package.json

@@ -44,7 +44,7 @@
     "src"
   ],
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf dist"
   }
 }

playground/dummy-lodash-es/package.json

@@ -22,7 +22,7 @@
     "src"
   ],
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf dist",
     "test": "node test.cjs && node test.mjs"
   },

playground/dummy-lodash/package.json

@@ -22,7 +22,7 @@
     "src"
   ],
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf dist",
     "test": "node test.cjs && node test.mjs"
   },

playground/dummy-module/package.json

@@ -51,7 +51,7 @@
     "src"
   ],
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf dist"
   }
 }

playground/extra-bundles/package.json

@@ -15,7 +15,7 @@
   },
   "main": "./dist/index.js",
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf dist"
   }
 }

playground/js/package.json

@@ -15,7 +15,7 @@
   },
   "main": "./dist/index.js",
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf dist"
   }
 }

playground/multi-export/package.json

@@ -63,7 +63,7 @@
     }
   },
   "scripts": {
-    "build": "run-s clean && pkg build --strict && svelte-kit sync && svelte-package -i ./src/svelte -o dist-svelte && pkg check --strict",
+    "build": "pkg build --strict --clean && svelte-kit sync && svelte-package -i ./src/svelte -o dist-svelte && pkg check --strict",
     "clean": "rimraf dist"
   },
   "devDependencies": {

playground/multi-exports-commonjs/package.json

@@ -35,7 +35,7 @@
     }
   },
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf dist plugin.js"
   }
 }

playground/reference-esm-only/package.json

@@ -41,7 +41,7 @@
     "src"
   ],
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf dist"
   },
   "devDependencies": {

playground/styled-components-module/package.json

@@ -21,7 +21,7 @@
     "src"
   ],
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf dist",
     "test": "node test.mjs"
   },

playground/ts-bundler/package.json

@@ -17,7 +17,7 @@
   "main": "./dist/index.cjs",
   "types": "./dist/index.d.ts",
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf dist"
   }
 }

playground/ts-node16/package.json

@@ -17,7 +17,7 @@
   "main": "./dist/index.cjs",
   "types": "./dist/index.d.ts",
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf dist"
   }
 }

playground/ts/package.json

@@ -17,7 +17,7 @@
   "main": "./dist/index.cjs",
   "types": "./dist/index.d.ts",
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "check:types": "tsc",
     "clean": "rimraf dist"
   }

playground/use-client-directive/package.json

@@ -18,7 +18,7 @@
   "main": "./dist/index.cjs",
   "types": "./dist/index.d.ts",
   "scripts": {
-    "build": "run-s clean && pkg build --strict --check",
+    "build": "pkg build --strict --check --clean",
     "clean": "rimraf dist"
   },
   "devDependencies": {

src/cli/buildAction.ts

@@ -5,13 +5,15 @@ export async function buildAction(options: {
   emitDeclarationOnly?: boolean
   strict?: boolean
   tsconfig?: string
+  clean?: boolean
 }): Promise<void> {
   try {
     await build({
       cwd: process.cwd(),
       emitDeclarationOnly: options.emitDeclarationOnly,
       strict: options.strict,
       tsconfig: options.tsconfig,
+      clean: options.clean,
     })
   } catch (err) {
     handleError(err)

src/cli/index.ts

@@ -21,6 +21,7 @@ cli
   .option('--strict', 'Strict mode')
   .option('--tsconfig [tsconfig]', '[string] tsconfig.json')
   .option('--check', 'Run the check command after build (same as running `pkg build && pkg check`)')
+  .option('--clean', 'Clean the dist directory before building')
   .action(async (options) => {
     const {check = false, ...buildOptions} = options
     const {buildAction} = await import('./buildAction')

src/node/build.ts

@@ -1,3 +1,7 @@
+import path from 'node:path'
+
+import rimraf from 'rimraf'
+
 import {loadConfig, loadPkgWithReporting} from './core'
 import {createLogger} from './logger'
 import {resolveBuildContext} from './resolveBuildContext'
@@ -29,11 +33,19 @@ export async function build(options: {
   emitDeclarationOnly?: boolean
   strict?: boolean
   tsconfig?: string
+  clean?: boolean
 }): Promise<void> {
-  const {cwd, emitDeclarationOnly, strict = false, tsconfig: tsconfigOption} = options
+  const {
+    cwd,
+    emitDeclarationOnly,
+    strict = false,
+    tsconfig: tsconfigOption,
+    clean = false,
+  } = options
   const logger = createLogger()
 
   const config = await loadConfig({cwd})
+
   const legacyExports = config?.legacyExports ?? false
   const pkg = await loadPkgWithReporting({cwd, logger, strict, legacyExports})
 
@@ -49,6 +61,13 @@ export async function build(options: {
     tsconfig,
   })
 
+  if (clean) {
+    logger.log(
+      `Cleaning the contents of the \`dist\` folder: './${path.relative(cwd, ctx.distPath)}'`,
+    )
+    await rimraf(ctx.distPath)
+  }
+
   const buildTasks = resolveBuildTasks(ctx)
 
   for (const task of buildTasks) {