FullHuman/purgecss
### [`v3.0.0`](https://togithub.com/FullHuman/purgecss/releases/v3.0.0)
[Compare Source](https://togithub.com/FullHuman/purgecss/compare/v2.3.0...v3.0.0)
#### 3.0.0
##### Simplifying whitelist option
Whitelist started as a simple option named `whitelist` but grew up with the different use-cases and needs that appear with time. Another option called `whitelistPatterns` appeared, then `whitelistPatternsChildren`, …
It is now more complex and complicated, and somewhat difficult to remember how to use it with different options.
To summarize the changes, the whitelist options are now grouped in one option called safelist. And the most used options can be defined in one array.
Two forms are available. The simple form is:
```ts
safelist: ['invisibleClass', /^nav-/]
```
In this form, safelist is an array that can take a string or a regex.
The complex form is:
```ts
safelist: {
standard: ['invisibleClass', /^nav-/],
deep: [],
greedy: [],
keyframes: [],
variables: []
}
```
In this form, safelist is an object taking optional properties:
standard is the same as the simple form and replaces `whitelist` and whitelistPatterns
deep replaces whitelistPatternsChildren
greedy is a new option coming from [#424](https://togithub.com/FullHuman/purgecss/pull/424)
keyframes can be used to add keyframes to the safelist, when using keyframes: true ([#418](https://togithub.com/FullHuman/purgecss/issues/418))
variables can be used to add CSS variables to the safelist, when using variables: true
##### New Option: Blocklist
Blocklist will block the CSS selectors from appearing in the final output CSS. The selectors will be removed even when they are seen as used by PurgeCSS.
blocklist: ['usedClass', /^nav-/]
Even if `nav-links` and `usedClass` are found in your content files (HTML, Javascript), they will be removed.
##### CLI
PurgeCSS is using commander.js for its CLI. The recent version of commander.js introduced the possibility of making an option variadic. This means when specifying multiple option arguments, the parsed option value will be an array.
A few options are now taking advantage of this new feature: content, css, and the newly introduced option safelist and blocklist. It is no longer necessary to separate the list items with a comma.
##### From changelog:
- **CLI:** add blocklist option ([3961afb](https://togithub.com/FullHuman/purgecss/commit/3961afbc6d90eae83fe4862a4498857fa7ba3ff6))
- add blocklist option ([04223f7](https://togithub.com/FullHuman/purgecss/commit/04223f7fe27f8d818961a53900a7c5293d2322b6))
- add safelist option, replace whitelist
- add safelist keyframes and css variables ([dc59d30](https://togithub.com/FullHuman/purgecss/commit/dc59d309a4a4be9845c40966a19f9705c42a33a1)), closes [#418](https://togithub.com/FullHuman/purgecss/issues/418) [#439](https://togithub.com/FullHuman/purgecss/issues/439)
### [`v2.3.0`](https://togithub.com/FullHuman/purgecss/compare/v2.2.0...v2.3.0)
[Compare Source](https://togithub.com/FullHuman/purgecss/compare/v2.2.0...v2.3.0)
### [`v2.2.0`](https://togithub.com/FullHuman/purgecss/compare/v2.1.2...v2.2.0)
[Compare Source](https://togithub.com/FullHuman/purgecss/compare/v2.1.2...v2.2.0)
### [`v2.1.2`](https://togithub.com/FullHuman/purgecss/compare/v2.1.0...v2.1.2)
[Compare Source](https://togithub.com/FullHuman/purgecss/compare/v2.1.0...v2.1.2)
### [`v2.1.0`](https://togithub.com/FullHuman/purgecss/compare/v2.0.6...v2.1.0)
[Compare Source](https://togithub.com/FullHuman/purgecss/compare/v2.0.6...v2.1.0)
### [`v2.0.6`](https://togithub.com/FullHuman/purgecss/compare/v2.0.5...v2.0.6)
[Compare Source](https://togithub.com/FullHuman/purgecss/compare/v2.0.5...v2.0.6)
### [`v2.0.5`](https://togithub.com/FullHuman/purgecss/releases/v2.0.5)
[Compare Source](https://togithub.com/FullHuman/purgecss/compare/v2.0.4...v2.0.5)
Changes:
- Asynchronous
```js
import PurgeCSS from "purgecss";
const purgecssResults = await new PurgeCSS().purge({
// options
});
```
- Extractor is a function
```js
content => content.match(/[\w-/:]+(?
Renovate configuration
:date: Schedule: "after 1am and before 2am,after 7am and before 8am,after 1pm,after 7pm,before 2am,before 8am" in timezone Europe/Paris.
:vertical_traffic_light: Automerge: Disabled by config. Please merge this manually once you are satisfied.
:recycle: Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.
:no_bell: Ignore: Close this PR and you won't be reminded about this update again.
[x] If you want to rebase/retry this PR, check this box
This PR contains the following updates:
1.3.0->3.0.0Release Notes
FullHuman/purgecss
### [`v3.0.0`](https://togithub.com/FullHuman/purgecss/releases/v3.0.0) [Compare Source](https://togithub.com/FullHuman/purgecss/compare/v2.3.0...v3.0.0) #### 3.0.0 ##### Simplifying whitelist option Whitelist started as a simple option named `whitelist` but grew up with the different use-cases and needs that appear with time. Another option called `whitelistPatterns` appeared, then `whitelistPatternsChildren`, … It is now more complex and complicated, and somewhat difficult to remember how to use it with different options. To summarize the changes, the whitelist options are now grouped in one option called safelist. And the most used options can be defined in one array. Two forms are available. The simple form is: ```ts safelist: ['invisibleClass', /^nav-/] ``` In this form, safelist is an array that can take a string or a regex. The complex form is: ```ts safelist: { standard: ['invisibleClass', /^nav-/], deep: [], greedy: [], keyframes: [], variables: [] } ``` In this form, safelist is an object taking optional properties: standard is the same as the simple form and replaces `whitelist` and whitelistPatterns deep replaces whitelistPatternsChildren greedy is a new option coming from [#424](https://togithub.com/FullHuman/purgecss/pull/424) keyframes can be used to add keyframes to the safelist, when using keyframes: true ([#418](https://togithub.com/FullHuman/purgecss/issues/418)) variables can be used to add CSS variables to the safelist, when using variables: true ##### New Option: Blocklist Blocklist will block the CSS selectors from appearing in the final output CSS. The selectors will be removed even when they are seen as used by PurgeCSS. blocklist: ['usedClass', /^nav-/] Even if `nav-links` and `usedClass` are found in your content files (HTML, Javascript), they will be removed. ##### CLI PurgeCSS is using commander.js for its CLI. The recent version of commander.js introduced the possibility of making an option variadic. This means when specifying multiple option arguments, the parsed option value will be an array. A few options are now taking advantage of this new feature: content, css, and the newly introduced option safelist and blocklist. It is no longer necessary to separate the list items with a comma. ##### From changelog: - **CLI:** add blocklist option ([3961afb](https://togithub.com/FullHuman/purgecss/commit/3961afbc6d90eae83fe4862a4498857fa7ba3ff6)) - add blocklist option ([04223f7](https://togithub.com/FullHuman/purgecss/commit/04223f7fe27f8d818961a53900a7c5293d2322b6)) - add safelist option, replace whitelist - add safelist keyframes and css variables ([dc59d30](https://togithub.com/FullHuman/purgecss/commit/dc59d309a4a4be9845c40966a19f9705c42a33a1)), closes [#418](https://togithub.com/FullHuman/purgecss/issues/418) [#439](https://togithub.com/FullHuman/purgecss/issues/439) ### [`v2.3.0`](https://togithub.com/FullHuman/purgecss/compare/v2.2.0...v2.3.0) [Compare Source](https://togithub.com/FullHuman/purgecss/compare/v2.2.0...v2.3.0) ### [`v2.2.0`](https://togithub.com/FullHuman/purgecss/compare/v2.1.2...v2.2.0) [Compare Source](https://togithub.com/FullHuman/purgecss/compare/v2.1.2...v2.2.0) ### [`v2.1.2`](https://togithub.com/FullHuman/purgecss/compare/v2.1.0...v2.1.2) [Compare Source](https://togithub.com/FullHuman/purgecss/compare/v2.1.0...v2.1.2) ### [`v2.1.0`](https://togithub.com/FullHuman/purgecss/compare/v2.0.6...v2.1.0) [Compare Source](https://togithub.com/FullHuman/purgecss/compare/v2.0.6...v2.1.0) ### [`v2.0.6`](https://togithub.com/FullHuman/purgecss/compare/v2.0.5...v2.0.6) [Compare Source](https://togithub.com/FullHuman/purgecss/compare/v2.0.5...v2.0.6) ### [`v2.0.5`](https://togithub.com/FullHuman/purgecss/releases/v2.0.5) [Compare Source](https://togithub.com/FullHuman/purgecss/compare/v2.0.4...v2.0.5) Changes: - Asynchronous ```js import PurgeCSS from "purgecss"; const purgecssResults = await new PurgeCSS().purge({ // options }); ``` - Extractor is a function ```js content => content.match(/[\w-/:]+(?Renovate configuration
:date: Schedule: "after 1am and before 2am,after 7am and before 8am,after 1pm,after 7pm,before 2am,before 8am" in timezone Europe/Paris.
:vertical_traffic_light: Automerge: Disabled by config. Please merge this manually once you are satisfied.
:recycle: Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.
:no_bell: Ignore: Close this PR and you won't be reminded about this update again.
This PR has been generated by WhiteSource Renovate. View repository job log here.