Allow filtering by version level

[timothymcmackin]

The current dependency script alerts on any version difference up to the fixpack level. This change allows you to pass --major to show only places where dependencies are out of date by the major version or --minor for minor version.

For example, npm run check-dependencies -- --major octez prints this:

docs/tutorials/smart-rollup.md
Outdated: octez 19 < 21.2

Reviewed 154 files.

But npm run check-dependencies -- --minor octez prints this:

docs/developing/octez-client/accounts.md
Outdated: octez 21.1 < 21.2

docs/developing/octez-client/installing.md
Outdated: octez 21.1 < 21.2

docs/developing/octez-client/transactions.md
Outdated: octez 21.1 < 21.2

docs/tutorials/smart-rollup.md
Outdated: octez 19 < 21.2

Reviewed 154 files.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Updated (UTC)
docs-staging	✅ Ready (Inspect)	Visit Preview	Jan 28, 2025 4:18pm

[NicNomadic]

Nice result!

As a side node, I thought the UI was more robust in the past, didn't t check for unknown dependencies? Now it doesn't seem to warn in case of misspelled options and/or arguments:

tezos-developer-docs % npm run check-dependencies -- --blabla zvelt

lists all the outdated dependecies, without complaining about anything.

[timothymcmackin]

Nice result!

As a side node, I thought the UI was more robust in the past, didn't t check for unknown dependencies? Now it doesn't seem to warn in case of misspelled options and/or arguments:

tezos-developer-docs % npm run check-dependencies -- --blabla zvelt

lists all the outdated dependecies, without complaining about anything.

In this case you are passing an argument --blabla with the value zvelt and it's swallowing those. I'll add an error to catch unrecognized arguments. It still checks for unknown dependencies if you run something like npm run check-dependencies -- blabla zvelt.

[timothymcmackin]

Added error checking so it will fail if you pass an unknown -- argument or unknown tool name.

[NicNomadic]

LGTM