npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

rollup-plugin-cleanup

v3.2.1

Published

Rollup plugin to trim trailing spaces, compact empty lines, and normalize line endings

Downloads

284,789

Readme

rollup-plugin-cleanup

npm Version License AppVeyor Status Travis Status Maintainability Coverage

Rollup plugin to remove comments, trim trailing spaces, compact empty lines, and normalize line endings in JavaScript files.

With the rollup-plugin-cleanup you have:

  • Compaction of empty lines within multiline comments and/or out of them.
  • Normalization of line endings to Unix, Mac, or Windows.
  • Removal of JavaScript comments through powerful, configurable filters.
  • Removal of trailing whitespace of each line.
  • TypeScript definitions.
  • Sourcemap support.

From v3.1, this plugin no longer uses acorn. See more in the Whats New section.

rollup-plugin-cleanup requires node v10.13 or above, but avoid the buggy v11.x

Important:

rollup-plugin-cleanup is based on js-cleanup and can handle any JS-like file: TypeScript, Flow, React, ES9, etc, but it is mainly a postprocessor, so it should be runned in a later stage of your toolchain, after any preprocessor or transpiler.

Why not Uglify?

Uglify is a excelent minifier but you have little control over the results, while with js-cleanup your coding style remains intact and the removal of comments is strictly under your control.

Support my Work

I'm a full-stack developer with more than 20 year of experience and I try to share most of my work for free and help others, but this takes a significant amount of time and effort so, if you like my work, please consider...

Of course, feedback, PRs, and stars are also welcome 🙃

Thanks!

Install

npm install rollup-plugin-cleanup --save-dev
# or with yarn
yarn add rollup-plugin-cleanup -D

Usage

import { rollup } from 'rollup';
import awesome from 'rollup-plugin-awesome';
import cleanup from 'rollup-plugin-cleanup';

rollup({
  input: 'src/main.js',
  plugins: [
    awesome(),        // other plugins
    cleanup()         // cleanup here
  ]
}).then(...)

That's it.

By default, only the .js, .jsx, and .tag files are processed, but you can expand or restrict the set of accepted files using the options include, exclude, and extensions (see below).

Options

From v3.1.0 normalizeEols is deprecated in favor of lineEndings and the properties ecmaVersion, sourceType, and acornOptions are ignored. See more in Whats New section.

| Name | Default | Description | |-----------------|----------|-------------| | comments | 'some' | Filter or array of filters that determinates which comments should be preserved.Use "all" to keep all, or "none" to remove all the comments. | | compactComments | true | Should js-cleanup also compact whitespace and blank lines in the preserved multiline comments?Line-ending normalization is always done. | | lineEndings | unix | Type of Line-ending for normalization: "unix", "mac", "win". | | maxEmptyLines | 0 | Maximum successive empty lines to preserve in the output.Use a positive value, or -1 to keep all the lines. | | sourcemap | true | Should a sourcemap be generated? | | extensions | ['js', 'jsx', 'mjs'] | String or array of strings with extensions of files to process. | | exclude | (none) | picomatch or array of picomatch patterns for paths to exclude of the process. | | include | (none) | picomatch or array of picomatch patterns for paths to include in the process. |

Predefined Comment Filters

Instead the special 'all' or 'none' keywords, you can use any combination of custom filters along with any of these predefined ones:

Name | Will preserve... -------- | ----------------- some | Comments containing "@license", "@preserve", or starting with "!". license | Comments containing "@license". eslint | ESLint directives. flow | Facebook Flow directives, comment types, and flowlint comments. istanbul | istanbul ignore comments. jsdoc | JSDoc comments. jshint | JSHint directives. jslint | JSLint directives. sources | Sourcemap directives sourceURL and sourceMappingURL. ts | MS TypeScript Triple-Slash and @ts-* directives, plus the @jsx pragma. ts3s | TypeScript Triple-Slash directives.

From v3.1.0, some does not includes '@cc_on' and the jscs filter was deprecated. See more in Whats New section.

'srcmaps' will be preserved as an alias to the 'sources' filter.

See the regexes in the js-cleanup src/predef-filters.ts file.

Custom Filters

You can set custom filters through regexes that matches the content of the comments that you want to preserve.

The string to which the regex is applied does not includes the first slash, nor the */ terminator of the multiline comments, so the multiline comments begins with an asterisk (*) and single-line comments begins with a slash (/).

For example, the following filters will preserve ESLint directives and multiline comments starting with a dash:

const cleanedCode = jsCleanup(code, null, { comments: ['eslint', /^\*-/] })

What's New

Changes in v3.2.1

  • Fixed #16 ? Thanks to @Aqours, @gevalo1 & @xania for repoting this issue
  • Using js-cleanup v1.2.0 and Rollup v2.0+
  • Requires NodeJS v10.14.2 or v12.0 and above
  • Updated dependencies

License

The MIT License (MIT)

© 2018-2020 Alberto Martínez