Version 4.0.2 release notes.

Fixes #874 - regression in at-rule tokenization.

Why:

* Another case after #872 where at-rules were incorrectly
  tokenized because `propertyToken` wasn't reset.

Bumps web interface to version 4.0.1.

Version 4.0.1 release notes.

See #872 - two additional cases.

Unrelated to the ticket but should still be handled correctly.

Fixes #872 - edge case in tokenization.

Why:

* On closing curly brace `}` both `ruleToken` and `propertyToken`
  should be nullified to prevent incorrect property assignments.

Fixes #868 - accept absolute paths in input hash.

Thanks to @madwizard-thomas for bug investigation which turned
out to be correct.

Why:

* Internally all local URIs should be represented as relative
  paths normalized to *nix format so nothing else gets propagated
  to output styles or source maps;
* all remote URIs are kept as is.

Fixes #867 - skips optimizing variable values.

Why:

* It may not be the best idea as we don't know what a value
  represents and where it'll end up.

Fixes #866 - edge case in `inline` flag handling.

Why:

* When reverse order of options was used, so `remote,local`,
  a resource was incorrectly marked as not allowed;
* apparently we should always default remote URLs to disallowed,
  while local ones should be allowed by default.

chore(package): update browserify to version 14.0.0 (#871)

https://greenkeeper.io/

Re-enables batch tests on Windows. (#869)

Fix up assertEqualLineByLine(), checks if number of lines are equal before verifying content.

See #858 - updates web interface for clean-css 4.

Why:

* 4.0 changes lots of options and web users should still be able to
  apply all of them.

Version 4.0.0.

Updates acknowledgements section.

Thanks @alexlamsl, @ben-eb, @madwizard-thomas, and @ngyikp.

See #864 - adds better docs for optimization levels.

It's not obvious if level 2 is used that level 1 is on by
default, and that both configurations can be applied
at the same time.

Re-enables protocol tests on Windows.

Thanks to @alexlamsl for bringing it up and testing.

Why:

* Disabled as they errored on Windows in the past, but they seem to
  work fine now.

Reworks Readme to be more readable.

Why:

* Provides Table of contents at the top with quick links to
  interesting sections;
* Provides detailed description of available options with examples;
* Provides a FAQ section with various usage scenarios.

See #846 - moves CLI to a separate repository.

Moved to https://github.com/jakubpawlowicz/clean-css-cli

Why:

* At least 85% of top dependants use the API (see ticket) so
  removing CLI removes `commander` dependency for them;
* docs will be easier to follow as they describe API only;
* tests run 10x as fast since binary tests took 90% of time;
* CLI will be able to provide its own set of features which
  are not necessarilly provided or requred in API.

Drawbacks:

* It won't be straightforward to quickly test arbitrary CSS
  as binary is not available out of the box.

Cleans up serializer code.

Why:

* Makes serialization context always the first argument;
* renamed function names for better clarity.

Renames 'star' to 'asterisk'.

Why:

* This is the character's name.

Renames curly bracket constants.

Why:

* To match other bracket constants.

Renames `Token.BLOCK` to `Token.NESTED_BLOCK`.

Why:

* All CSS blocks can be nested so this name reflects
  this rule better.

Simplifies `split` helper code.

Why:

* Much of its complexity was due to old tokenizer which is no more;
* currently it serves as a way to splitting strings where commas
  inside round brackets are ignored.

Bumps copyright timestamps to 2017.

Fixes linting warning in specificity module.

Moves API options setup to `options` folder-space.

Why:

* So it lives alongside optimization level and formatting setup.

Bumps online version to clean-css 3.4.24.

Version 3.4.24 release notes.

Fixes #859 - avoids `-webkit-border-radius` optimizations.

Why:

* Apparently it doesn't support shortening 4 values to 2, as the
  latter is taken as a horizontal + vertical radius in all corners;
* disabling any optimizations as a precaution;
* see http://jsfiddle.net/qnGKj/2881/

See #856 - adds missing History.md entry.

Fixes #863 - adds `transform` callback for custom optimizations.

Why:

* So users can apply custom optimizations without forking clean-css
  and learning how to plug such optimization in;
* may also aid in rewriting URLs after introduction of `rebaseTo`.

Fixes #856 - allows `minify` to return a promise.

Why:

* Useful as an alternative to callback API;
* future Node.js versions will support `await` mechanism
  which requires supporting promises.

Adds `overrideProperties` level 2 optimizations flag.

Why:

* Previously property overriding was controlled via `mergeIntoShorthands`
  flag which was confusing.

Moves 'compacting' code to 'properties' folder-space.

Why:

* All those optimizations are dealing with properties so the new
  name better reflects its role;

Also:

* renames `overrideCompactor` to `overrideProperties`;
* renames `compactorOptimize` to `optimizeProperties`.
* cleans up property optimizing code calling from level 2 optimizations
  due to removal of aggressive merging, see #290.

Renames `compactShorthands` level 2 option to `mergeIntoShorthands`.

Why:

* It better describes what this option does.

Makes compactable code more explicit.

Why:

* All unprefixed properties has to be declared explicitely,
  while vendor prefixed ones can be generated from them.

See #290 - adds removing IE filters.

Why:

* Internet Explorer `filter` / `-ms-filter` are unsupported since
  IE 10, which is also clean-css new default compatibility;
* can be restored by using `ie7`, `ie8`, or `ie9` compatibility
  modes.

See #290 - removes aggressive merging.

Why:

* Aggressive merging was replaced by override merging;
* it supports much more properties now so aggressive merging won't
  be missed;
* it also overrides based on understandability not merely a
  position in output file.

Side notes:

* This is a safe change as if a property is not configured to
  be overridable it won't be;
* overhauls `canOverride` functionality to prevent features like
  vendor prefixes or variables from overriding widely supported
  values;
* overhauls validating values by allowing known values, which
  strictly doesn't make it a full validator but rather a way
  of telling if a value *may* be valid.

See #290 - reworks `border` overriding.

Why:

* Border is a complex case where both `border` and all its
  components: `border-color`, `border-style`, and `border-width`
  are components. Also `border-(bottom|left|right|top)` are
  shorthands too.
* this commit restores aggressive merging shorthand overriding right
  inside shorthand compacting code.

See #290 - disables `font` shorthand overriding.

Why:

* It's a shorthand property, so not straightforward to implement
  in shorthand/override compacting;
* pending in #254.

See #290 - disables `transition` shorthand overriding.

Why:

* It's a shorthand property, so not straightforward to implement
  in shorthand/override compacting;
* pending in #861.

See #290 - disables `animation` shorthand overriding.

Why:

* It's a shorthand property, so not straightforward to implement
  in shorthand/override compacting;
* pending in #860.

See #857 - removes redundant source map code.

Thanks to @alexlamsl for spotting it.

Why:

* Tracking input source map is done in #minify method already.

Fixes #857 - normalizes CleanCSS API interface.

Why:

* `sourceMap` option has to be a boolean now;
* input source map can be passed as a 2nd argument to `minify`
  method, making callback a 3rd;
* all other options are stateless so should be the `sourceMap`.

Refactors validator into a set of functions.

Why:

* There's no need to keep it as an object, since configuration
  can also be passed in.

See #799 - speeds up serializing code.

Why:

* Instead of using an `if` branch implements wrapping and tracking
  as a callback with `no-op` implementation when wrapping is disabled.

See #799 - adds an option to wrap output at arbitrary column.

Why:

* As not all clients (i.e. email clients) like CSS in one line.

See #799 - changes formatting defaults.

Why:

* When formatting is turned on it defaults to no formatting, so
  any options need to be applied on top of these;
* adds `beautify` preset for the previous default, e.g.
  `cleancss --format beautify one.css`.

See #799 - renames `beautify` option to `format`.

Why:

* It makes more sense as it controls formatting in general;
* see #209 where `beautify` was introduced.

See #799 - adds granular formatting options.

Why:

* To allow better control over how output is formatted;
* also gets rid of `keepBreaks` option in favor to
  `{ beautify: 'keep-breaks' }` shortcut.

See #773 - speeds up specificity lookup.

Why:

* Calculating it is slow, but, since it's done repeatedly for
  the same selectors, it can be cached quite effectively.

Fixes #773 - adds reordering based on selector specificity.

Why:

* Rules with different specificity can be safely reordered as those
  with higher value will always override those with lower;
* there is no way to determine whether the latter can be ignored
  because HTML context is not known;
* this is a level 2 optimization which are off by default.

See #425 - nitpicking natural sorting algorithm.

Thanks to @alexlamsl for spotting these.

Fixes #425 - enables natural method of sorting selectors.

Still defaults to standard sorting but natural becomes
a new option. Controlled via `selectorsSortingMethod`
option in level 1 optimizations.

Why:

* Natural way could be a more compression-efficient way;
* it's easier to read for a human.

See #425 - adds natural sorting algorithm.

Why:

* We need it to sort selectors accordingly.

Always run CI on Node.js 7 too.

At this moment it's a current version of Node.js so it'd be good
to run tests on it.

See: https://github.com/nodejs/LTS

Fixes #853 - renames level 2 options.

Why:

* To match level 1 wording which feels more natural.

Restores proper multiple level handling in CLI.

Why:

* Apparently the earlier change to a single dash option
  broke using multiple optimization levels at once.
  This commit restores it.

Adds examples of `all` keyword in level 1/2 optimizations.

Why:

* So the option is documented properly.

Allows `all` shortcut in level 1 optimizations config.

Why:

* To enable/disable all options at once;
* note non-boolean options are ignored when `all` / `*` is used.

Inverts some level 1 options for consistency.

@alexlamsl made a good point that when we have `all` shortcut,
to set all options at once, it'd be good if value given would
mean the same to all options.

Adds granular control over level 1 optimizations.

Why:

* So users can turn them on/off selectively;
* still keeping sane defaults for most users.

Note: moves `properties.fontWeight` compatibility flag to level 1
optimizations as that's not a compatibility flag, but rather a
user preference - see #756.

Renames level 1 optimizations test file.

Reorganizes level 1 optimizations.

Why:

* Slightly more coherent now, will get more love in 4.1.

See #731 - adds granular control over level 2 optimizations.

Why:

* So users can selectively disable certain optimizations if they
  want to.

Runs benchmark on each optimization level.

See #791 - normalizes stored paths.

Stores all paths internally as normalized to *nix format but
still outputs Windows friendly paths if needed.

`source-map` does it internally so there's no need to transform
paths in source maps.

Reorganizes optimizer around levels.

Why:

* Gets rid of the flat structure where levels' code was mixed;
* moves level 2 compacting into a namespace (folderspace?).

See #807 - disables restructuring optimizations.

Can be brought back with:

* `{ level: { 2: { restructuring: true } } }` in API;
* `-O2 restructuring:on` in CLI.

Why:

* Those can be slow on big files;
* Need further optimizations and code cleanup, see #533.

See #842 - removes HTML comments from selectors.

Kudos to @alexlamsl for the fix.

Why:

* Apparently anything wrapped between HTML comments still gets
  processed by browsers.

See #850 - restores `-On` CLI option.

Thanks @alexlamsl for figuring it out!

Fixes #717 - makes level 1 optimizations default.

Why:

* This way is safer for end user;
* Leaves level 2 optimizations up to end user to test and decide if
  the end result is good enough.

Fixes #836 - enables level `0` optimizations.

Why:

* Some people may need to bundle and rebase CSS without applying
  any optimizations.

See #850 - allows `on` or `off` as level option values.

Why:

* In CLI mode it makes more sense to use these instead of `true`
  or `false` as in API (JavaScript) context.

See #850 - cleans up optimization level code.

Why:

* For better readability.

See #850 - allows overriding all options.

Why:

* Use `all` or `*` to reset all options to a given value.

Example:

```js
new CleanCSS({
  level: {
    2: {
      all: false,
      mediaMerging: true
    }
  }
});
```

Fixes #850 - implements optimization levels.

Why:

* To logically split optimizations into three groups - level 0
  (not implemented yet), level 1, and level 2 (default);
* To allow more fine-grained control over what's optimized on
  each level (pending);
* To have a future-proof way of setting it for both API & CLI.

Removes `benchmark` API option.

Why:

* total time is reported under `stats`;
* it was seriously impaired since optimizing got encapsulated
  and not invoked directly from lib/clean.js.

Fixed #828 - `-chrome-` hack support.

Why:

* It was incorrectly handled by property extractor.

Fixes #460 - unescaped semicolon in selector.

Why:

* Such rules should be dropped. Warnings are already in place.

Fixes #806 - skip optimizing variable properties.

Why:

* So far it's impossible to find out real property values so
  breaking up shorthands into components doesn't work.
* In theory one could optimize cases where all component values
  are given and one of them is a variable, but it's an additional
  complexity probably not worth the hassle.

See #796 - adds missing History.md entry.

Reuses `rulesOverlap` helper.

Why:

* It's used in more than one place and the code was not reused.

Fixes #796 - enables semantic merging for `@media` blocks.

* It's off by default and can be enabled via `semanticMerging` flag;
* Handles all cases and BEM classes.

See #689 - fixes regression in parsing property blocks.

Why:

* New tokenizer introduced an issue where a semicolon ending a
  property block was handled incorrectly.

Fixes a bug ignoring incorrect properties in complex restructuring.

Why:

* Apparently there was a wrong value returned from sorting callback
  which only manifested in complex stylesheets being restructured.

See #290 - allows `font-weight` overriding.

Why:

* Another step to move away from aggressive merging.

See #290 - allows `height` overriding.

Why:

* Another step to move away from aggressive merging.

Fixes #750 - allows `width` overriding.

Why:

* Width can be overriden easily using `unit` overrider.

See #829 - another performance optimization.

Why:

* Well, if a selector doesn't have a colon there is no point
  looking for any pseudo classes/elements.

See #829 - fixes a typo in method name.

See #829 - some performance tweaks.

Why:

* Uses flat loops instead of callbacks;
* Checks for number of matches before invoking costly calculations.

Fixes #829 - adds more strict selector merging rules.

Why:

* Instead of blacklisting unmergeable selectors we're now
  whitelisting the valid ones and reject all other.

Fixes #739 - error when a closing brace is missing.

Why:

* When such content gets parsed into a block we should ignore
  the whole declaration as browsers do.

See #703 - adds `ie11` alias to default compatibility.

See #703 - re-enables `background` longhand merging.

Why:

* See #577 and #579 - these two clearly state the issue is about
  IE8 not IE9+, and according to tests and caniuse.com tables
  using `background-(clip|origin|size)` in `background` shorthand
  is supported on IE9+;
* At this point I have no idea why it was disabled at the time.
  One idea is that it was disabled because IE9 doesn't support
  `properties.spaceAfterClosingBrace` and these two issues
  overlappedi at the time of 3.2 branch. (both were "fixed" in 3.3);
* Let's enable it again, since the default mode is now IE10+.

** Important note **: Safari <7 and Android stock browser <4.4
does not support it either so you'll likely have to disable if
you still support those. Just use `--compatibility ie8` to do so.

Test case: https://jsfiddle.net/7zLwv7o0/5/

See #703 - adds `ie10` alias to default compatibility.

See #703 - changes default compatibility to IE10+.

Why:

* It's high time to move it up as IE9 is relatively old now.
* Adds `ie9` compatibility mode to make it easy to go back
  to 3.x default.

Simplifies compatibility mode definitions.

Why:

* Using inheritance it's clear which properties change.

Fixes #785 - adds `@font-face` de-duplication.

Why:

* Extra `@font-face` rules can be safely removed.
* There's no API/CLI switch to turn it off as it's pending
  a refactoring in v4 - see #842.