@rollup-extras/plugin-clean 1.0.1 → 1.0.2

package/README.md

@@ -15,15 +15,74 @@ Plugin runs on `renderStart` per each output and uses output.dir as a default ta
 
 Uses [`@niceties/logger`](https://github.com/kshutkin/niceties/blob/main/logger/README.md) to log messages, can be configured through `@niceties/logger` API.
 
+[Changlelog](./CHANGELOG.md)
+
+## Installation
+
+```
+npm install --save-dev @rollup-extras/plugin-clean
+```
+
+### Examples
+
+Normal usage:
+
+```javascript
+import clean from '@rollup-extras/plugin-clean';
+
+export default {
+	input: 'src/index.js',
+
+    output: {
+        format: 'es',
+        dir: 'dest'
+    },
+
+	plugins: [clean()],
+}
+```
+
+To override / provide target directory to clean use:
+```javascript
+clean('dir')
+```
+or
+
+```javascript
+clean(['dir1', 'dir2'])
+```
+or
+
+```javascript
+clean({targets: 'dir1'})
+```
+
+or
+
+```javascript
+clean({targets: ['dir1', 'dir2']})
+```
+
+Other supporded fields in options object: `pluginName`, `deleteOnce`, `outputPlugin` and `verbose`.
+
+`pluginName` is just for debugging purpose so you can understand which instance of plugin responsible for an error.
+
+`deleteOnce` can be set to `false` if you want to clean directory every rebuild.
+
+`outputPlugin` can be set to `false` if you want plugin to trigger earlier (use with caution, you may want to define `targets` youself in this mode)
+
+`verbose` is to get more messages in console.
+
 ## Configuration
 
 ```typescript
-export type CleanPluginOptions = {
+type CleanPluginOptions = {
     targets?: string | string[], // defaulted to output.dir per output
     pluginName?: string, // for debugging purposes, default is `@rollup-extras/plugin-clean`
-    runOnce?: boolean, // default true
+    deleteOnce?: boolean, // default true
+    outputPlugin?: boolean, // default true
     verbose?: boolean // default false
-};
+} | string | string[];
 ```
 
 ## Prior Art

package/dist/index.cjs

@@ -9,34 +9,55 @@ function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'defau
 var fs__default = /*#__PURE__*/_interopDefaultLegacy(fs);
 var path__default = /*#__PURE__*/_interopDefaultLegacy(path);
 
-function index ({ targets, pluginName, runOnce, verbose } = {}) {
-    const deleted = new Set();
-    pluginName !== null && pluginName !== void 0 ? pluginName : (pluginName = '@rollup-extras/plugin-clean');
-    runOnce !== null && runOnce !== void 0 ? runOnce : (runOnce = true);
-    return {
-        name: pluginName,
-        async renderStart(options) {
-            if (!targets) {
-                if (options.dir) {
-                    await removeDir(options.dir);
-                }
-            }
-            else {
-                if (Array.isArray(targets)) {
-                    await Promise.all(targets.map(removeDir));
-                }
-                else {
-                    await removeDir(targets);
-                }
+function index (options = {}) {
+    const deleted = new Map();
+    const normailizedOptions = normalizeOptions(options);
+    const { pluginName, deleteOnce, verbose, outputPlugin } = normailizedOptions;
+    let { targets } = normailizedOptions;
+    const pluginInstance = {
+        name: pluginName
+    };
+    if (outputPlugin) {
+        pluginInstance.renderStart = renderStart;
+    }
+    else {
+        pluginInstance.buildStart = buildStart;
+        pluginInstance.options = optionsHook;
+    }
+    return pluginInstance;
+    async function optionsHook(config) {
+        var _a;
+        if (!targets && config) {
+            targets = (Array.isArray(config.output) ? config.output.map(item => item.dir) : [(_a = config.output) === null || _a === void 0 ? void 0 : _a.dir])
+                .filter(Boolean);
+        }
+        return null;
+    }
+    async function buildStart() {
+        if (targets) {
+            await Promise.all(targets.map(removeDir));
+        }
+    }
+    async function renderStart(options) {
+        if (!targets) {
+            if (options.dir) {
+                await removeDir(options.dir);
             }
         }
-    };
+        else {
+            await Promise.all(targets.map(removeDir));
+        }
+    }
     async function removeDir(dir) {
         const normalizedDir = normalizeSlash(path__default["default"].normalize(dir));
-        if (runOnce && deleted.has(normalizedDir)) {
-            return;
+        if (deleteOnce && deleted.has(normalizedDir)) {
+            return deleted.get(normalizedDir);
         }
-        deleted.add(normalizedDir);
+        const removePromise = doRemove(normalizedDir);
+        deleted.set(normalizedDir, removePromise);
+        return removePromise;
+    }
+    async function doRemove(normalizedDir) {
         const logger$1 = logger.createLogger(pluginName);
         try {
             logger$1.start(`cleaning '${normalizedDir}'`, verbose ? 1 /* info */ : 0 /* verbose */);
@@ -54,6 +75,29 @@ function normalizeSlash(dir) {
         return `${dir.substring(0, dir.length - 1)}`;
     }
     return dir;
+}
+function normalizeOptions(userOptions) {
+    var _a, _b, _c, _d;
+    const options = {
+        pluginName: (_a = userOptions.pluginName) !== null && _a !== void 0 ? _a : '@rollup-extras/plugin-clean',
+        deleteOnce: (_b = userOptions.deleteOnce) !== null && _b !== void 0 ? _b : true,
+        verbose: (_c = userOptions.verbose) !== null && _c !== void 0 ? _c : false,
+        outputPlugin: (_d = userOptions.outputPlugin) !== null && _d !== void 0 ? _d : true,
+        targets: getTargets(userOptions)
+    };
+    return options;
+}
+function getTargets(userOptions) {
+    if (typeof userOptions === 'string') {
+        return [userOptions];
+    }
+    if (Array.isArray(userOptions)) {
+        return userOptions;
+    }
+    if (typeof userOptions === 'object') {
+        return 'targets' in userOptions ? getTargets(userOptions.targets) : undefined;
+    }
+    return [];
 }
 
 module.exports = index;

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 import { PluginHooks } from 'rollup';
 import { CleanPluginOptions } from './types';
-export default function ({ targets, pluginName, runOnce, verbose }?: CleanPluginOptions): Partial<PluginHooks>;
+export default function (options?: CleanPluginOptions): Partial<PluginHooks>;

package/dist/index.mjs

@@ -2,34 +2,55 @@ import fs from 'fs/promises';
 import path from 'path';
 import { createLogger } from '@niceties/logger';
 
-function index ({ targets, pluginName, runOnce, verbose } = {}) {
-    const deleted = new Set();
-    pluginName !== null && pluginName !== void 0 ? pluginName : (pluginName = '@rollup-extras/plugin-clean');
-    runOnce !== null && runOnce !== void 0 ? runOnce : (runOnce = true);
-    return {
-        name: pluginName,
-        async renderStart(options) {
-            if (!targets) {
-                if (options.dir) {
-                    await removeDir(options.dir);
-                }
-            }
-            else {
-                if (Array.isArray(targets)) {
-                    await Promise.all(targets.map(removeDir));
-                }
-                else {
-                    await removeDir(targets);
-                }
+function index (options = {}) {
+    const deleted = new Map();
+    const normailizedOptions = normalizeOptions(options);
+    const { pluginName, deleteOnce, verbose, outputPlugin } = normailizedOptions;
+    let { targets } = normailizedOptions;
+    const pluginInstance = {
+        name: pluginName
+    };
+    if (outputPlugin) {
+        pluginInstance.renderStart = renderStart;
+    }
+    else {
+        pluginInstance.buildStart = buildStart;
+        pluginInstance.options = optionsHook;
+    }
+    return pluginInstance;
+    async function optionsHook(config) {
+        var _a;
+        if (!targets && config) {
+            targets = (Array.isArray(config.output) ? config.output.map(item => item.dir) : [(_a = config.output) === null || _a === void 0 ? void 0 : _a.dir])
+                .filter(Boolean);
+        }
+        return null;
+    }
+    async function buildStart() {
+        if (targets) {
+            await Promise.all(targets.map(removeDir));
+        }
+    }
+    async function renderStart(options) {
+        if (!targets) {
+            if (options.dir) {
+                await removeDir(options.dir);
             }
         }
-    };
+        else {
+            await Promise.all(targets.map(removeDir));
+        }
+    }
     async function removeDir(dir) {
         const normalizedDir = normalizeSlash(path.normalize(dir));
-        if (runOnce && deleted.has(normalizedDir)) {
-            return;
+        if (deleteOnce && deleted.has(normalizedDir)) {
+            return deleted.get(normalizedDir);
         }
-        deleted.add(normalizedDir);
+        const removePromise = doRemove(normalizedDir);
+        deleted.set(normalizedDir, removePromise);
+        return removePromise;
+    }
+    async function doRemove(normalizedDir) {
         const logger = createLogger(pluginName);
         try {
             logger.start(`cleaning '${normalizedDir}'`, verbose ? 1 /* info */ : 0 /* verbose */);
@@ -47,6 +68,29 @@ function normalizeSlash(dir) {
         return `${dir.substring(0, dir.length - 1)}`;
     }
     return dir;
+}
+function normalizeOptions(userOptions) {
+    var _a, _b, _c, _d;
+    const options = {
+        pluginName: (_a = userOptions.pluginName) !== null && _a !== void 0 ? _a : '@rollup-extras/plugin-clean',
+        deleteOnce: (_b = userOptions.deleteOnce) !== null && _b !== void 0 ? _b : true,
+        verbose: (_c = userOptions.verbose) !== null && _c !== void 0 ? _c : false,
+        outputPlugin: (_d = userOptions.outputPlugin) !== null && _d !== void 0 ? _d : true,
+        targets: getTargets(userOptions)
+    };
+    return options;
+}
+function getTargets(userOptions) {
+    if (typeof userOptions === 'string') {
+        return [userOptions];
+    }
+    if (Array.isArray(userOptions)) {
+        return userOptions;
+    }
+    if (typeof userOptions === 'object') {
+        return 'targets' in userOptions ? getTargets(userOptions.targets) : undefined;
+    }
+    return [];
 }
 
 export { index as default };

package/dist/types.d.ts

@@ -1,6 +1,7 @@
 export declare type CleanPluginOptions = {
     targets?: string | string[];
     pluginName?: string;
-    runOnce?: boolean;
+    deleteOnce?: boolean;
+    outputPlugin?: boolean;
     verbose?: boolean;
-};
+} | string | string[];

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.1",
+  "version": "1.0.2",
   "license": "MIT",
   "name": "@rollup-extras/plugin-clean",
   "author": {