syncpack 14.0.0-alpha.11 → 14.0.0-alpha.13

package/README.md

@@ -6,6 +6,9 @@
   <br><a href="https://jamiemason.github.io/syncpack">https://jamiemason.github.io/syncpack</a>
 </p>
 
+> [!NOTE]
+> This is the README for v14-alpha, a Rust rewrite which is due to replace [`v13.x.x`](https://github.com/JamieMason/syncpack/tree/13.x.x?tab=readme-ov-file#syncpack)
+
 ## Installation
 
 ```bash
@@ -16,34 +19,49 @@ npm install --save-dev syncpack@alpha
 
 > All command line options can be combined to target packages and dependencies in multiple ways.
 
-### [lint](https://jamiemason.github.io/syncpack/command/lint) and [fix](https://jamiemason.github.io/syncpack/command/fix)
+### [lint](https://jamiemason.github.io/syncpack/command/lint)
 
-Ensure that multiple packages requiring the same dependency define the same version, so that every package requires eg. `react@16.4.2`, instead of a combination of `react@16.4.2`, `react@0.15.9`, and `react@16.0.0`.
+Ensure that multiple packages requiring the same dependency define the same version, so that every package requires eg. `react@17.0.2`, instead of a combination of `react@17.0.2`, `react@16.8.3`, and `react@16.14.0`.
 
 #### Examples
 
 ```bash
-# Find every issue in "dependencies" or "devDependencies"
+# Find all issues in "dependencies" or "devDependencies"
 syncpack lint --dependency-types prod,dev
+# Only lint issues in "react" specifically
+syncpack lint --dependencies react
 # Look for issues in dependencies containing "react" in the name
 syncpack lint --dependencies '**react**'
-# Autofix the above issues
-syncpack fix --dependencies '**react**'
+# Find issues in scoped packages only
+syncpack lint --dependencies '@types/**'
 # Find issues everywhere except "peerDependencies"
 syncpack lint --dependency-types '!peer'
-# Only look for issues where an exact version is used
-syncpack lint --specifier-types exact
-# Only look for issues where an exact version is specified
+# Only look for issues where an exact version is used (eg "1.2.3")
 syncpack lint --specifier-types exact
 # Sort dependencies by how many times they are used
 syncpack lint --sort count
-# Show a lot more detail about the issues
-syncpack lint --show hints,ignored,instances,statuses
 # See more examples
 syncpack lint --help
-syncpack fix --help
 # See a short summary of options
 syncpack lint -h
+```
+
+### [fix](https://jamiemason.github.io/syncpack/command/fix)
+
+Fix every autofixable issue found by `syncpack lint`.
+
+#### Examples
+
+```bash
+# Only fix issues in dependencies and devDependencies
+syncpack fix --dependency-types prod,dev
+# Only fix inconsistencies with exact versions (eg "1.2.3")
+syncpack fix --specifier-types exact
+# Only fix issues in "react" specifically
+syncpack fix --dependencies react
+# See more examples
+syncpack fix --help
+# See a short summary of options
 syncpack fix -h
 ```
 
@@ -97,6 +115,35 @@ syncpack format --help
 syncpack format -h
 ```
 
+### [list](https://jamiemason.github.io/syncpack/command/list)
+
+Query and inspect all dependencies in your project, both valid and invalid.
+
+#### Examples
+
+```bash
+# Sort dependencies by how many times they are used
+syncpack list --sort count
+# Show every instance of each dependency, not just their names
+syncpack list --show instances
+# Show dependencies ignored in your syncpack config
+syncpack list --show ignored
+# Show highest level of detail
+syncpack list --show all
+# Choose only some values
+syncpack list --show hints,statuses
+# List all "peerDependencies"
+syncpack list --dependency-types peer
+# List all types packages
+syncpack list --dependencies '@types/**'
+# List instances of an exact version being used as a peer dependency
+syncpack list --specifier-types exact --show instances --dependency-types peer
+# See more examples
+syncpack list --help
+# See a short summary of options
+syncpack list -h
+```
+
 ## Badges
 
 - [![support on ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/C0C4PY4P)

package/index.cjs

@@ -4,9 +4,7 @@ const { spawnSync } = require('node:child_process');
 
 const args = process.argv.slice(2);
 const arch = process.arch;
-const [os, extension] = ['win32', 'cygwin'].includes(process.platform)
-  ? ['windows', '.exe']
-  : [process.platform, ''];
+const [os, extension] = ['win32', 'cygwin'].includes(process.platform) ? ['windows', '.exe'] : [process.platform, ''];
 const optionalDep = `syncpack-${os}-${arch}`;
 const pkgSpecifier = `${optionalDep}/bin/syncpack${extension}`;
 const pathToBinary = require.resolve(pkgSpecifier);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "syncpack",
   "description": "Consistent dependency versions in large JavaScript Monorepos",
-  "version": "14.0.0-alpha.11",
+  "version": "14.0.0-alpha.13",
   "author": "Jamie Mason <jamie@foldleft.io> (https://github.com/JamieMason)",
   "bugs": "https://github.com/JamieMason/syncpack/issues",
   "contributors": [
@@ -36,7 +36,7 @@
   ],
   "dependencies": {
     "cosmiconfig": "^9.0.0",
-    "typescript": "^5.7.3"
+    "typescript": "^5.8.3"
   },
   "engines": {
     "node": ">=14.17.0"
@@ -69,12 +69,12 @@
     "syncpack": "./index.cjs"
   },
   "optionalDependencies": {
-    "syncpack-linux-x64": "14.0.0-alpha.11",
-    "syncpack-linux-arm64": "14.0.0-alpha.11",
-    "syncpack-darwin-x64": "14.0.0-alpha.11",
-    "syncpack-darwin-arm64": "14.0.0-alpha.11",
-    "syncpack-windows-x64": "14.0.0-alpha.11",
-    "syncpack-windows-arm64": "14.0.0-alpha.11"
+    "syncpack-linux-x64": "14.0.0-alpha.13",
+    "syncpack-linux-arm64": "14.0.0-alpha.13",
+    "syncpack-darwin-x64": "14.0.0-alpha.13",
+    "syncpack-darwin-arm64": "14.0.0-alpha.13",
+    "syncpack-windows-x64": "14.0.0-alpha.13",
+    "syncpack-windows-arm64": "14.0.0-alpha.13"
   },
   "types": "./syncpack.d.ts"
 }