@kineticcafe/rollup-plugin-delete
v3.0.1
Published
Delete files and folders using Rollup
Downloads
8,573
Maintainers
Readme
@kineticcafe/rollup-plugin-delete
A Rollup plugin to delete files and folders during the build process. This is
a fork of the excellent rollup-plugin-delete
. The changes are:
Convert to Typescript. The previous version produces
TS2349
even though the created type declaration file and the generated type declaration file are more or less the same.Removing
del
, which depends on outdated versions ofglobby
andrimraf
.
About
This plugin is useful when you want to clean dist
or other folders and files
before bundling. Targets use minimatch
pattern matching, so
review the documentation for patterns.
Installation
# pnpm
pnpm install -D @kineticcafe/rollup-plugin-delete
# yarn
yarn add -D @kineticcafe/rollup-plugin-delete
# npm
npm install -D @kineticcafe/rollup-plugin-delete
Usage
// rollup.config.js
import { del } from '@kineticcafe/rollup-plugin-delete'
export default {
input: 'src/index.js',
output: {
file: 'dist/app.js',
format: 'cjs',
},
plugins: [del({ targets: 'dist/*' })],
}
You can also remove files after the bundle has been written by changing the
hook
:
// vite.config.ts
import * as path from 'node:path'
import { defineConfig } from 'vite'
import { del } from '@kineticcafe/rollup-plugin-delete'
const deleteIndexHtml = () =>
del({
targets: path.resolve(__dirname, 'dist/index.html'),
hook: 'writeBundle',
})
export default defineConfig({
plugins: [deleteIndexHtml()],
})
Configuration
| Name | Type | Default | Purpose |
| ------------- | ---------------------- | ------------- | -------------------------------------------------------------------------------------- |
| targets
| string
| string[]
| [] | A string or an array of patterns of files and folders to be deleted. |
| verbose
| boolean
| false
| Output removed files and folders to console. Default is false
. |
| hook
| string
| buildStart
| The Rollup hook the plugin should use. |
| runOnce
| boolean
| false
| Delete items once. Useful in watch mode. |
| dryRun
| boolean
| false
| Does not remove the files, but reports what would be removed. Implies verbose: true
. |
| concurrency
| number
| Infinity
| Concurrency limit. Minimum 1
. |
| cwd
| string
| process.cwd
| The current working directory in which to search. |
All other options are inherited from globby
, but expandDirectories
,
onlyFiles
, and followSymbolicLinks
default to false
.
Examples
del({ targets: 'dist/*' })
del({ targets: ['dist/*', 'build/*'] })
del({ targets: 'dist/*', verbose: true })
del({ targets: 'dist/*', hook: 'buildEnd' })
del({ targets: 'dist/*', runOnce: true })
del({ targets: 'dist/*', dryRun: true })
Note: use
*
(wildcard character) in the pattern to show removed files.
License
MIT