12.0.0-alpha.0 (2023-11-05)

Bug Fixes

• local: do not replace version with workspace:* (d8a4eaa)
• npm: update dependencies (f016552)

Features

• cli: throw if command is not found (0608605)
• cli: display an error code/reason for every kind of mismatch
• cli: output a count of ignored instances
• docs: huge documentation overhaul
• groups: add support for $LOCAL keyword in config, Closes #161
• groups: allow dependencies: ["**"] and packages: ["**"] to be omitted
• list: add usage count next to each dependency in syncpack list, Closes #162
• options: add support for --indent ‘\t’
• update: group and filter npm updates by major, minor, patch etc
• update: show more information while querying npm for updates
• versions: add support for workspace:~ and workspace:*
• versions: preserve semver group rules when fixing mismatches, Closes #157
• versions: support npm:foo@0.1.0
• versions: support semver boundaries >=1.0.0 <=3.0.0
• versions: support semver git tags git://github.com/user/project.git#0.3.0
• versions: support semver tags 4.0.0-alpha.61

Breaking Changes

1. semverRange has been deprecated in config files, if you'd like to define a global policy for semver ranges you can achieve this with a semver group.

   {
   -  "semverRange": "^",
   +  "semverGroups": [{ "range": "^" }]
   }

2. There is no longer a default Semver Group. By default, version mismatches will be fixed while leaving the semver ranges as they were. This is intended to make it easier for new users to onboard, but it is recommended that you define Semver Groups yourself which match your project's requirements.

   See the Getting Started guide for a walkthrough on this.

Summary

This is the biggest syncpack release to date and has taken a couple of months to complete. Given the scale of the changes, it is an alpha release.

The tests have been rewritten to be easier to maintain and bugs were found along the way, so there will be other small improvements and bug fixes which I've lost track of that are not listed here.

Please give it a try in a local branch and submit an issue if you find any problems.

There is a brand new Getting Started guide and other new documentation which I encourage you to read.

Finally, if anyone reading this finds syncpack useful then please tell people about it – it's completely free and has been a ton of work.