@lazy-node/semver-ampersand 3.0.11 → 3.0.12

package/lib/range/util.d.ts

@@ -1,41 +1,174 @@
 import { IOptions } from '../types';
 /**
+ * 這是傳給 string.replace(re[t.HYPHENRANGE]) 的回呼函式
  * This function is passed to string.replace(re[t.HYPHENRANGE])
  * M, m, patch, prerelease, build
  * 1.2 - 3.4.5 => >=1.2.0 <=3.4.5
  * 1.2.3 - 3.4 => >=1.2.0 <3.5.0-0 Any 3.4.x will do
  * 1.2 - 3.4 => >=1.2.0 <3.5.0-0
+ *
+ * 上界與下界分開推導：hyphen 範圍的兩端可各自是萬用字元，
+ * 必須先各自補成完整邊界，才能轉成等價的比較器組合。
+ * The lower and upper bounds are derived separately: either side of a hyphen
+ * range may be a wildcard, so each side must first be completed into an exact
+ * boundary before it can become an equivalent comparator pair.
+ *
+ * @param incPr - 是否將預發布版本納入比較 / Whether to include pre-release versions in the comparison
+ * @returns replace 用的回呼 / A callback for use with `replace`
  */
 export declare function hyphenReplace(incPr: boolean): ($0: string, from: string, fM: string, fm: string, fp: string, fpr: string, fb: string, to: string, tM: string, tm: string, tp: string, tpr: string, tb: string) => string;
+/**
+ * 判斷版本段落是否為萬用字元
+ * Check whether a version segment is a wildcard
+ *
+ * 空字串也算萬用，因為正則在缺少該段時捕獲的是 ''，
+ * 與 'x' / '*' 表達的是同一件事（任意值）。
+ * An empty string also counts as a wildcard: the regex captures '' when the
+ * segment is absent, and that means the same as 'x' / '*' (any value).
+ *
+ * @param id - 版本段落 / Version segment
+ * @returns 是否為萬用字元 / Whether it is a wildcard
+ */
 export declare function isX(id: string): id is '' | '0' | '*' | 'x';
+/**
+ * 移除 >=0.0.0 這類無意義的下界
+ * Strip meaningless lower bounds such as >=0.0.0
+ *
+ * includePrerelease 時會改用允許預發布的樣式，
+ * 否則刪錯樣式會把 `-0` 一併吃掉，反而改變邊界。
+ * With includePrerelease the pre-release-friendly pattern is used; deleting
+ * the wrong pattern would swallow the `-0` suffix and change the boundary.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項 / Parse options
+ * @returns 整理後的比較器字串 / Tidied comparator string
+ */
 export declare function replaceGTE0(comp: string, options: IOptions): string;
 /**
+ * 展開單一比較器為純比較器字串
+ * Expand a single comparator into plain comparators
+ *
  * comprised of xranges, tildes, stars, and gtlt's at this point.
  * already replaced the hyphen ranges
  * turn into a set of JUST comparators.
+ *
+ * 順序刻意為 caret → tilde → xrange → star：前者的輸出可能仍含後者
+ * 語法，逐一往下傳遞可避免重複處理或漏處理。
+ * The order is deliberately caret → tilde → xrange → star: an earlier step may
+ * emit syntax handled by a later one, so chaining downward avoids both
+ * double-processing and missed cases.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項 / Parse options
+ * @returns 純比較器字串 / Plain comparator string
  */
 export declare function parseComparator(comp: string, options: IOptions): string;
 /**
+ * 展開 tilde（`~` / `~>`）語法
+ * Expand tilde (`~` / `~>`) syntax
+ *
  * ~, ~> --> * (any, kinda silly)
  * ~2, ~2.x, ~2.x.x, ~>2, ~>2.x ~>2.x.x --> >=2.0.0 <3.0.0-0
  * ~2.0, ~2.0.x, ~>2.0, ~>2.0.x --> >=2.0.0 <2.1.0-0
  * ~1.2, ~1.2.x, ~>1.2, ~>1.2.x --> >=1.2.0 <1.3.0-0
+ *
+ * 以空白切割後逐段轉換再接回，可同時處理 `>=1.0.0 ~2.0.0` 這類混合字串。
+ * Splitting on whitespace, converting each piece, then rejoining lets mixed
+ * strings such as `>=1.0.0 ~2.0.0` be handled in one pass.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項 / Parse options
+ * @returns 展開後的比較器字串 / Expanded comparator string
  */
 export declare function replaceTildes(comp: string, options: IOptions): string;
+/**
+ * 展開單一 tilde 比較器
+ * Expand a single tilde comparator
+ *
+ * 分支由粗到細（major → minor → patch → 有無 prerelease），
+ * 一旦判定為萬用段落就不再往下檢查，確保每種寫法只會命中一個分支。
+ * Branches run coarse → fine (major → minor → patch → presence of a
+ * pre-release); once a wildcard segment matches, later checks are skipped so
+ * each spelling hits exactly one branch.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項（loose 決定用哪組正則）/ Parse options (loose picks the regex flavour)
+ * @returns 展開後的比較器字串 / Expanded comparator string
+ */
 export declare function replaceTilde(comp: string, options: IOptions): string;
 /**
+ * 展開 caret（`^`）語法
+ * Expand caret (`^`) syntax
+ *
  * ^ --> * (any, kinda silly)
  * ^2, ^2.x, ^2.x.x --> >=2.0.0 <3.0.0-0
  * ^2.0, ^2.0.x --> >=2.0.0 <3.0.0-0
  * ^1.2, ^1.2.x --> >=1.2.0 <2.0.0-0
  * ^1.2.3 --> >=1.2.3 <2.0.0-0
  * ^1.2.0 --> >=1.2.0 <2.0.0-0
+ *
+ * 與 replaceTildes 同樣以空白切割逐段轉換，保留混合字串的可讀性。
+ * Like replaceTildes, this splits on whitespace and converts piecewise so
+ * mixed strings stay supported.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項 / Parse options
+ * @returns 展開後的比較器字串 / Expanded comparator string
  */
 export declare function replaceCarets(comp: string, options: IOptions): string;
+/**
+ * 展開單一 caret 比較器
+ * Expand a single caret comparator
+ *
+ * caret 的上界取決於 major 是否為 0：`0.x` 代表尚未穩定，
+ * 只能保證 patch/minor 以下的相容性；`>=1` 則可放寬到下一個 major。
+ * The upper bound of a caret depends on whether major is 0: `0.x` means the
+ * API is not yet stable, so only patch/minor compatibility is promised, while
+ * `>=1` may relax up to the next major.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項（loose 決定用哪組正則）/ Parse options (loose picks the regex flavour)
+ * @returns 展開後的比較器字串 / Expanded comparator string
+ */
 export declare function replaceCaret(comp: string, options: IOptions): string;
+/**
+ * 展開 xrange（如 `>=1.2.x`、`1.x`）語法
+ * Expand xrange syntax (e.g. `>=1.2.x`, `1.x`)
+ *
+ * 以空白切割逐段轉換再接回，與 replaceTildes / replaceCarets 一致。
+ * Splitting on whitespace, converting piecewise, then rejoining — same
+ * strategy as replaceTildes / replaceCarets.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項 / Parse options
+ * @returns 展開後的比較器字串 / Expanded comparator string
+ */
 export declare function replaceXRanges(comp: string, options: IOptions): string;
+/**
+ * 展開單一 xrange 比較器
+ * Expand a single xrange comparator
+ *
+ * 萬用段落會連鎖展開（xM ⇒ xm ⇒ xp），讓「哪一段是萬用」只需要判斷一次；
+ * 運算子 `>` / `<=` 遇到萬用段落時必須改寫成等價的 `>=` / `<`，
+ * 因為萬用本身沒有明確邊界，直接輸出會得到不可比較的結果。
+ * Wildcards cascade (xM ⇒ xm ⇒ xp) so "which segment is a wildcard" is decided
+ * once; operators `>` / `<=` must be rewritten into the equivalent `>=` / `<`
+ * because a wildcard has no exact boundary and would otherwise produce a
+ * non-comparable result.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項 / Parse options
+ * @returns 展開後的比較器字串 / Expanded comparator string
+ */
 export declare function replaceXRange(comp: string, options: IOptions): string;
 /**
+ * 移除星號萬用字元
+ * Strip star wildcards
+ *
  * and '' means "any version", just remove the *s entirely.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項（此處刻意忽略）/ Parse options (deliberately ignored here)
+ * @returns 移除萬用字元後的字串 / String without wildcards
  */
 export declare function replaceStars(comp: string, options: IOptions): string;

package/lib/range/util.js

@@ -11,16 +11,46 @@ exports.replaceCaret = replaceCaret;
 exports.replaceXRanges = replaceXRanges;
 exports.replaceXRange = replaceXRange;
 exports.replaceStars = replaceStars;
+/**
+ * 範圍解析內部工具（移植自 semver/internal）
+ * Internal range parsing utilities (ported from semver/internal)
+ *
+ * 這裡是把 semver 的範圍語法（hyphen、tilde、caret、xrange、star）
+ * 展開成純比較器字串的核心；保留英文原註解以利與上游對照，
+ * 並以中文補充分支取捨的理由。
+ * These functions expand semver range syntax (hyphen, tilde, caret, xrange,
+ * star) into plain comparator strings. Upstream English comments are kept for
+ * easier diffing against the original; Chinese notes explain the rationale of
+ * each branch.
+ *
+ * @packageDocumentation
+ */
 const re_1 = require("semver/internal/re");
 /**
+ * 這是傳給 string.replace(re[t.HYPHENRANGE]) 的回呼函式
  * This function is passed to string.replace(re[t.HYPHENRANGE])
  * M, m, patch, prerelease, build
  * 1.2 - 3.4.5 => >=1.2.0 <=3.4.5
  * 1.2.3 - 3.4 => >=1.2.0 <3.5.0-0 Any 3.4.x will do
  * 1.2 - 3.4 => >=1.2.0 <3.5.0-0
+ *
+ * 上界與下界分開推導：hyphen 範圍的兩端可各自是萬用字元，
+ * 必須先各自補成完整邊界，才能轉成等價的比較器組合。
+ * The lower and upper bounds are derived separately: either side of a hyphen
+ * range may be a wildcard, so each side must first be completed into an exact
+ * boundary before it can become an equivalent comparator pair.
+ *
+ * @param incPr - 是否將預發布版本納入比較 / Whether to include pre-release versions in the comparison
+ * @returns replace 用的回呼 / A callback for use with `replace`
  */
 function hyphenReplace(incPr) {
     return ($0, from, fM, fm, fp, fpr, fb, to, tM, tm, tp, tpr, tb) => {
+        /**
+         * 下界（from）：由粗到細檢查萬用字元，
+         * 越粗的段落（major → minor → patch）需要越寬的下界。
+         * Lower bound (from): wildcards are checked coarse → fine; the coarser
+         * the wildcard (major → minor → patch), the wider the lower bound must be.
+         */
         if (isX(fM)) {
             from = '';
         }
@@ -36,6 +66,13 @@ function hyphenReplace(incPr) {
         else {
             from = `>=${from}${incPr ? '-0' : ''}`;
         }
+        /**
+         * 上界（to）：與下界相反，這裡一律補成「下一個版本之前」，
+         * 萬用段落要進位（如 3.4 → <3.5.0-0），已知段落則直接含入（<=）。
+         * Upper bound (to): mirrored against the lower bound — wildcards are
+         * rounded up (e.g. 3.4 → <3.5.0-0) while exact segments are included
+         * (<=).
+         */
         if (isX(tM)) {
             to = '';
         }
@@ -57,17 +94,55 @@ function hyphenReplace(incPr) {
         return (`${from} ${to}`).trim();
     };
 }
+/**
+ * 判斷版本段落是否為萬用字元
+ * Check whether a version segment is a wildcard
+ *
+ * 空字串也算萬用，因為正則在缺少該段時捕獲的是 ''，
+ * 與 'x' / '*' 表達的是同一件事（任意值）。
+ * An empty string also counts as a wildcard: the regex captures '' when the
+ * segment is absent, and that means the same as 'x' / '*' (any value).
+ *
+ * @param id - 版本段落 / Version segment
+ * @returns 是否為萬用字元 / Whether it is a wildcard
+ */
 function isX(id) {
     return !id || id.toLowerCase() === 'x' || id === '*';
 }
+/**
+ * 移除 >=0.0.0 這類無意義的下界
+ * Strip meaningless lower bounds such as >=0.0.0
+ *
+ * includePrerelease 時會改用允許預發布的樣式，
+ * 否則刪錯樣式會把 `-0` 一併吃掉，反而改變邊界。
+ * With includePrerelease the pre-release-friendly pattern is used; deleting
+ * the wrong pattern would swallow the `-0` suffix and change the boundary.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項 / Parse options
+ * @returns 整理後的比較器字串 / Tidied comparator string
+ */
 function replaceGTE0(comp, options) {
     return comp.trim()
         .replace(re_1.re[(options === null || options === void 0 ? void 0 : options.includePrerelease) ? re_1.t.GTE0PRE : re_1.t.GTE0], '');
 }
 /**
+ * 展開單一比較器為純比較器字串
+ * Expand a single comparator into plain comparators
+ *
  * comprised of xranges, tildes, stars, and gtlt's at this point.
  * already replaced the hyphen ranges
  * turn into a set of JUST comparators.
+ *
+ * 順序刻意為 caret → tilde → xrange → star：前者的輸出可能仍含後者
+ * 語法，逐一往下傳遞可避免重複處理或漏處理。
+ * The order is deliberately caret → tilde → xrange → star: an earlier step may
+ * emit syntax handled by a later one, so chaining downward avoids both
+ * double-processing and missed cases.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項 / Parse options
+ * @returns 純比較器字串 / Plain comparator string
  */
 function parseComparator(comp, options) {
     comp = replaceCarets(comp, options);
@@ -77,16 +152,41 @@ function parseComparator(comp, options) {
     return comp;
 }
 /**
+ * 展開 tilde（`~` / `~>`）語法
+ * Expand tilde (`~` / `~>`) syntax
+ *
  * ~, ~> --> * (any, kinda silly)
  * ~2, ~2.x, ~2.x.x, ~>2, ~>2.x ~>2.x.x --> >=2.0.0 <3.0.0-0
  * ~2.0, ~2.0.x, ~>2.0, ~>2.0.x --> >=2.0.0 <2.1.0-0
  * ~1.2, ~1.2.x, ~>1.2, ~>1.2.x --> >=1.2.0 <1.3.0-0
+ *
+ * 以空白切割後逐段轉換再接回，可同時處理 `>=1.0.0 ~2.0.0` 這類混合字串。
+ * Splitting on whitespace, converting each piece, then rejoining lets mixed
+ * strings such as `>=1.0.0 ~2.0.0` be handled in one pass.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項 / Parse options
+ * @returns 展開後的比較器字串 / Expanded comparator string
  */
 function replaceTildes(comp, options) {
     return comp.trim().split(/\s+/).map((comp) => {
         return replaceTilde(comp, options);
     }).join(' ');
 }
+/**
+ * 展開單一 tilde 比較器
+ * Expand a single tilde comparator
+ *
+ * 分支由粗到細（major → minor → patch → 有無 prerelease），
+ * 一旦判定為萬用段落就不再往下檢查，確保每種寫法只會命中一個分支。
+ * Branches run coarse → fine (major → minor → patch → presence of a
+ * pre-release); once a wildcard segment matches, later checks are skipped so
+ * each spelling hits exactly one branch.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項（loose 決定用哪組正則）/ Parse options (loose picks the regex flavour)
+ * @returns 展開後的比較器字串 / Expanded comparator string
+ */
 function replaceTilde(comp, options) {
     const r = options.loose ? re_1.re[re_1.t.TILDELOOSE] : re_1.re[re_1.t.TILDE];
     return comp.replace(r, (_, M, m, p, pr) => {
@@ -112,23 +212,55 @@ function replaceTilde(comp, options) {
     });
 }
 /**
+ * 展開 caret（`^`）語法
+ * Expand caret (`^`) syntax
+ *
  * ^ --> * (any, kinda silly)
  * ^2, ^2.x, ^2.x.x --> >=2.0.0 <3.0.0-0
  * ^2.0, ^2.0.x --> >=2.0.0 <3.0.0-0
  * ^1.2, ^1.2.x --> >=1.2.0 <2.0.0-0
  * ^1.2.3 --> >=1.2.3 <2.0.0-0
  * ^1.2.0 --> >=1.2.0 <2.0.0-0
+ *
+ * 與 replaceTildes 同樣以空白切割逐段轉換，保留混合字串的可讀性。
+ * Like replaceTildes, this splits on whitespace and converts piecewise so
+ * mixed strings stay supported.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項 / Parse options
+ * @returns 展開後的比較器字串 / Expanded comparator string
  */
 function replaceCarets(comp, options) {
     return comp.trim().split(/\s+/).map((comp) => {
         return replaceCaret(comp, options);
     }).join(' ');
 }
+/**
+ * 展開單一 caret 比較器
+ * Expand a single caret comparator
+ *
+ * caret 的上界取決於 major 是否為 0：`0.x` 代表尚未穩定，
+ * 只能保證 patch/minor 以下的相容性；`>=1` 則可放寬到下一個 major。
+ * The upper bound of a caret depends on whether major is 0: `0.x` means the
+ * API is not yet stable, so only patch/minor compatibility is promised, while
+ * `>=1` may relax up to the next major.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項（loose 決定用哪組正則）/ Parse options (loose picks the regex flavour)
+ * @returns 展開後的比較器字串 / Expanded comparator string
+ */
 function replaceCaret(comp, options) {
     const r = options.loose ? re_1.re[re_1.t.CARETLOOSE] : re_1.re[re_1.t.CARET];
     const z = options.includePrerelease ? '-0' : '';
     return comp.replace(r, (_, M, m, p, pr) => {
         let ret;
+        /**
+         * 萬用段落由粗到細判定；includePrerelease 時下界補 `-0`，
+         * 讓 `1.0.0-0` 這類最低預發布版本也被納入。
+         * Wildcards are checked coarse → fine; with includePrerelease the lower
+         * bound gains `-0` so the lowest pre-release (e.g. `1.0.0-0`) is
+         * included.
+         */
         if (isX(M)) {
             ret = '';
         }
@@ -136,6 +268,13 @@ function replaceCaret(comp, options) {
             ret = `>=${M}.0.0${z} <${+M + 1}.0.0-0`;
         }
         else if (isX(p)) {
+            /**
+             * major 為 0 時上界只能進位到 minor（避免跨過不相容的 patch），
+             * 否則可一路放行到下一個 major。
+             * When major is 0 the upper bound may only roll over the minor
+             * (to avoid crossing an incompatible patch); otherwise the next
+             * major is allowed.
+             */
             if (M === '0') {
                 ret = `>=${M}.${m}.0${z} <${M}.${+m + 1}.0-0`;
             }
@@ -144,6 +283,13 @@ function replaceCaret(comp, options) {
             }
         }
         else if (pr) {
+            /**
+             * 有預發布標籤時沿用原 patch 作為下界，並依 major/minor 是否為 0
+             * 決定上界進位的位置（0.0.x → patch、0.x → minor、其餘 → major）。
+             * With a pre-release tag the original patch stays as the lower
+             * bound, while the upper bound rolls over patch/minor/major
+             * depending on whether major/minor is 0.
+             */
             if (M === '0') {
                 if (m === '0') {
                     ret = `>=${M}.${m}.${p}-${pr} <${M}.${m}.${+p + 1}-0`;
@@ -157,6 +303,12 @@ function replaceCaret(comp, options) {
             }
         }
         else {
+            /**
+             * 無預發布標籤時的分支結構與上一段相同，
+             * 差別在於下界不帶 `-pr`，且 z 只在 includePrerelease 時加入。
+             * Same shape as the previous block, except the lower bound carries
+             * no `-pr` and `z` only appears under includePrerelease.
+             */
             if (M === '0') {
                 if (m === '0') {
                     ret = `>=${M}.${m}.${p}${z} <${M}.${m}.${+p + 1}-0`;
@@ -172,11 +324,39 @@ function replaceCaret(comp, options) {
         return ret;
     });
 }
+/**
+ * 展開 xrange（如 `>=1.2.x`、`1.x`）語法
+ * Expand xrange syntax (e.g. `>=1.2.x`, `1.x`)
+ *
+ * 以空白切割逐段轉換再接回，與 replaceTildes / replaceCarets 一致。
+ * Splitting on whitespace, converting piecewise, then rejoining — same
+ * strategy as replaceTildes / replaceCarets.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項 / Parse options
+ * @returns 展開後的比較器字串 / Expanded comparator string
+ */
 function replaceXRanges(comp, options) {
     return comp.split(/\s+/).map((comp) => {
         return replaceXRange(comp, options);
     }).join(' ');
 }
+/**
+ * 展開單一 xrange 比較器
+ * Expand a single xrange comparator
+ *
+ * 萬用段落會連鎖展開（xM ⇒ xm ⇒ xp），讓「哪一段是萬用」只需要判斷一次；
+ * 運算子 `>` / `<=` 遇到萬用段落時必須改寫成等價的 `>=` / `<`，
+ * 因為萬用本身沒有明確邊界，直接輸出會得到不可比較的結果。
+ * Wildcards cascade (xM ⇒ xm ⇒ xp) so "which segment is a wildcard" is decided
+ * once; operators `>` / `<=` must be rewritten into the equivalent `>=` / `<`
+ * because a wildcard has no exact boundary and would otherwise produce a
+ * non-comparable result.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項 / Parse options
+ * @returns 展開後的比較器字串 / Expanded comparator string
+ */
 function replaceXRange(comp, options) {
     comp = comp.trim();
     const r = options.loose ? re_1.re[re_1.t.XRANGELOOSE] : re_1.re[re_1.t.XRANGE];
@@ -185,12 +365,23 @@ function replaceXRange(comp, options) {
         const xm = xM || isX(m);
         const xp = xm || isX(p);
         const anyX = xp;
+        /**
+         * `=1.x` 等同於 `1.x`，先去掉運算子避免後續產生 `>=1.x` 這種殘缺輸出
+         * `=1.x` means the same as `1.x`; drop the operator so the output never
+         * degenerates into a broken `>=1.x`
+         */
         if (gtlt === '=' && anyX) {
             gtlt = '';
         }
         // if we're including prereleases in the match, then we need
         // to fix this to -0, the lowest possible prerelease value
         pr = options.includePrerelease ? '-0' : '';
+        /**
+         * major 本身就是萬用：`>x` / `<x` 沒有任何可比較的版本
+         * （回傳 <0.0.0-0），其餘情況代表「任意版本」（回傳 *）。
+         * major itself is a wildcard: `>x` / `<x` can never match
+         * (<0.0.0-0), anything else means "any version" (`*`).
+         */
         if (xM) {
             if (gtlt === '>' || gtlt === '<') {
                 // nothing is allowed
@@ -208,6 +399,14 @@ function replaceXRange(comp, options) {
                 m = 0;
             }
             p = 0;
+            /**
+             * `>` 遇到萬用段落要進位成 `>=` 下一個值：
+             * `>1` → `>=2.0.0`、`>1.2` → `>=1.3.0`，
+             * 否則會把被萬用涵蓋的版本誤判為符合。
+             * `>` over a wildcard must round up to `>=` of the next value
+             * (`>1` → `>=2.0.0`, `>1.2` → `>=1.3.0`), otherwise versions the
+             * wildcard covers would be wrongly accepted.
+             */
             if (gtlt === '>') {
                 // >1 => >=2.0.0
                 // >1.2 => >=1.3.0
@@ -233,6 +432,13 @@ function replaceXRange(comp, options) {
                     m = +m + 1;
                 }
             }
+            /**
+             * 上界一律補 `-0`：沒有預發布的上界會把 `x.0.0-0` 之外的
+             * 預發布版本也包含進來，與 semver 的預設行為不符。
+             * Upper bounds always gain `-0`; without it, pre-releases below
+             * the boundary would be included, which contradicts semver's
+             * default behavior.
+             */
             if (gtlt === '<') {
                 pr = '-0';
             }
@@ -248,7 +454,14 @@ function replaceXRange(comp, options) {
     });
 }
 /**
+ * 移除星號萬用字元
+ * Strip star wildcards
+ *
  * and '' means "any version", just remove the *s entirely.
+ *
+ * @param comp - 比較器字串 / Comparator string
+ * @param options - 解析選項（此處刻意忽略）/ Parse options (deliberately ignored here)
+ * @returns 移除萬用字元後的字串 / String without wildcards
  */
 function replaceStars(comp, options) {
     // Looseness is ignored here.  star is always as loose as it gets!

package/lib/range/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["util.ts"],"names":[],"mappings":"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","sourcesContent":["import { re, t } from 'semver/internal/re';\nimport { IOptions } from '../types';\nimport { EnumSemverVersion } from '../const';\n\n/**\n * This function is passed to string.replace(re[t.HYPHENRANGE])\n * M, m, patch, prerelease, build\n * 1.2 - 3.4.5 => >=1.2.0 <=3.4.5\n * 1.2.3 - 3.4 => >=1.2.0 <3.5.0-0 Any 3.4.x will do\n * 1.2 - 3.4 => >=1.2.0 <3.5.0-0\n */\nexport function hyphenReplace(incPr: boolean)\n{\n\treturn ($0: string,\n\t\tfrom: string, fM: string, fm: string, fp: string, fpr: string, fb: string,\n\t\tto: string, tM: string, tm: string, tp: string, tpr: string, tb: string,\n\t) =>\n\t{\n\t\tif (isX(fM))\n\t\t{\n\t\t\tfrom = ''\n\t\t}\n\t\telse if (isX(fm))\n\t\t{\n\t\t\tfrom = `>=${fM}.0.0${incPr ? '-0' : ''}`\n\t\t}\n\t\telse if (isX(fp))\n\t\t{\n\t\t\tfrom = `>=${fM}.${fm}.0${incPr ? '-0' : ''}`\n\t\t}\n\t\telse if (fpr)\n\t\t{\n\t\t\tfrom = `>=${from}`\n\t\t}\n\t\telse\n\t\t{\n\t\t\tfrom = `>=${from}${incPr ? '-0' : ''}`\n\t\t}\n\n\t\tif (isX(tM))\n\t\t{\n\t\t\tto = ''\n\t\t}\n\t\telse if (isX(tm))\n\t\t{\n\t\t\tto = `<${+tM + 1}.0.0-0`\n\t\t}\n\t\telse if (isX(tp))\n\t\t{\n\t\t\tto = `<${tM}.${+tm + 1}.0-0`\n\t\t}\n\t\telse if (tpr)\n\t\t{\n\t\t\tto = `<=${tM}.${tm}.${tp}-${tpr}`\n\t\t}\n\t\telse if (incPr)\n\t\t{\n\t\t\tto = `<${tM}.${tm}.${+tp + 1}-0`\n\t\t}\n\t\telse\n\t\t{\n\t\t\tto = `<=${to}`\n\t\t}\n\n\t\treturn (`${from} ${to}`).trim()\n\t};\n}\n\nexport function isX(id: string): id is '' | '0' | '*' | 'x'\n{\n\treturn !id || id.toLowerCase() === 'x' || id === '*';\n}\n\nexport function replaceGTE0(comp: string, options: IOptions)\n{\n\treturn comp.trim()\n\t\t.replace(re[options?.includePrerelease ? t.GTE0PRE : t.GTE0], '')\n}\n\n/**\n * comprised of xranges, tildes, stars, and gtlt's at this point.\n * already replaced the hyphen ranges\n * turn into a set of JUST comparators.\n */\nexport function parseComparator(comp: string, options: IOptions)\n{\n\tcomp = replaceCarets(comp, options)\n\tcomp = replaceTildes(comp, options)\n\tcomp = replaceXRanges(comp, options)\n\tcomp = replaceStars(comp, options)\n\treturn comp\n}\n\n/**\n * ~, ~> --> * (any, kinda silly)\n * ~2, ~2.x, ~2.x.x, ~>2, ~>2.x ~>2.x.x --> >=2.0.0 <3.0.0-0\n * ~2.0, ~2.0.x, ~>2.0, ~>2.0.x --> >=2.0.0 <2.1.0-0\n * ~1.2, ~1.2.x, ~>1.2, ~>1.2.x --> >=1.2.0 <1.3.0-0\n */\nexport function replaceTildes(comp: string, options: IOptions)\n{\n\treturn comp.trim().split(/\\s+/).map((comp) =>\n\t{\n\t\treturn replaceTilde(comp, options)\n\t}).join(' ');\n}\n\nexport function replaceTilde(comp: string, options: IOptions)\n{\n\tconst r = options.loose ? re[t.TILDELOOSE] : re[t.TILDE]\n\treturn comp.replace(r, (_, M, m, p, pr) =>\n\t{\n\n\t\tlet ret: string\n\n\t\tif (isX(M))\n\t\t{\n\t\t\tret = ''\n\t\t}\n\t\telse if (isX(m))\n\t\t{\n\t\t\tret = `>=${M}.0.0 <${+M + 1}.0.0-0`\n\t\t}\n\t\telse if (isX(p))\n\t\t{\n\t\t\t// ~1.2 == >=1.2.0 <1.3.0-0\n\t\t\tret = `>=${M}.${m}.0 <${M}.${+m + 1}.0-0`\n\t\t}\n\t\telse if (pr)\n\t\t{\n\n\t\t\tret = `>=${M}.${m}.${p}-${pr\n\t\t\t} <${M}.${+m + 1}.0-0`\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// ~1.2.3 == >=1.2.3 <1.3.0-0\n\t\t\tret = `>=${M}.${m}.${p\n\t\t\t} <${M}.${+m + 1}.0-0`\n\t\t}\n\n\t\treturn ret\n\t})\n}\n\n/**\n * ^ --> * (any, kinda silly)\n * ^2, ^2.x, ^2.x.x --> >=2.0.0 <3.0.0-0\n * ^2.0, ^2.0.x --> >=2.0.0 <3.0.0-0\n * ^1.2, ^1.2.x --> >=1.2.0 <2.0.0-0\n * ^1.2.3 --> >=1.2.3 <2.0.0-0\n * ^1.2.0 --> >=1.2.0 <2.0.0-0\n */\nexport function replaceCarets(comp: string, options: IOptions)\n{\n\treturn comp.trim().split(/\\s+/).map((comp) =>\n\t{\n\t\treturn replaceCaret(comp, options)\n\t}).join(' ');\n}\n\nexport function replaceCaret(comp: string, options: IOptions)\n{\n\n\tconst r = options.loose ? re[t.CARETLOOSE] : re[t.CARET]\n\tconst z = options.includePrerelease ? '-0' : ''\n\treturn comp.replace(r, (_, M, m, p, pr) =>\n\t{\n\n\t\tlet ret: string\n\n\t\tif (isX(M))\n\t\t{\n\t\t\tret = ''\n\t\t}\n\t\telse if (isX(m))\n\t\t{\n\t\t\tret = `>=${M}.0.0${z} <${+M + 1}.0.0-0`\n\t\t}\n\t\telse if (isX(p))\n\t\t{\n\t\t\tif (M === '0')\n\t\t\t{\n\t\t\t\tret = `>=${M}.${m}.0${z} <${M}.${+m + 1}.0-0`\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tret = `>=${M}.${m}.0${z} <${+M + 1}.0.0-0`\n\t\t\t}\n\t\t}\n\t\telse if (pr)\n\t\t{\n\n\t\t\tif (M === '0')\n\t\t\t{\n\t\t\t\tif (m === '0')\n\t\t\t\t{\n\t\t\t\t\tret = `>=${M}.${m}.${p}-${pr\n\t\t\t\t\t} <${M}.${m}.${+p + 1}-0`\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\tret = `>=${M}.${m}.${p}-${pr\n\t\t\t\t\t} <${M}.${+m + 1}.0-0`\n\t\t\t\t}\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tret = `>=${M}.${m}.${p}-${pr\n\t\t\t\t} <${+M + 1}.0.0-0`\n\t\t\t}\n\t\t}\n\t\telse\n\t\t{\n\n\t\t\tif (M === '0')\n\t\t\t{\n\t\t\t\tif (m === '0')\n\t\t\t\t{\n\t\t\t\t\tret = `>=${M}.${m}.${p\n\t\t\t\t\t}${z} <${M}.${m}.${+p + 1}-0`\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\tret = `>=${M}.${m}.${p\n\t\t\t\t\t}${z} <${M}.${+m + 1}.0-0`\n\t\t\t\t}\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tret = `>=${M}.${m}.${p\n\t\t\t\t} <${+M + 1}.0.0-0`\n\t\t\t}\n\t\t}\n\n\t\treturn ret\n\t})\n}\n\nexport function replaceXRanges(comp: string, options: IOptions)\n{\n\n\treturn comp.split(/\\s+/).map((comp) =>\n\t{\n\t\treturn replaceXRange(comp, options)\n\t}).join(' ')\n}\n\nexport function replaceXRange(comp: string, options: IOptions)\n{\n\tcomp = comp.trim()\n\tconst r = options.loose ? re[t.XRANGELOOSE] : re[t.XRANGE]\n\treturn comp.replace(r, (ret, gtlt, M, m, p, pr) =>\n\t{\n\n\t\tconst xM = isX(M)\n\t\tconst xm = xM || isX(m)\n\t\tconst xp = xm || isX(p)\n\t\tconst anyX = xp\n\n\t\tif (gtlt === '=' && anyX)\n\t\t{\n\t\t\tgtlt = ''\n\t\t}\n\n\t\t// if we're including prereleases in the match, then we need\n\t\t// to fix this to -0, the lowest possible prerelease value\n\t\tpr = options.includePrerelease ? '-0' : ''\n\n\t\tif (xM)\n\t\t{\n\t\t\tif (gtlt === '>' || gtlt === '<')\n\t\t\t{\n\t\t\t\t// nothing is allowed\n\t\t\t\tret = EnumSemverVersion.NULL\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t// nothing is forbidden\n\t\t\t\tret = EnumSemverVersion.STAR\n\t\t\t}\n\t\t}\n\t\telse if (gtlt && anyX)\n\t\t{\n\t\t\t// we know patch is an x, because we have any x at all.\n\t\t\t// replace X with 0\n\t\t\tif (xm)\n\t\t\t{\n\t\t\t\tm = 0\n\t\t\t}\n\t\t\tp = 0\n\n\t\t\tif (gtlt === '>')\n\t\t\t{\n\t\t\t\t// >1 => >=2.0.0\n\t\t\t\t// >1.2 => >=1.3.0\n\t\t\t\tgtlt = '>='\n\t\t\t\tif (xm)\n\t\t\t\t{\n\t\t\t\t\tM = +M + 1\n\t\t\t\t\tm = 0\n\t\t\t\t\tp = 0\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\tm = +m + 1\n\t\t\t\t\tp = 0\n\t\t\t\t}\n\t\t\t}\n\t\t\telse if (gtlt === '<=')\n\t\t\t{\n\t\t\t\t// <=0.7.x is actually <0.8.0, since any 0.7.x should\n\t\t\t\t// pass.  Similarly, <=7.x is actually <8.0.0, etc.\n\t\t\t\tgtlt = '<'\n\t\t\t\tif (xm)\n\t\t\t\t{\n\t\t\t\t\tM = +M + 1\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\tm = +m + 1\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (gtlt === '<')\n\t\t\t{\n\t\t\t\tpr = '-0'\n\t\t\t}\n\n\t\t\tret = `${gtlt + M}.${m}.${p}${pr}`\n\t\t}\n\t\telse if (xm)\n\t\t{\n\t\t\tret = `>=${M}.0.0${pr} <${+M + 1}.0.0-0`\n\t\t}\n\t\telse if (xp)\n\t\t{\n\t\t\tret = `>=${M}.${m}.0${pr\n\t\t\t} <${M}.${+m + 1}.0-0`\n\t\t}\n\n\t\treturn ret\n\t})\n}\n\n/**\n * and '' means \"any version\", just remove the *s entirely.\n */\nexport function replaceStars(comp: string, options: IOptions)\n{\n\t// Looseness is ignored here.  star is always as loose as it gets!\n\treturn comp.trim().replace(re[t.STAR], '')\n}\n"]}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["util.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * 範圍解析內部工具（移植自 semver/internal）\n * Internal range parsing utilities (ported from semver/internal)\n *\n * 這裡是把 semver 的範圍語法（hyphen、tilde、caret、xrange、star）\n * 展開成純比較器字串的核心；保留英文原註解以利與上游對照，\n * 並以中文補充分支取捨的理由。\n * These functions expand semver range syntax (hyphen, tilde, caret, xrange,\n * star) into plain comparator strings. Upstream English comments are kept for\n * easier diffing against the original; Chinese notes explain the rationale of\n * each branch.\n *\n * @packageDocumentation\n */\nimport { re, t } from 'semver/internal/re';\nimport { IOptions } from '../types';\nimport { EnumSemverVersion } from '../const';\n\n/**\n * 這是傳給 string.replace(re[t.HYPHENRANGE]) 的回呼函式\n * This function is passed to string.replace(re[t.HYPHENRANGE])\n * M, m, patch, prerelease, build\n * 1.2 - 3.4.5 => >=1.2.0 <=3.4.5\n * 1.2.3 - 3.4 => >=1.2.0 <3.5.0-0 Any 3.4.x will do\n * 1.2 - 3.4 => >=1.2.0 <3.5.0-0\n *\n * 上界與下界分開推導：hyphen 範圍的兩端可各自是萬用字元，\n * 必須先各自補成完整邊界，才能轉成等價的比較器組合。\n * The lower and upper bounds are derived separately: either side of a hyphen\n * range may be a wildcard, so each side must first be completed into an exact\n * boundary before it can become an equivalent comparator pair.\n *\n * @param incPr - 是否將預發布版本納入比較 / Whether to include pre-release versions in the comparison\n * @returns replace 用的回呼 / A callback for use with `replace`\n */\nexport function hyphenReplace(incPr: boolean)\n{\n\treturn ($0: string,\n\t\tfrom: string, fM: string, fm: string, fp: string, fpr: string, fb: string,\n\t\tto: string, tM: string, tm: string, tp: string, tpr: string, tb: string,\n\t) =>\n\t{\n\t\t/**\n\t\t * 下界（from）：由粗到細檢查萬用字元，\n\t\t * 越粗的段落（major → minor → patch）需要越寬的下界。\n\t\t * Lower bound (from): wildcards are checked coarse → fine; the coarser\n\t\t * the wildcard (major → minor → patch), the wider the lower bound must be.\n\t\t */\n\t\tif (isX(fM))\n\t\t{\n\t\t\tfrom = ''\n\t\t}\n\t\telse if (isX(fm))\n\t\t{\n\t\t\tfrom = `>=${fM}.0.0${incPr ? '-0' : ''}`\n\t\t}\n\t\telse if (isX(fp))\n\t\t{\n\t\t\tfrom = `>=${fM}.${fm}.0${incPr ? '-0' : ''}`\n\t\t}\n\t\telse if (fpr)\n\t\t{\n\t\t\tfrom = `>=${from}`\n\t\t}\n\t\telse\n\t\t{\n\t\t\tfrom = `>=${from}${incPr ? '-0' : ''}`\n\t\t}\n\n\t\t/**\n\t\t * 上界（to）：與下界相反，這裡一律補成「下一個版本之前」，\n\t\t * 萬用段落要進位（如 3.4 → <3.5.0-0），已知段落則直接含入（<=）。\n\t\t * Upper bound (to): mirrored against the lower bound — wildcards are\n\t\t * rounded up (e.g. 3.4 → <3.5.0-0) while exact segments are included\n\t\t * (<=).\n\t\t */\n\t\tif (isX(tM))\n\t\t{\n\t\t\tto = ''\n\t\t}\n\t\telse if (isX(tm))\n\t\t{\n\t\t\tto = `<${+tM + 1}.0.0-0`\n\t\t}\n\t\telse if (isX(tp))\n\t\t{\n\t\t\tto = `<${tM}.${+tm + 1}.0-0`\n\t\t}\n\t\telse if (tpr)\n\t\t{\n\t\t\tto = `<=${tM}.${tm}.${tp}-${tpr}`\n\t\t}\n\t\telse if (incPr)\n\t\t{\n\t\t\tto = `<${tM}.${tm}.${+tp + 1}-0`\n\t\t}\n\t\telse\n\t\t{\n\t\t\tto = `<=${to}`\n\t\t}\n\n\t\treturn (`${from} ${to}`).trim()\n\t};\n}\n\n/**\n * 判斷版本段落是否為萬用字元\n * Check whether a version segment is a wildcard\n *\n * 空字串也算萬用，因為正則在缺少該段時捕獲的是 ''，\n * 與 'x' / '*' 表達的是同一件事（任意值）。\n * An empty string also counts as a wildcard: the regex captures '' when the\n * segment is absent, and that means the same as 'x' / '*' (any value).\n *\n * @param id - 版本段落 / Version segment\n * @returns 是否為萬用字元 / Whether it is a wildcard\n */\nexport function isX(id: string): id is '' | '0' | '*' | 'x'\n{\n\treturn !id || id.toLowerCase() === 'x' || id === '*';\n}\n\n/**\n * 移除 >=0.0.0 這類無意義的下界\n * Strip meaningless lower bounds such as >=0.0.0\n *\n * includePrerelease 時會改用允許預發布的樣式，\n * 否則刪錯樣式會把 `-0` 一併吃掉，反而改變邊界。\n * With includePrerelease the pre-release-friendly pattern is used; deleting\n * the wrong pattern would swallow the `-0` suffix and change the boundary.\n *\n * @param comp - 比較器字串 / Comparator string\n * @param options - 解析選項 / Parse options\n * @returns 整理後的比較器字串 / Tidied comparator string\n */\nexport function replaceGTE0(comp: string, options: IOptions)\n{\n\treturn comp.trim()\n\t\t.replace(re[options?.includePrerelease ? t.GTE0PRE : t.GTE0], '')\n}\n\n/**\n * 展開單一比較器為純比較器字串\n * Expand a single comparator into plain comparators\n *\n * comprised of xranges, tildes, stars, and gtlt's at this point.\n * already replaced the hyphen ranges\n * turn into a set of JUST comparators.\n *\n * 順序刻意為 caret → tilde → xrange → star：前者的輸出可能仍含後者\n * 語法，逐一往下傳遞可避免重複處理或漏處理。\n * The order is deliberately caret → tilde → xrange → star: an earlier step may\n * emit syntax handled by a later one, so chaining downward avoids both\n * double-processing and missed cases.\n *\n * @param comp - 比較器字串 / Comparator string\n * @param options - 解析選項 / Parse options\n * @returns 純比較器字串 / Plain comparator string\n */\nexport function parseComparator(comp: string, options: IOptions)\n{\n\tcomp = replaceCarets(comp, options)\n\tcomp = replaceTildes(comp, options)\n\tcomp = replaceXRanges(comp, options)\n\tcomp = replaceStars(comp, options)\n\treturn comp\n}\n\n/**\n * 展開 tilde（`~` / `~>`）語法\n * Expand tilde (`~` / `~>`) syntax\n *\n * ~, ~> --> * (any, kinda silly)\n * ~2, ~2.x, ~2.x.x, ~>2, ~>2.x ~>2.x.x --> >=2.0.0 <3.0.0-0\n * ~2.0, ~2.0.x, ~>2.0, ~>2.0.x --> >=2.0.0 <2.1.0-0\n * ~1.2, ~1.2.x, ~>1.2, ~>1.2.x --> >=1.2.0 <1.3.0-0\n *\n * 以空白切割後逐段轉換再接回，可同時處理 `>=1.0.0 ~2.0.0` 這類混合字串。\n * Splitting on whitespace, converting each piece, then rejoining lets mixed\n * strings such as `>=1.0.0 ~2.0.0` be handled in one pass.\n *\n * @param comp - 比較器字串 / Comparator string\n * @param options - 解析選項 / Parse options\n * @returns 展開後的比較器字串 / Expanded comparator string\n */\nexport function replaceTildes(comp: string, options: IOptions)\n{\n\treturn comp.trim().split(/\\s+/).map((comp) =>\n\t{\n\t\treturn replaceTilde(comp, options)\n\t}).join(' ');\n}\n\n/**\n * 展開單一 tilde 比較器\n * Expand a single tilde comparator\n *\n * 分支由粗到細（major → minor → patch → 有無 prerelease），\n * 一旦判定為萬用段落就不再往下檢查，確保每種寫法只會命中一個分支。\n * Branches run coarse → fine (major → minor → patch → presence of a\n * pre-release); once a wildcard segment matches, later checks are skipped so\n * each spelling hits exactly one branch.\n *\n * @param comp - 比較器字串 / Comparator string\n * @param options - 解析選項（loose 決定用哪組正則）/ Parse options (loose picks the regex flavour)\n * @returns 展開後的比較器字串 / Expanded comparator string\n */\nexport function replaceTilde(comp: string, options: IOptions)\n{\n\tconst r = options.loose ? re[t.TILDELOOSE] : re[t.TILDE]\n\treturn comp.replace(r, (_, M, m, p, pr) =>\n\t{\n\n\t\tlet ret: string\n\n\t\tif (isX(M))\n\t\t{\n\t\t\tret = ''\n\t\t}\n\t\telse if (isX(m))\n\t\t{\n\t\t\tret = `>=${M}.0.0 <${+M + 1}.0.0-0`\n\t\t}\n\t\telse if (isX(p))\n\t\t{\n\t\t\t// ~1.2 == >=1.2.0 <1.3.0-0\n\t\t\tret = `>=${M}.${m}.0 <${M}.${+m + 1}.0-0`\n\t\t}\n\t\telse if (pr)\n\t\t{\n\n\t\t\tret = `>=${M}.${m}.${p}-${pr\n\t\t\t} <${M}.${+m + 1}.0-0`\n\t\t}\n\t\telse\n\t\t{\n\t\t\t// ~1.2.3 == >=1.2.3 <1.3.0-0\n\t\t\tret = `>=${M}.${m}.${p\n\t\t\t} <${M}.${+m + 1}.0-0`\n\t\t}\n\n\t\treturn ret\n\t})\n}\n\n/**\n * 展開 caret（`^`）語法\n * Expand caret (`^`) syntax\n *\n * ^ --> * (any, kinda silly)\n * ^2, ^2.x, ^2.x.x --> >=2.0.0 <3.0.0-0\n * ^2.0, ^2.0.x --> >=2.0.0 <3.0.0-0\n * ^1.2, ^1.2.x --> >=1.2.0 <2.0.0-0\n * ^1.2.3 --> >=1.2.3 <2.0.0-0\n * ^1.2.0 --> >=1.2.0 <2.0.0-0\n *\n * 與 replaceTildes 同樣以空白切割逐段轉換，保留混合字串的可讀性。\n * Like replaceTildes, this splits on whitespace and converts piecewise so\n * mixed strings stay supported.\n *\n * @param comp - 比較器字串 / Comparator string\n * @param options - 解析選項 / Parse options\n * @returns 展開後的比較器字串 / Expanded comparator string\n */\nexport function replaceCarets(comp: string, options: IOptions)\n{\n\treturn comp.trim().split(/\\s+/).map((comp) =>\n\t{\n\t\treturn replaceCaret(comp, options)\n\t}).join(' ');\n}\n\n/**\n * 展開單一 caret 比較器\n * Expand a single caret comparator\n *\n * caret 的上界取決於 major 是否為 0：`0.x` 代表尚未穩定，\n * 只能保證 patch/minor 以下的相容性；`>=1` 則可放寬到下一個 major。\n * The upper bound of a caret depends on whether major is 0: `0.x` means the\n * API is not yet stable, so only patch/minor compatibility is promised, while\n * `>=1` may relax up to the next major.\n *\n * @param comp - 比較器字串 / Comparator string\n * @param options - 解析選項（loose 決定用哪組正則）/ Parse options (loose picks the regex flavour)\n * @returns 展開後的比較器字串 / Expanded comparator string\n */\nexport function replaceCaret(comp: string, options: IOptions)\n{\n\n\tconst r = options.loose ? re[t.CARETLOOSE] : re[t.CARET]\n\tconst z = options.includePrerelease ? '-0' : ''\n\treturn comp.replace(r, (_, M, m, p, pr) =>\n\t{\n\n\t\tlet ret: string\n\n\t\t/**\n\t\t * 萬用段落由粗到細判定；includePrerelease 時下界補 `-0`，\n\t\t * 讓 `1.0.0-0` 這類最低預發布版本也被納入。\n\t\t * Wildcards are checked coarse → fine; with includePrerelease the lower\n\t\t * bound gains `-0` so the lowest pre-release (e.g. `1.0.0-0`) is\n\t\t * included.\n\t\t */\n\t\tif (isX(M))\n\t\t{\n\t\t\tret = ''\n\t\t}\n\t\telse if (isX(m))\n\t\t{\n\t\t\tret = `>=${M}.0.0${z} <${+M + 1}.0.0-0`\n\t\t}\n\t\telse if (isX(p))\n\t\t{\n\t\t\t/**\n\t\t\t * major 為 0 時上界只能進位到 minor（避免跨過不相容的 patch），\n\t\t\t * 否則可一路放行到下一個 major。\n\t\t\t * When major is 0 the upper bound may only roll over the minor\n\t\t\t * (to avoid crossing an incompatible patch); otherwise the next\n\t\t\t * major is allowed.\n\t\t\t */\n\t\t\tif (M === '0')\n\t\t\t{\n\t\t\t\tret = `>=${M}.${m}.0${z} <${M}.${+m + 1}.0-0`\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tret = `>=${M}.${m}.0${z} <${+M + 1}.0.0-0`\n\t\t\t}\n\t\t}\n\t\telse if (pr)\n\t\t{\n\n\t\t\t/**\n\t\t\t * 有預發布標籤時沿用原 patch 作為下界，並依 major/minor 是否為 0\n\t\t\t * 決定上界進位的位置（0.0.x → patch、0.x → minor、其餘 → major）。\n\t\t\t * With a pre-release tag the original patch stays as the lower\n\t\t\t * bound, while the upper bound rolls over patch/minor/major\n\t\t\t * depending on whether major/minor is 0.\n\t\t\t */\n\t\t\tif (M === '0')\n\t\t\t{\n\t\t\t\tif (m === '0')\n\t\t\t\t{\n\t\t\t\t\tret = `>=${M}.${m}.${p}-${pr\n\t\t\t\t\t} <${M}.${m}.${+p + 1}-0`\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\tret = `>=${M}.${m}.${p}-${pr\n\t\t\t\t\t} <${M}.${+m + 1}.0-0`\n\t\t\t\t}\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tret = `>=${M}.${m}.${p}-${pr\n\t\t\t\t} <${+M + 1}.0.0-0`\n\t\t\t}\n\t\t}\n\t\telse\n\t\t{\n\n\t\t\t/**\n\t\t\t * 無預發布標籤時的分支結構與上一段相同，\n\t\t\t * 差別在於下界不帶 `-pr`，且 z 只在 includePrerelease 時加入。\n\t\t\t * Same shape as the previous block, except the lower bound carries\n\t\t\t * no `-pr` and `z` only appears under includePrerelease.\n\t\t\t */\n\t\t\tif (M === '0')\n\t\t\t{\n\t\t\t\tif (m === '0')\n\t\t\t\t{\n\t\t\t\t\tret = `>=${M}.${m}.${p\n\t\t\t\t\t}${z} <${M}.${m}.${+p + 1}-0`\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\tret = `>=${M}.${m}.${p\n\t\t\t\t\t}${z} <${M}.${+m + 1}.0-0`\n\t\t\t\t}\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\tret = `>=${M}.${m}.${p\n\t\t\t\t} <${+M + 1}.0.0-0`\n\t\t\t}\n\t\t}\n\n\t\treturn ret\n\t})\n}\n\n/**\n * 展開 xrange（如 `>=1.2.x`、`1.x`）語法\n * Expand xrange syntax (e.g. `>=1.2.x`, `1.x`)\n *\n * 以空白切割逐段轉換再接回，與 replaceTildes / replaceCarets 一致。\n * Splitting on whitespace, converting piecewise, then rejoining — same\n * strategy as replaceTildes / replaceCarets.\n *\n * @param comp - 比較器字串 / Comparator string\n * @param options - 解析選項 / Parse options\n * @returns 展開後的比較器字串 / Expanded comparator string\n */\nexport function replaceXRanges(comp: string, options: IOptions)\n{\n\n\treturn comp.split(/\\s+/).map((comp) =>\n\t{\n\t\treturn replaceXRange(comp, options)\n\t}).join(' ')\n}\n\n/**\n * 展開單一 xrange 比較器\n * Expand a single xrange comparator\n *\n * 萬用段落會連鎖展開（xM ⇒ xm ⇒ xp），讓「哪一段是萬用」只需要判斷一次；\n * 運算子 `>` / `<=` 遇到萬用段落時必須改寫成等價的 `>=` / `<`，\n * 因為萬用本身沒有明確邊界，直接輸出會得到不可比較的結果。\n * Wildcards cascade (xM ⇒ xm ⇒ xp) so \"which segment is a wildcard\" is decided\n * once; operators `>` / `<=` must be rewritten into the equivalent `>=` / `<`\n * because a wildcard has no exact boundary and would otherwise produce a\n * non-comparable result.\n *\n * @param comp - 比較器字串 / Comparator string\n * @param options - 解析選項 / Parse options\n * @returns 展開後的比較器字串 / Expanded comparator string\n */\nexport function replaceXRange(comp: string, options: IOptions)\n{\n\tcomp = comp.trim()\n\tconst r = options.loose ? re[t.XRANGELOOSE] : re[t.XRANGE]\n\treturn comp.replace(r, (ret, gtlt, M, m, p, pr) =>\n\t{\n\n\t\tconst xM = isX(M)\n\t\tconst xm = xM || isX(m)\n\t\tconst xp = xm || isX(p)\n\t\tconst anyX = xp\n\n\t\t/**\n\t\t * `=1.x` 等同於 `1.x`，先去掉運算子避免後續產生 `>=1.x` 這種殘缺輸出\n\t\t * `=1.x` means the same as `1.x`; drop the operator so the output never\n\t\t * degenerates into a broken `>=1.x`\n\t\t */\n\t\tif (gtlt === '=' && anyX)\n\t\t{\n\t\t\tgtlt = ''\n\t\t}\n\n\t\t// if we're including prereleases in the match, then we need\n\t\t// to fix this to -0, the lowest possible prerelease value\n\t\tpr = options.includePrerelease ? '-0' : ''\n\n\t\t/**\n\t\t * major 本身就是萬用：`>x` / `<x` 沒有任何可比較的版本\n\t\t * （回傳 <0.0.0-0），其餘情況代表「任意版本」（回傳 *）。\n\t\t * major itself is a wildcard: `>x` / `<x` can never match\n\t\t * (<0.0.0-0), anything else means \"any version\" (`*`).\n\t\t */\n\t\tif (xM)\n\t\t{\n\t\t\tif (gtlt === '>' || gtlt === '<')\n\t\t\t{\n\t\t\t\t// nothing is allowed\n\t\t\t\tret = EnumSemverVersion.NULL\n\t\t\t}\n\t\t\telse\n\t\t\t{\n\t\t\t\t// nothing is forbidden\n\t\t\t\tret = EnumSemverVersion.STAR\n\t\t\t}\n\t\t}\n\t\telse if (gtlt && anyX)\n\t\t{\n\t\t\t// we know patch is an x, because we have any x at all.\n\t\t\t// replace X with 0\n\t\t\tif (xm)\n\t\t\t{\n\t\t\t\tm = 0\n\t\t\t}\n\t\t\tp = 0\n\n\t\t\t/**\n\t\t\t * `>` 遇到萬用段落要進位成 `>=` 下一個值：\n\t\t\t * `>1` → `>=2.0.0`、`>1.2` → `>=1.3.0`，\n\t\t\t * 否則會把被萬用涵蓋的版本誤判為符合。\n\t\t\t * `>` over a wildcard must round up to `>=` of the next value\n\t\t\t * (`>1` → `>=2.0.0`, `>1.2` → `>=1.3.0`), otherwise versions the\n\t\t\t * wildcard covers would be wrongly accepted.\n\t\t\t */\n\t\t\tif (gtlt === '>')\n\t\t\t{\n\t\t\t\t// >1 => >=2.0.0\n\t\t\t\t// >1.2 => >=1.3.0\n\t\t\t\tgtlt = '>='\n\t\t\t\tif (xm)\n\t\t\t\t{\n\t\t\t\t\tM = +M + 1\n\t\t\t\t\tm = 0\n\t\t\t\t\tp = 0\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\tm = +m + 1\n\t\t\t\t\tp = 0\n\t\t\t\t}\n\t\t\t}\n\t\t\telse if (gtlt === '<=')\n\t\t\t{\n\t\t\t\t// <=0.7.x is actually <0.8.0, since any 0.7.x should\n\t\t\t\t// pass.  Similarly, <=7.x is actually <8.0.0, etc.\n\t\t\t\tgtlt = '<'\n\t\t\t\tif (xm)\n\t\t\t\t{\n\t\t\t\t\tM = +M + 1\n\t\t\t\t}\n\t\t\t\telse\n\t\t\t\t{\n\t\t\t\t\tm = +m + 1\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * 上界一律補 `-0`：沒有預發布的上界會把 `x.0.0-0` 之外的\n\t\t\t * 預發布版本也包含進來，與 semver 的預設行為不符。\n\t\t\t * Upper bounds always gain `-0`; without it, pre-releases below\n\t\t\t * the boundary would be included, which contradicts semver's\n\t\t\t * default behavior.\n\t\t\t */\n\t\t\tif (gtlt === '<')\n\t\t\t{\n\t\t\t\tpr = '-0'\n\t\t\t}\n\n\t\t\tret = `${gtlt + M}.${m}.${p}${pr}`\n\t\t}\n\t\telse if (xm)\n\t\t{\n\t\t\tret = `>=${M}.0.0${pr} <${+M + 1}.0.0-0`\n\t\t}\n\t\telse if (xp)\n\t\t{\n\t\t\tret = `>=${M}.${m}.0${pr\n\t\t\t} <${M}.${+m + 1}.0-0`\n\t\t}\n\n\t\treturn ret\n\t})\n}\n\n/**\n * 移除星號萬用字元\n * Strip star wildcards\n *\n * and '' means \"any version\", just remove the *s entirely.\n *\n * @param comp - 比較器字串 / Comparator string\n * @param options - 解析選項（此處刻意忽略）/ Parse options (deliberately ignored here)\n * @returns 移除萬用字元後的字串 / String without wildcards\n */\nexport function replaceStars(comp: string, options: IOptions)\n{\n\t// Looseness is ignored here.  star is always as loose as it gets!\n\treturn comp.trim().replace(re[t.STAR], '')\n}\n"]}

package/lib/satisfies.d.ts

@@ -1,4 +1,21 @@
 import SemVer from 'semver/classes/semver';
 import { Options } from 'semver';
+/**
+ * 檢查版本是否符合範圍
+ * Check whether a version satisfies a range
+ *
+ * 先把 `&` 轉成空白（「且」語意）再交給原生 semver，因此 `>=1.0.0 & <2.0.0`
+ * 與 `>=1.0.0 <2.0.0` 等價；此處未轉傳選項給 handleAmpersandAndSpaces，
+ * 所以 `noAmpersand` 不生效，只有 loose / includePrerelease 會送到 semver。
+ * `&` is converted to a space ("AND") before delegating to native semver, so
+ * `>=1.0.0 & <2.0.0` equals `>=1.0.0 <2.0.0`; options are not forwarded to
+ * handleAmpersandAndSpaces, so `noAmpersand` is ignored here while loose /
+ * includePrerelease still reach semver.
+ *
+ * @param version - 要檢查的版本 / Version to check
+ * @param range - 範圍字串（支援 `&`）/ Range string (`&` supported)
+ * @param optionsOrLoose - 選項或寬鬆旗標 / Options or loose flag
+ * @returns 是否符合 / Whether it satisfies the range
+ */
 export declare function satisfies(version: string | SemVer, range: string | Range, optionsOrLoose?: boolean | Options): boolean;
 export default satisfies;