svg/svgo (svgo)
### [`v3.3.2`](https://togithub.com/svg/svgo/releases/tag/v3.3.2)
[Compare Source](https://togithub.com/svg/svgo/compare/v3.3.1...v3.3.2)
#### Notice
An update on what happened with v3.3.0 and v3.3.1. While we have retained CJS support, the migration to EMS has changed the acceptable ways to import SVGO, in ways that users depended on before. This effectively made SVGO v3 a breaking change.
Rather than resolve or workaround these differences, we've opted to release SVGO v3.3.2, which is effectively a revert to v3.2.0, and deprecate versions v3.3.0 and v3.3.1. We'll then proceed to work on releasing v4 which will document the breaking changes, and feature further breaking changes that were slated for v4, like disabling `removeViewBox` by default.
Before the v4.0.0 release, I'll put more focus on testing and use release candidates, just to help make the release go smoothly! 👍🏽
Sorry for the headache, and thanks for your patience.
### [`v3.3.1`](https://togithub.com/svg/svgo/releases/tag/v3.3.1)
[Compare Source](https://togithub.com/svg/svgo/compare/v3.3.0...v3.3.1)
#### Notice
SVGO v3.3.0, which was meant to migrate to ESM without breaking CJS support, unfortunately broke CJS projects. There was a mistake with exports, so the `loadConfig` function wasn't available in the CJS bundle and lead to issues for many users.
Thanks to everyone who raised the issue, and to [@nuintun](https://togithub.com/nuintun) who submitted a pull request to resolve it so quickly.
I apologize for letting that breaking change through, and will aim to do better. Namely, by adding more tests to cover our exports, and any other public interface in general for each distribution of SVGO, so this doesn't happen again.
SVGO v3.3.1 should resolve the issue for CJS projects, but if you encounter anything else, do let us know by opening an issue on GitHub.
### [`v3.3.0`](https://togithub.com/svg/svgo/releases/tag/v3.3.0)
[Compare Source](https://togithub.com/svg/svgo/compare/v3.2.0...v3.3.0)
#### Deprecated
This release introduced breaking changes, which have been reverted in v3.3.2. The bug fixes will be reintroduced in v4.0.0.
#### What's Changed
##### ESM
SVGO is now a dual package, serving for both Common JS and ESM usage. We believe there shouldn't be any problems, especially as SVGO as largely stateless, but feel free to open an issue if you encounter problems with this.
To be explicit, this is not a breaking change, and SVGO should continue to work in Common JS projects!
Thanks to [@jdufresne](https://togithub.com/jdufresne) for doing the bulk of the work.
##### Default Behavior
- [`convertColors`](), now converts all references to colors excluding references to IDs to lowercase. This can be disabled by setting `convertCase` to `false`.
##### Bug Fixes
- [`cleanupIds`](), treat both URI encoded and non-URI encoded IDs as the same. By [@liuweifeng](https://togithub.com/liuweifeng) in [#1982](https://togithub.com/svg/svgo/issues/1982)
- [`collapseGroups`](), check styles as well as attributes. By [@johnkenny54](https://togithub.com/johnkenny54) in [#1952](https://togithub.com/svg/svgo/issues/1952)
- [`collapseGroups`](), move attributes atomically. By [@johnkenny54](https://togithub.com/johnkenny54) in [https://github.com/svg/svgo/pull/1930](https://togithub.com/svg/svgo/pull/1930)
- [`convertPathData`](), fix q control point when item is removed. By [@KTibow](https://togithub.com/KTibow) in [https://github.com/svg/svgo/pull/1927](https://togithub.com/svg/svgo/pull/1927)
- [`convertPathData`](), preserve vertex for markers only paths. By [@SethFalco](https://togithub.com/SethFalco) in [#1967](https://togithub.com/svg/svgo/issues/1967)
- [`mergePaths`](), don't merge paths if attributes/styles depend depend on the nodes bounding box. By [@johnkenny54](https://togithub.com/johnkenny54) in [#1964](https://togithub.com/svg/svgo/issues/1964)
- [`moveElemsAttrsToGroups`](), no longer moves the transforms if group has the `filter` attribute. By [@johnkenny54](https://togithub.com/johnkenny54) in [#1933](https://togithub.com/svg/svgo/issues/1933)
- [`prefixIds`](), fixed issue where some IDs were not prefixed when style tag contained XML comments. By [@john-neptune](https://togithub.com/john-neptune) in [#1942](https://togithub.com/svg/svgo/issues/1942)
- [`removeHiddenElems`](), don't remove node if child element has a referenced ID. By [@johnkenny54](https://togithub.com/johnkenny54) in [https://github.com/svg/svgo/pull/1925](https://togithub.com/svg/svgo/pull/1925)
- [`removeHiddenElems`](), treat `path[opacity=0]` as a non-rendering node. By [@johnkenny54](https://togithub.com/johnkenny54) in [#1948](https://togithub.com/svg/svgo/issues/1948)
- [`removeUselessDefs`](https://svgo.dev/docs/plugins/remove-useless-defs/), don't remove node if child element has an ID. By [@johnkenny54](https://togithub.com/johnkenny54) in [https://github.com/svg/svgo/pull/1923](https://togithub.com/svg/svgo/pull/1923)
- When stringifying path data, include a space before numbers represented in scientific notation. By [@johnkenny54](https://togithub.com/johnkenny54) in [#1961](https://togithub.com/svg/svgo/issues/1961)
- No longer crashes when the output (`-o` argument) ends with a trailing slash to a location that didn't exist. By [@SethFalco](https://togithub.com/SethFalco) in [#1954](https://togithub.com/svg/svgo/issues/1954)
##### SVG Optimization
- [`convertColors`](), introduce parameter to convert colors to common casing (lowercase/uppercase). By [@JayLeininger](https://togithub.com/JayLeininger) in [https://github.com/svg/svgo/pull/1692](https://togithub.com/svg/svgo/pull/1692)
- [`removeDeprecatedAttrs`](), new plugin that is disabled by default to remove SVG attributes that are deprecated. By [@jdufresne](https://togithub.com/jdufresne) in [#1869](https://togithub.com/svg/svgo/issues/1869)
#### Metrics
Before and after using vectors from various sources, with the default preset of each respective version:
| SVG | Original | v3.2.0 | v3.3.0 | Delta |
|---|---|---|---|---|
| [Arch Linux Logo](https://archlinux.org/art/) | 9.529 KiB | 4.115 KiB | 4.097 KiB | ⬇️ 0.018 KiB |
| [Blobs](https://gitlab.gnome.org/GNOME/gnome-backgrounds/-/blob/main/backgrounds/blobs-d.svg) | 50.45 KiB | 42.623 KiB | 42.609 KiB | ⬇️ 0.014 KiB |
| [Isometric Madness](https://inkscape.org/~Denis_Kuznetsky/%E2%98%85isometric-madness) | 869.034 KiB | 540.582 KiB | 540.073 KiB | ⬇️ 0.509 KiB |
| [tldr-pages Banner](https://togithub.com/tldr-pages/tldr/blob/main/images/banner.svg) | 2.071 KiB | 1.07 KiB | 1.07 KiB | |
| [Wikipedia Logo](https://en.wikipedia.org/wiki/File:Wikipedia-logo-v2.svg) | 161.551 KiB | 111.668 KiB | 111.668 KiB | |
Before and after of the browser bundle of each respective version:
| | v3.2.0 | v3.3.0 | Delta |
|---|---|---|---|
| svgo.browser.js | 910.9 kB | 753.0 kB | ⬇️ 157.9 kB |
### [`v3.2.0`](https://togithub.com/svg/svgo/releases/tag/v3.2.0)
[Compare Source](https://togithub.com/svg/svgo/compare/v3.1.0...v3.2.0)
#### What's Changed
##### Bug Fixes
- [**Convert Path Commands**](https://svgo.dev/docs/plugins/convert-path-data/), fix instances were `q` was incorrectly converted to `t`. By [@KTibow](https://togithub.com/KTibow) in [https://github.com/svg/svgo/pull/1889](https://togithub.com/svg/svgo/pull/1889)
- [**Convert Transform**](https://svgo.dev/docs/plugins/convert-transform/), fix for some transforms that weren't being converted correctly. By [@SethFalco](https://togithub.com/SethFalco) in [https://github.com/svg/svgo/pull/1916](https://togithub.com/svg/svgo/pull/1916)
##### SVG Optimization
- [**Convert Path Commands**](https://svgo.dev/docs/plugins/convert-path-data/), improves closing paths and how we determine if to use absolute or relative commands. By [@KTibow](https://togithub.com/KTibow) in [https://github.com/svg/svgo/pull/1867](https://togithub.com/svg/svgo/pull/1867)
- [**Convert Path Commands**](https://svgo.dev/docs/plugins/convert-path-data/), round arc or convert to lines based on the sagitta, can be disabled by setting `smartArcRounding` to `false`. By [@KTibow](https://togithub.com/KTibow) in [https://github.com/svg/svgo/pull/1873](https://togithub.com/svg/svgo/pull/1873)
- [**Convert Path Commands**](https://svgo.dev/docs/plugins/convert-path-data/), convert cubic Bézier curves to quadratic Bézier curves where possible, can be disabled by setting `convertToQ` to `false`. By [@KTibow](https://togithub.com/KTibow) in [https://github.com/svg/svgo/pull/1889](https://togithub.com/svg/svgo/pull/1889)
##### Performance
- [**Merge Paths**](https://svgo.dev/docs/plugins/merge-paths/), refactor for performance with large files. By [@mozzie](https://togithub.com/mozzie) in [https://github.com/svg/svgo/pull/1764](https://togithub.com/svg/svgo/pull/1764) and [https://github.com/svg/svgo/pull/1904](https://togithub.com/svg/svgo/pull/1904)
- [**Convert Path Commands**](https://svgo.dev/docs/plugins/convert-path-data/), refactor `#stringifyPathData` for performance. By [@SethFalco](https://togithub.com/SethFalco) in [https://github.com/svg/svgo/pull/1900](https://togithub.com/svg/svgo/pull/1900)
- Use [`Set`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Set) instead of [`Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array) for faster lookups. By [@SethFalco](https://togithub.com/SethFalco) in [https://github.com/svg/svgo/pull/1899](https://togithub.com/svg/svgo/pull/1899)
#### Metrics
Before and after using vectors from various sources, with the default preset of each respective version:
| SVG | Original | v3.1.0 | v3.2.0 | Delta |
|---|---|---|---|---|
| [Arch Linux Logo](https://archlinux.org/art/) | 9.529 KiB | 4.162 KiB | 4.115 KiB | ⬇️ 0.047 KiB |
| [Blobs](https://gitlab.gnome.org/GNOME/gnome-backgrounds/-/blob/main/backgrounds/blobs-d.svg) | 50.45 KiB | 42.949 KiB | 42.623 KiB | ⬇️ 0.326 KiB |
| [Isometric Madness](https://inkscape.org/~Denis_Kuznetsky/%E2%98%85isometric-madness) | 869.034 KiB | 550.153 KiB | 540.582 KiB | ⬇️ 9.571 KiB |
| [tldr-pages Banner](https://togithub.com/tldr-pages/tldr/blob/main/images/banner.svg) | 2.071 KiB | 1.07 KiB | 1.07 KiB | |
| [Wikipedia Logo](https://en.wikipedia.org/wiki/File:Wikipedia-logo-v2.svg) | 161.551 KiB | 116 KiB | 111.668 KiB | ⬇️ 4.332 KiB |
Before and after of the browser bundle of each respective version:
| | v3.1.0 | v3.2.0 | Delta |
|---|---|---|---|
| svgo.browser.js | 660.9 kB | 910.9 kB | ⬆️ 250 kB |
### [`v3.1.0`](https://togithub.com/svg/svgo/releases/tag/v3.1.0)
[Compare Source](https://togithub.com/svg/svgo/compare/v3.0.5...v3.1.0)
#### What's Changed
##### Bug Fixes
- [**Prefix IDs**](https://svgo.dev/docs/plugins/prefix-ids/), correctly prefix IDs when `
This PR contains the following updates:
3.0.2->3.3.2Release Notes
svg/svgo (svgo)
### [`v3.3.2`](https://togithub.com/svg/svgo/releases/tag/v3.3.2) [Compare Source](https://togithub.com/svg/svgo/compare/v3.3.1...v3.3.2) #### Notice An update on what happened with v3.3.0 and v3.3.1. While we have retained CJS support, the migration to EMS has changed the acceptable ways to import SVGO, in ways that users depended on before. This effectively made SVGO v3 a breaking change. Rather than resolve or workaround these differences, we've opted to release SVGO v3.3.2, which is effectively a revert to v3.2.0, and deprecate versions v3.3.0 and v3.3.1. We'll then proceed to work on releasing v4 which will document the breaking changes, and feature further breaking changes that were slated for v4, like disabling `removeViewBox` by default. Before the v4.0.0 release, I'll put more focus on testing and use release candidates, just to help make the release go smoothly! 👍🏽 Sorry for the headache, and thanks for your patience. ### [`v3.3.1`](https://togithub.com/svg/svgo/releases/tag/v3.3.1) [Compare Source](https://togithub.com/svg/svgo/compare/v3.3.0...v3.3.1) #### Notice SVGO v3.3.0, which was meant to migrate to ESM without breaking CJS support, unfortunately broke CJS projects. There was a mistake with exports, so the `loadConfig` function wasn't available in the CJS bundle and lead to issues for many users. Thanks to everyone who raised the issue, and to [@nuintun](https://togithub.com/nuintun) who submitted a pull request to resolve it so quickly. I apologize for letting that breaking change through, and will aim to do better. Namely, by adding more tests to cover our exports, and any other public interface in general for each distribution of SVGO, so this doesn't happen again. SVGO v3.3.1 should resolve the issue for CJS projects, but if you encounter anything else, do let us know by opening an issue on GitHub. ### [`v3.3.0`](https://togithub.com/svg/svgo/releases/tag/v3.3.0) [Compare Source](https://togithub.com/svg/svgo/compare/v3.2.0...v3.3.0) #### Deprecated This release introduced breaking changes, which have been reverted in v3.3.2. The bug fixes will be reintroduced in v4.0.0. #### What's Changed ##### ESM SVGO is now a dual package, serving for both Common JS and ESM usage. We believe there shouldn't be any problems, especially as SVGO as largely stateless, but feel free to open an issue if you encounter problems with this. To be explicit, this is not a breaking change, and SVGO should continue to work in Common JS projects! Thanks to [@jdufresne](https://togithub.com/jdufresne) for doing the bulk of the work. ##### Default Behavior - [`convertColors`](), now converts all references to colors excluding references to IDs to lowercase. This can be disabled by setting `convertCase` to `false`. ##### Bug Fixes - [`cleanupIds`](), treat both URI encoded and non-URI encoded IDs as the same. By [@liuweifeng](https://togithub.com/liuweifeng) in [#1982](https://togithub.com/svg/svgo/issues/1982) - [`collapseGroups`](), check styles as well as attributes. By [@johnkenny54](https://togithub.com/johnkenny54) in [#1952](https://togithub.com/svg/svgo/issues/1952) - [`collapseGroups`](), move attributes atomically. By [@johnkenny54](https://togithub.com/johnkenny54) in [https://github.com/svg/svgo/pull/1930](https://togithub.com/svg/svgo/pull/1930) - [`convertPathData`](), fix q control point when item is removed. By [@KTibow](https://togithub.com/KTibow) in [https://github.com/svg/svgo/pull/1927](https://togithub.com/svg/svgo/pull/1927) - [`convertPathData`](), preserve vertex for markers only paths. By [@SethFalco](https://togithub.com/SethFalco) in [#1967](https://togithub.com/svg/svgo/issues/1967) - [`mergePaths`](), don't merge paths if attributes/styles depend depend on the nodes bounding box. By [@johnkenny54](https://togithub.com/johnkenny54) in [#1964](https://togithub.com/svg/svgo/issues/1964) - [`moveElemsAttrsToGroups`](), no longer moves the transforms if group has the `filter` attribute. By [@johnkenny54](https://togithub.com/johnkenny54) in [#1933](https://togithub.com/svg/svgo/issues/1933) - [`prefixIds`](), fixed issue where some IDs were not prefixed when style tag contained XML comments. By [@john-neptune](https://togithub.com/john-neptune) in [#1942](https://togithub.com/svg/svgo/issues/1942) - [`removeHiddenElems`](), don't remove node if child element has a referenced ID. By [@johnkenny54](https://togithub.com/johnkenny54) in [https://github.com/svg/svgo/pull/1925](https://togithub.com/svg/svgo/pull/1925) - [`removeHiddenElems`](), treat `path[opacity=0]` as a non-rendering node. By [@johnkenny54](https://togithub.com/johnkenny54) in [#1948](https://togithub.com/svg/svgo/issues/1948) - [`removeUselessDefs`](https://svgo.dev/docs/plugins/remove-useless-defs/), don't remove node if child element has an ID. By [@johnkenny54](https://togithub.com/johnkenny54) in [https://github.com/svg/svgo/pull/1923](https://togithub.com/svg/svgo/pull/1923) - When stringifying path data, include a space before numbers represented in scientific notation. By [@johnkenny54](https://togithub.com/johnkenny54) in [#1961](https://togithub.com/svg/svgo/issues/1961) - No longer crashes when the output (`-o` argument) ends with a trailing slash to a location that didn't exist. By [@SethFalco](https://togithub.com/SethFalco) in [#1954](https://togithub.com/svg/svgo/issues/1954) ##### SVG Optimization - [`convertColors`](), introduce parameter to convert colors to common casing (lowercase/uppercase). By [@JayLeininger](https://togithub.com/JayLeininger) in [https://github.com/svg/svgo/pull/1692](https://togithub.com/svg/svgo/pull/1692) - [`removeDeprecatedAttrs`](), new plugin that is disabled by default to remove SVG attributes that are deprecated. By [@jdufresne](https://togithub.com/jdufresne) in [#1869](https://togithub.com/svg/svgo/issues/1869) #### Metrics Before and after using vectors from various sources, with the default preset of each respective version: | SVG | Original | v3.2.0 | v3.3.0 | Delta | |---|---|---|---|---| | [Arch Linux Logo](https://archlinux.org/art/) | 9.529 KiB | 4.115 KiB | 4.097 KiB | ⬇️ 0.018 KiB | | [Blobs](https://gitlab.gnome.org/GNOME/gnome-backgrounds/-/blob/main/backgrounds/blobs-d.svg) | 50.45 KiB | 42.623 KiB | 42.609 KiB | ⬇️ 0.014 KiB | | [Isometric Madness](https://inkscape.org/~Denis_Kuznetsky/%E2%98%85isometric-madness) | 869.034 KiB | 540.582 KiB | 540.073 KiB | ⬇️ 0.509 KiB | | [tldr-pages Banner](https://togithub.com/tldr-pages/tldr/blob/main/images/banner.svg) | 2.071 KiB | 1.07 KiB | 1.07 KiB | | | [Wikipedia Logo](https://en.wikipedia.org/wiki/File:Wikipedia-logo-v2.svg) | 161.551 KiB | 111.668 KiB | 111.668 KiB | | Before and after of the browser bundle of each respective version: | | v3.2.0 | v3.3.0 | Delta | |---|---|---|---| | svgo.browser.js | 910.9 kB | 753.0 kB | ⬇️ 157.9 kB | ### [`v3.2.0`](https://togithub.com/svg/svgo/releases/tag/v3.2.0) [Compare Source](https://togithub.com/svg/svgo/compare/v3.1.0...v3.2.0) #### What's Changed ##### Bug Fixes - [**Convert Path Commands**](https://svgo.dev/docs/plugins/convert-path-data/), fix instances were `q` was incorrectly converted to `t`. By [@KTibow](https://togithub.com/KTibow) in [https://github.com/svg/svgo/pull/1889](https://togithub.com/svg/svgo/pull/1889) - [**Convert Transform**](https://svgo.dev/docs/plugins/convert-transform/), fix for some transforms that weren't being converted correctly. By [@SethFalco](https://togithub.com/SethFalco) in [https://github.com/svg/svgo/pull/1916](https://togithub.com/svg/svgo/pull/1916) ##### SVG Optimization - [**Convert Path Commands**](https://svgo.dev/docs/plugins/convert-path-data/), improves closing paths and how we determine if to use absolute or relative commands. By [@KTibow](https://togithub.com/KTibow) in [https://github.com/svg/svgo/pull/1867](https://togithub.com/svg/svgo/pull/1867) - [**Convert Path Commands**](https://svgo.dev/docs/plugins/convert-path-data/), round arc or convert to lines based on the sagitta, can be disabled by setting `smartArcRounding` to `false`. By [@KTibow](https://togithub.com/KTibow) in [https://github.com/svg/svgo/pull/1873](https://togithub.com/svg/svgo/pull/1873) - [**Convert Path Commands**](https://svgo.dev/docs/plugins/convert-path-data/), convert cubic Bézier curves to quadratic Bézier curves where possible, can be disabled by setting `convertToQ` to `false`. By [@KTibow](https://togithub.com/KTibow) in [https://github.com/svg/svgo/pull/1889](https://togithub.com/svg/svgo/pull/1889) ##### Performance - [**Merge Paths**](https://svgo.dev/docs/plugins/merge-paths/), refactor for performance with large files. By [@mozzie](https://togithub.com/mozzie) in [https://github.com/svg/svgo/pull/1764](https://togithub.com/svg/svgo/pull/1764) and [https://github.com/svg/svgo/pull/1904](https://togithub.com/svg/svgo/pull/1904) - [**Convert Path Commands**](https://svgo.dev/docs/plugins/convert-path-data/), refactor `#stringifyPathData` for performance. By [@SethFalco](https://togithub.com/SethFalco) in [https://github.com/svg/svgo/pull/1900](https://togithub.com/svg/svgo/pull/1900) - Use [`Set`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Set) instead of [`Array`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array) for faster lookups. By [@SethFalco](https://togithub.com/SethFalco) in [https://github.com/svg/svgo/pull/1899](https://togithub.com/svg/svgo/pull/1899) #### Metrics Before and after using vectors from various sources, with the default preset of each respective version: | SVG | Original | v3.1.0 | v3.2.0 | Delta | |---|---|---|---|---| | [Arch Linux Logo](https://archlinux.org/art/) | 9.529 KiB | 4.162 KiB | 4.115 KiB | ⬇️ 0.047 KiB | | [Blobs](https://gitlab.gnome.org/GNOME/gnome-backgrounds/-/blob/main/backgrounds/blobs-d.svg) | 50.45 KiB | 42.949 KiB | 42.623 KiB | ⬇️ 0.326 KiB | | [Isometric Madness](https://inkscape.org/~Denis_Kuznetsky/%E2%98%85isometric-madness) | 869.034 KiB | 550.153 KiB | 540.582 KiB | ⬇️ 9.571 KiB | | [tldr-pages Banner](https://togithub.com/tldr-pages/tldr/blob/main/images/banner.svg) | 2.071 KiB | 1.07 KiB | 1.07 KiB | | | [Wikipedia Logo](https://en.wikipedia.org/wiki/File:Wikipedia-logo-v2.svg) | 161.551 KiB | 116 KiB | 111.668 KiB | ⬇️ 4.332 KiB | Before and after of the browser bundle of each respective version: | | v3.1.0 | v3.2.0 | Delta | |---|---|---|---| | svgo.browser.js | 660.9 kB | 910.9 kB | ⬆️ 250 kB | ### [`v3.1.0`](https://togithub.com/svg/svgo/releases/tag/v3.1.0) [Compare Source](https://togithub.com/svg/svgo/compare/v3.0.5...v3.1.0) #### What's Changed ##### Bug Fixes - [**Prefix IDs**](https://svgo.dev/docs/plugins/prefix-ids/), correctly prefix IDs when `