semver範囲チェッカー

npm の package.json に書く ^1.2.3 や ~1.2 がどのバージョンを許すのかを、展開した比較式と一覧の判定で確かめます。

バージョン範囲（npm の書き方）

"some-lib":バージョン範囲

プレリリースも対象にする（--include-prerelease 相当）

バージョン一覧

順	バージョン	判定

A B

今のバージョン

^ は「いちばん左の0でない数字」を変えない範囲。^1.2.3 は 2.0.0 未満、^0.2.3 は 0.3.0 未満、^0.0.3 は 0.0.3 だけ。
~ はパッチ（3つ目）の更新だけを許します。~1.2.3 は 1.3.0 未満。~1 は 2.0.0 未満。
上限の -0 は「そのバージョンのプレリリースより前」という意味で、<2.0.0-0 は 2.0.0-rc.1 も含みません。
1.2.3-beta.2 のようなプレリリースは、範囲の中に同じ 1.2.3 のプレリリースを書いた比較式があるときだけ一致します（^1.2.3 には一致しない）。
並び順は SemVer 2.0.0 の規則：数字部分 → プレリリースなしが大きい → 識別子を左から（数字同士は数値、数字は英字より小さい）。+build は順位に影響しません。
npm の semver パッケージの挙動に合わせた独自実装です（loose モードは非対応）。最終確認は実際の npm で行ってください。入力はブラウザ内だけで処理します。

package.json の依存に書く ^1.2.3 や ~1.2、1.x || 2.x などの npm のバージョン範囲が、実際にどのバージョンを許すのかを確かめるツールです。範囲を比較式に展開し、手元のバージョン一覧のうちどれが一致するか、条件を満たす最大のバージョンはどれかを表示します。

「バージョン範囲（npm の書き方）」に範囲を入れます。下のボタン（^1.2.3、~1.2、^0.0.3、1.2 - 2.3 など）を押すと例が入ります。
展開結果に「>=1.2.3 <2.0.0-0」のような比較式と、各部分の意味が日本語で表示されます。必要なら「展開した式をコピー」を押します。
「調べるバージョン（1行に1つ）」に候補を入れると、右の判定表に SemVer の優先順位で小さい順に並び、一致・外（プレリリースのため）・最大が表示されます。
「2つのバージョンを比べる」で A と B の大小と、どの部分で決まったかを確認できます。
「次のバージョン」に今のバージョンを入れると、メジャー・マイナー・パッチ・プレリリースを上げた後の番号が表示されます。

範囲の展開と判定は npm の semver パッケージ（v7）の規則に合わせた独自実装です。^ は左端の0でない数字を固定し、~ はパッチの更新だけを許します。loose モードには対応していないので、最終確認は実際の npm で行ってください。
並び順は SemVer 2.0.0 の優先順位です。プレリリース付きは正式版より前、識別子は左から比べ、数字同士は数値、数字は英字より前になります。+ 以降のビルド情報は順位に影響しません。
1.2.3-beta.2 のようなプレリリースは、範囲の中に同じ 1.2.3 のプレリリースを書いた比較式があるときだけ一致します。「プレリリースも対象にする」にチェックを入れると、npm の --include-prerelease と同じ判定になります。
入力した範囲と一覧は使っているブラウザの中だけで処理され、外部には送信されません。最後の入力はこのブラウザに保存されます。

^1.2.3 と ~1.2.3 の違いは？

^1.2.3 は 1.2.3 以上 2.0.0 未満で、マイナーとパッチの更新を許します。~1.2.3 は 1.2.3 以上 1.3.0 未満で、パッチの更新だけです。2つのボタンを押して展開結果と判定表を見比べると違いがわかります。

^0.2.3 や ^0.0.3 はどこまで更新されますか？

メジャーが0のときは範囲が狭くなり、^0.2.3 は 0.3.0 未満、^0.0.3 は 0.0.3 だけです。0.x の間は互換性のない変更が入りやすいためです。^0.0.3 のボタンで展開結果を確認できます。

1.2.3-beta.2 が ^1.2.3 に一致しないのはなぜ？

プレリリースは正式版 1.2.3 より前の順位なので、1.2.3 以上という条件を満たしません。また npm は、範囲に同じ番号のプレリリースが書かれていないとプレリリースを一致させない決まりです。判定表では「外（プレリリースのため）」などと表示されます。

上限に付いている -0 は何ですか？

<2.0.0-0 は「2.0.0 のどのプレリリースよりも前」という意味で、2.0.0-rc.1 なども範囲に入れないための書き方です。npm も ^ や ~ を展開するとこの形になります。