@gjsify/semver 0.3.8

package/lib/esm/index.js

@@ -0,0 +1,330 @@
+const NUM_RE = /^(0|[1-9]\d*)$/;
+const SEMVER_RE = /^(\d+)\.(\d+)\.(\d+)(?:-((?:[0-9A-Za-z-]+)(?:\.[0-9A-Za-z-]+)*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/;
+function parse(version) {
+  try {
+    return new SemVer(version);
+  } catch {
+    return null;
+  }
+}
+function valid(version) {
+  const v = parse(version);
+  return v ? v.version : null;
+}
+function compare(a, b) {
+  const av = a instanceof SemVer ? a : new SemVer(a);
+  const bv = b instanceof SemVer ? b : new SemVer(b);
+  return av.compare(bv);
+}
+function satisfies(version, range) {
+  const r = range instanceof Range ? range : new Range(range);
+  const v = version instanceof SemVer ? version : parse(String(version));
+  if (!v) return false;
+  return r.test(v);
+}
+function maxSatisfying(versions, range) {
+  const r = range instanceof Range ? range : new Range(range);
+  let best = null;
+  for (const raw of versions) {
+    const v = parse(raw);
+    if (!v || !r.test(v)) continue;
+    if (best === null || v.compare(best) > 0) best = v;
+  }
+  return best ? best.version : null;
+}
+function minSatisfying(versions, range) {
+  const r = range instanceof Range ? range : new Range(range);
+  let best = null;
+  for (const raw of versions) {
+    const v = parse(raw);
+    if (!v || !r.test(v)) continue;
+    if (best === null || v.compare(best) < 0) best = v;
+  }
+  return best ? best.version : null;
+}
+function validRange(range) {
+  try {
+    return new Range(range).format();
+  } catch {
+    return null;
+  }
+}
+class SemVer {
+  major;
+  minor;
+  patch;
+  prerelease;
+  build;
+  version;
+  constructor(version) {
+    const trimmed = String(version).trim().replace(/^v/, "");
+    const m = SEMVER_RE.exec(trimmed);
+    if (!m) throw new TypeError(`Invalid Version: ${version}`);
+    this.major = Number(m[1]);
+    this.minor = Number(m[2]);
+    this.patch = Number(m[3]);
+    this.prerelease = m[4] ? m[4].split(".").map((id) => NUM_RE.test(id) ? Number(id) : id) : [];
+    this.build = m[5] ? m[5].split(".") : [];
+    this.version = `${this.major}.${this.minor}.${this.patch}` + (this.prerelease.length ? `-${this.prerelease.join(".")}` : "") + (this.build.length ? `+${this.build.join(".")}` : "");
+  }
+  compare(other) {
+    if (this.major !== other.major) return this.major < other.major ? -1 : 1;
+    if (this.minor !== other.minor) return this.minor < other.minor ? -1 : 1;
+    if (this.patch !== other.patch) return this.patch < other.patch ? -1 : 1;
+    return this.comparePre(other);
+  }
+  comparePre(other) {
+    const a = this.prerelease;
+    const b = other.prerelease;
+    if (a.length === 0 && b.length === 0) return 0;
+    if (a.length === 0) return 1;
+    if (b.length === 0) return -1;
+    for (let i = 0; ; i++) {
+      const x = a[i];
+      const y = b[i];
+      if (x === void 0 && y === void 0) return 0;
+      if (y === void 0) return 1;
+      if (x === void 0) return -1;
+      if (x === y) continue;
+      const xn = typeof x === "number";
+      const yn = typeof y === "number";
+      if (xn && !yn) return -1;
+      if (!xn && yn) return 1;
+      return x < y ? -1 : 1;
+    }
+  }
+  toString() {
+    return this.version;
+  }
+}
+class Range {
+  raw;
+  set;
+  constructor(range) {
+    if (range instanceof Range) {
+      this.raw = range.raw;
+      this.set = range.set;
+      return;
+    }
+    this.raw = String(range).trim();
+    const sets = this.raw.split(/\s*\|\|\s*/);
+    const parsed = [];
+    for (const part of sets) {
+      const c = parseRangePart(part);
+      if (c.length === 0) {
+        throw new TypeError(`Invalid range: ${this.raw}`);
+      }
+      parsed.push(c);
+    }
+    if (parsed.length === 0) {
+      throw new TypeError(`Invalid range: ${this.raw}`);
+    }
+    this.set = parsed;
+  }
+  test(version) {
+    const v = version instanceof SemVer ? version : parse(String(version));
+    if (!v) return false;
+    for (const conj of this.set) {
+      if (conj.every((c) => testComparator(c, v))) {
+        if (v.prerelease.length > 0) {
+          const allowed = conj.some(
+            (c) => c.semver !== null && c.semver.prerelease.length > 0 && c.semver.major === v.major && c.semver.minor === v.minor && c.semver.patch === v.patch
+          );
+          if (!allowed) continue;
+        }
+        return true;
+      }
+    }
+    return false;
+  }
+  format() {
+    return this.set.map((c) => c.map(formatComparator).join(" ")).join(" || ");
+  }
+  toString() {
+    return this.format();
+  }
+}
+function testComparator(c, v) {
+  if (c.semver === null) return true;
+  const cmp = v.compare(c.semver);
+  switch (c.operator) {
+    case "":
+    case "=":
+      return cmp === 0;
+    case "<":
+      return cmp < 0;
+    case "<=":
+      return cmp <= 0;
+    case ">":
+      return cmp > 0;
+    case ">=":
+      return cmp >= 0;
+  }
+}
+function formatComparator(c) {
+  if (c.semver === null) return "*";
+  return `${c.operator}${c.semver.version}`;
+}
+function parseRangePart(part) {
+  const trimmed = part.trim();
+  if (trimmed === "" || trimmed === "*" || trimmed.toLowerCase() === "latest") {
+    return [{ operator: ">=", semver: new SemVer("0.0.0") }];
+  }
+  const hyphen = trimmed.match(/^\s*(\S+)\s+-\s+(\S+)\s*$/);
+  if (hyphen) return hyphenRange(hyphen[1], hyphen[2]);
+  const tokens = trimmed.split(/\s+/);
+  const out = [];
+  for (const tok of tokens) out.push(...parseSimple(tok));
+  return out;
+}
+function parseSimple(tok) {
+  if (tok === "*" || tok === "" || tok.toLowerCase() === "latest") {
+    return [{ operator: ">=", semver: new SemVer("0.0.0") }];
+  }
+  if (tok.startsWith("^")) return caretRange(tok.slice(1));
+  if (tok.startsWith("~")) return tildeRange(tok.slice(1).replace(/^>/, ""));
+  const opMatch = tok.match(/^(<=|>=|<|>|=)\s*(.+)$/);
+  if (opMatch) {
+    const op = opMatch[1];
+    return primitiveRange(op, opMatch[2]);
+  }
+  return partialRange(tok);
+}
+function parsePartial(s) {
+  const trimmed = s.trim().replace(/^v/, "");
+  if (trimmed === "" || trimmed === "*") {
+    return { major: null, minor: null, patch: null, pre: "", build: "" };
+  }
+  let pre = "";
+  let build = "";
+  let core = trimmed;
+  const plus = core.indexOf("+");
+  if (plus >= 0) {
+    build = core.slice(plus + 1);
+    core = core.slice(0, plus);
+  }
+  const dash = core.indexOf("-");
+  if (dash >= 0) {
+    pre = core.slice(dash + 1);
+    core = core.slice(0, dash);
+  }
+  const parts = core.split(".");
+  const xr = (part) => {
+    if (part === void 0 || part === "") return null;
+    if (part === "x" || part === "X" || part === "*") return null;
+    if (!/^\d+$/.test(part)) {
+      throw new TypeError(`Invalid partial version: ${s}`);
+    }
+    return Number(part);
+  };
+  return {
+    major: xr(parts[0]),
+    minor: xr(parts[1]),
+    patch: xr(parts[2]),
+    pre,
+    build
+  };
+}
+function partialToVersion(p) {
+  return `${p.major ?? 0}.${p.minor ?? 0}.${p.patch ?? 0}${p.pre ? `-${p.pre}` : ""}${p.build ? `+${p.build}` : ""}`;
+}
+function partialRange(tok) {
+  const p = parsePartial(tok);
+  if (p.major === null) return [{ operator: ">=", semver: new SemVer("0.0.0") }];
+  if (p.minor === null) {
+    return [
+      { operator: ">=", semver: new SemVer(`${p.major}.0.0`) },
+      { operator: "<", semver: new SemVer(`${p.major + 1}.0.0`) }
+    ];
+  }
+  if (p.patch === null) {
+    return [
+      { operator: ">=", semver: new SemVer(`${p.major}.${p.minor}.0`) },
+      { operator: "<", semver: new SemVer(`${p.major}.${p.minor + 1}.0`) }
+    ];
+  }
+  return [{ operator: "=", semver: new SemVer(partialToVersion(p)) }];
+}
+function caretRange(tok) {
+  const p = parsePartial(tok);
+  if (p.major === null) return [{ operator: ">=", semver: new SemVer("0.0.0") }];
+  const lower = `${p.major}.${p.minor ?? 0}.${p.patch ?? 0}${p.pre ? `-${p.pre}` : ""}`;
+  let upper;
+  if (p.major > 0 || p.minor === null) {
+    upper = `${p.major + 1}.0.0`;
+  } else if (p.minor > 0 || p.patch === null) {
+    upper = `0.${p.minor + 1}.0`;
+  } else {
+    upper = `0.0.${p.patch + 1}`;
+  }
+  return [
+    { operator: ">=", semver: new SemVer(lower) },
+    { operator: "<", semver: new SemVer(upper) }
+  ];
+}
+function tildeRange(tok) {
+  const p = parsePartial(tok);
+  if (p.major === null) return [{ operator: ">=", semver: new SemVer("0.0.0") }];
+  const lower = `${p.major}.${p.minor ?? 0}.${p.patch ?? 0}${p.pre ? `-${p.pre}` : ""}`;
+  const upper = p.minor === null ? `${p.major + 1}.0.0` : `${p.major}.${p.minor + 1}.0`;
+  return [
+    { operator: ">=", semver: new SemVer(lower) },
+    { operator: "<", semver: new SemVer(upper) }
+  ];
+}
+function primitiveRange(op, rhs) {
+  const p = parsePartial(rhs);
+  if (p.major === null) return [{ operator: ">=", semver: new SemVer("0.0.0") }];
+  if (op === "=" || op === "") return partialRange(rhs);
+  if (op === ">") {
+    if (p.minor === null) return [{ operator: ">=", semver: new SemVer(`${p.major + 1}.0.0`) }];
+    if (p.patch === null) return [{ operator: ">=", semver: new SemVer(`${p.major}.${p.minor + 1}.0`) }];
+    return [{ operator: ">", semver: new SemVer(partialToVersion(p)) }];
+  }
+  if (op === "<") {
+    if (p.minor === null) return [{ operator: "<", semver: new SemVer(`${p.major}.0.0`) }];
+    if (p.patch === null) return [{ operator: "<", semver: new SemVer(`${p.major}.${p.minor}.0`) }];
+    return [{ operator: "<", semver: new SemVer(partialToVersion(p)) }];
+  }
+  if (op === ">=") return [{ operator: ">=", semver: new SemVer(partialToVersion(p)) }];
+  if (p.minor === null) return [{ operator: "<", semver: new SemVer(`${p.major + 1}.0.0`) }];
+  if (p.patch === null) return [{ operator: "<", semver: new SemVer(`${p.major}.${p.minor + 1}.0`) }];
+  return [{ operator: "<=", semver: new SemVer(partialToVersion(p)) }];
+}
+function hyphenRange(left, right) {
+  const a = parsePartial(left);
+  const b = parsePartial(right);
+  const lower = a.major === null ? { operator: ">=", semver: new SemVer("0.0.0") } : {
+    operator: ">=",
+    semver: new SemVer(
+      `${a.major}.${a.minor ?? 0}.${a.patch ?? 0}${a.pre ? `-${a.pre}` : ""}`
+    )
+  };
+  let upper;
+  if (b.major === null) {
+    upper = { operator: ">=", semver: new SemVer("0.0.0") };
+  } else if (b.minor === null) {
+    upper = { operator: "<", semver: new SemVer(`${b.major + 1}.0.0`) };
+  } else if (b.patch === null) {
+    upper = { operator: "<", semver: new SemVer(`${b.major}.${b.minor + 1}.0`) };
+  } else {
+    upper = {
+      operator: "<=",
+      semver: new SemVer(
+        `${b.major}.${b.minor}.${b.patch}${b.pre ? `-${b.pre}` : ""}`
+      )
+    };
+  }
+  return [lower, upper];
+}
+export {
+  Range,
+  SemVer,
+  compare,
+  maxSatisfying,
+  minSatisfying,
+  parse,
+  satisfies,
+  valid,
+  validRange
+};

package/lib/tsconfig.build.tsbuildinfo

@@ -0,0 +1 @@
+{"fileNames":["../../../../node_modules/typescript/lib/lib.es5.d.ts","../../../../node_modules/typescript/lib/lib.es2015.d.ts","../../../../node_modules/typescript/lib/lib.es2016.d.ts","../../../../node_modules/typescript/lib/lib.es2017.d.ts","../../../../node_modules/typescript/lib/lib.es2018.d.ts","../../../../node_modules/typescript/lib/lib.es2019.d.ts","../../../../node_modules/typescript/lib/lib.es2020.d.ts","../../../../node_modules/typescript/lib/lib.es2021.d.ts","../../../../node_modules/typescript/lib/lib.es2022.d.ts","../../../../node_modules/typescript/lib/lib.es2023.d.ts","../../../../node_modules/typescript/lib/lib.es2024.d.ts","../../../../node_modules/typescript/lib/lib.es2025.d.ts","../../../../node_modules/typescript/lib/lib.esnext.d.ts","../../../../node_modules/typescript/lib/lib.dom.d.ts","../../../../node_modules/typescript/lib/lib.dom.iterable.d.ts","../../../../node_modules/typescript/lib/lib.dom.asynciterable.d.ts","../../../../node_modules/typescript/lib/lib.webworker.importscripts.d.ts","../../../../node_modules/typescript/lib/lib.scripthost.d.ts","../../../../node_modules/typescript/lib/lib.es2015.core.d.ts","../../../../node_modules/typescript/lib/lib.es2015.collection.d.ts","../../../../node_modules/typescript/lib/lib.es2015.generator.d.ts","../../../../node_modules/typescript/lib/lib.es2015.iterable.d.ts","../../../../node_modules/typescript/lib/lib.es2015.promise.d.ts","../../../../node_modules/typescript/lib/lib.es2015.proxy.d.ts","../../../../node_modules/typescript/lib/lib.es2015.reflect.d.ts","../../../../node_modules/typescript/lib/lib.es2015.symbol.d.ts","../../../../node_modules/typescript/lib/lib.es2015.symbol.wellknown.d.ts","../../../../node_modules/typescript/lib/lib.es2016.array.include.d.ts","../../../../node_modules/typescript/lib/lib.es2016.intl.d.ts","../../../../node_modules/typescript/lib/lib.es2017.arraybuffer.d.ts","../../../../node_modules/typescript/lib/lib.es2017.date.d.ts","../../../../node_modules/typescript/lib/lib.es2017.object.d.ts","../../../../node_modules/typescript/lib/lib.es2017.sharedmemory.d.ts","../../../../node_modules/typescript/lib/lib.es2017.string.d.ts","../../../../node_modules/typescript/lib/lib.es2017.intl.d.ts","../../../../node_modules/typescript/lib/lib.es2017.typedarrays.d.ts","../../../../node_modules/typescript/lib/lib.es2018.asyncgenerator.d.ts","../../../../node_modules/typescript/lib/lib.es2018.asynciterable.d.ts","../../../../node_modules/typescript/lib/lib.es2018.intl.d.ts","../../../../node_modules/typescript/lib/lib.es2018.promise.d.ts","../../../../node_modules/typescript/lib/lib.es2018.regexp.d.ts","../../../../node_modules/typescript/lib/lib.es2019.array.d.ts","../../../../node_modules/typescript/lib/lib.es2019.object.d.ts","../../../../node_modules/typescript/lib/lib.es2019.string.d.ts","../../../../node_modules/typescript/lib/lib.es2019.symbol.d.ts","../../../../node_modules/typescript/lib/lib.es2019.intl.d.ts","../../../../node_modules/typescript/lib/lib.es2020.bigint.d.ts","../../../../node_modules/typescript/lib/lib.es2020.date.d.ts","../../../../node_modules/typescript/lib/lib.es2020.promise.d.ts","../../../../node_modules/typescript/lib/lib.es2020.sharedmemory.d.ts","../../../../node_modules/typescript/lib/lib.es2020.string.d.ts","../../../../node_modules/typescript/lib/lib.es2020.symbol.wellknown.d.ts","../../../../node_modules/typescript/lib/lib.es2020.intl.d.ts","../../../../node_modules/typescript/lib/lib.es2020.number.d.ts","../../../../node_modules/typescript/lib/lib.es2021.promise.d.ts","../../../../node_modules/typescript/lib/lib.es2021.string.d.ts","../../../../node_modules/typescript/lib/lib.es2021.weakref.d.ts","../../../../node_modules/typescript/lib/lib.es2021.intl.d.ts","../../../../node_modules/typescript/lib/lib.es2022.array.d.ts","../../../../node_modules/typescript/lib/lib.es2022.error.d.ts","../../../../node_modules/typescript/lib/lib.es2022.intl.d.ts","../../../../node_modules/typescript/lib/lib.es2022.object.d.ts","../../../../node_modules/typescript/lib/lib.es2022.string.d.ts","../../../../node_modules/typescript/lib/lib.es2022.regexp.d.ts","../../../../node_modules/typescript/lib/lib.es2023.array.d.ts","../../../../node_modules/typescript/lib/lib.es2023.collection.d.ts","../../../../node_modules/typescript/lib/lib.es2023.intl.d.ts","../../../../node_modules/typescript/lib/lib.es2024.arraybuffer.d.ts","../../../../node_modules/typescript/lib/lib.es2024.collection.d.ts","../../../../node_modules/typescript/lib/lib.es2024.object.d.ts","../../../../node_modules/typescript/lib/lib.es2024.promise.d.ts","../../../../node_modules/typescript/lib/lib.es2024.regexp.d.ts","../../../../node_modules/typescript/lib/lib.es2024.sharedmemory.d.ts","../../../../node_modules/typescript/lib/lib.es2024.string.d.ts","../../../../node_modules/typescript/lib/lib.es2025.collection.d.ts","../../../../node_modules/typescript/lib/lib.es2025.float16.d.ts","../../../../node_modules/typescript/lib/lib.es2025.intl.d.ts","../../../../node_modules/typescript/lib/lib.es2025.iterator.d.ts","../../../../node_modules/typescript/lib/lib.es2025.promise.d.ts","../../../../node_modules/typescript/lib/lib.es2025.regexp.d.ts","../../../../node_modules/typescript/lib/lib.esnext.array.d.ts","../../../../node_modules/typescript/lib/lib.esnext.collection.d.ts","../../../../node_modules/typescript/lib/lib.esnext.date.d.ts","../../../../node_modules/typescript/lib/lib.esnext.decorators.d.ts","../../../../node_modules/typescript/lib/lib.esnext.disposable.d.ts","../../../../node_modules/typescript/lib/lib.esnext.error.d.ts","../../../../node_modules/typescript/lib/lib.esnext.intl.d.ts","../../../../node_modules/typescript/lib/lib.esnext.sharedmemory.d.ts","../../../../node_modules/typescript/lib/lib.esnext.temporal.d.ts","../../../../node_modules/typescript/lib/lib.esnext.typedarrays.d.ts","../../../../node_modules/typescript/lib/lib.decorators.d.ts","../../../../node_modules/typescript/lib/lib.decorators.legacy.d.ts","../../../../node_modules/typescript/lib/lib.esnext.full.d.ts","../src/index.ts"],"fileInfos":[{"version":"bcd24271a113971ba9eb71ff8cb01bc6b0f872a85c23fdbe5d93065b375933cd","affectsGlobalScope":true,"impliedFormat":1},{"version":"3f88bedbeb09c6f5a6645cb24c7c55f1aa22d19ae96c8e6959cbd8b85a707bc6","impliedFormat":1},{"version":"7fe93b39b810eadd916be8db880dd7f0f7012a5cc6ffb62de8f62a2117fa6f1f","impliedFormat":1},{"version":"bb0074cc08b84a2374af33d8bf044b80851ccc9e719a5e202eacf40db2c31600","impliedFormat":1},{"version":"1a7daebe4f45fb03d9ec53d60008fbf9ac45a697fdc89e4ce218bc94b94f94d6","impliedFormat":1},{"version":"f94b133a3cb14a288803be545ac2683e0d0ff6661bcd37e31aaaec54fc382aed","impliedFormat":1},{"version":"f59d0650799f8782fd74cf73c19223730c6d1b9198671b1c5b3a38e1188b5953","impliedFormat":1},{"version":"8a15b4607d9a499e2dbeed9ec0d3c0d7372c850b2d5f1fb259e8f6d41d468a84","impliedFormat":1},{"version":"26e0fe14baee4e127f4365d1ae0b276f400562e45e19e35fd2d4c296684715e6","impliedFormat":1},{"version":"1e9332c23e9a907175e0ffc6a49e236f97b48838cc8aec9ce7e4cec21e544b65","impliedFormat":1},{"version":"3753fbc1113dc511214802a2342280a8b284ab9094f6420e7aa171e868679f91","impliedFormat":1},{"version":"999ca32883495a866aa5737fe1babc764a469e4cde6ee6b136a4b9ae68853e4b","impliedFormat":1},{"version":"17f13ecb98cbc39243f2eee1f16d45cd8ec4706b03ee314f1915f1a8b42f6984","impliedFormat":1},{"version":"d6b1eba8496bdd0eed6fc8a685768fe01b2da4a0388b5fe7df558290bffcf32f","affectsGlobalScope":true,"impliedFormat":1},{"version":"7f57fc4404ff020bc45b9c620aff2b40f700b95fe31164024c453a5e3c163c54","impliedFormat":1},{"version":"7f57fc4404ff020bc45b9c620aff2b40f700b95fe31164024c453a5e3c163c54","impliedFormat":1},{"version":"2a2de5b9459b3fc44decd9ce6100b72f1b002ef523126c1d3d8b2a4a63d74d78","affectsGlobalScope":true,"impliedFormat":1},{"version":"f13f4b465c99041e912db5c44129a94588e1aafee35a50eab51044833f50b4ee","affectsGlobalScope":true,"impliedFormat":1},{"version":"eadcffda2aa84802c73938e589b9e58248d74c59cb7fcbca6474e3435ac15504","affectsGlobalScope":true,"impliedFormat":1},{"version":"105ba8ff7ba746404fe1a2e189d1d3d2e0eb29a08c18dded791af02f29fb4711","affectsGlobalScope":true,"impliedFormat":1},{"version":"00343ca5b2e3d48fa5df1db6e32ea2a59afab09590274a6cccb1dbae82e60c7c","affectsGlobalScope":true,"impliedFormat":1},{"version":"ebd9f816d4002697cb2864bea1f0b70a103124e18a8cd9645eeccc09bdf80ab4","affectsGlobalScope":true,"impliedFormat":1},{"version":"2c1afac30a01772cd2a9a298a7ce7706b5892e447bb46bdbeef720f7b5da77ad","affectsGlobalScope":true,"impliedFormat":1},{"version":"7b0225f483e4fa685625ebe43dd584bb7973bbd84e66a6ba7bbe175ee1048b4f","affectsGlobalScope":true,"impliedFormat":1},{"version":"c0a4b8ac6ce74679c1da2b3795296f5896e31c38e888469a8e0f99dc3305de60","affectsGlobalScope":true,"impliedFormat":1},{"version":"3084a7b5f569088e0146533a00830e206565de65cae2239509168b11434cd84f","affectsGlobalScope":true,"impliedFormat":1},{"version":"c5079c53f0f141a0698faa903e76cb41cd664e3efb01cc17a5c46ec2eb0bef42","affectsGlobalScope":true,"impliedFormat":1},{"version":"32cafbc484dea6b0ab62cf8473182bbcb23020d70845b406f80b7526f38ae862","affectsGlobalScope":true,"impliedFormat":1},{"version":"fca4cdcb6d6c5ef18a869003d02c9f0fd95df8cfaf6eb431cd3376bc034cad36","affectsGlobalScope":true,"impliedFormat":1},{"version":"b93ec88115de9a9dc1b602291b85baf825c85666bf25985cc5f698073892b467","affectsGlobalScope":true,"impliedFormat":1},{"version":"f5c06dcc3fe849fcb297c247865a161f995cc29de7aa823afdd75aaaddc1419b","affectsGlobalScope":true,"impliedFormat":1},{"version":"b77e16112127a4b169ef0b8c3a4d730edf459c5f25fe52d5e436a6919206c4d7","affectsGlobalScope":true,"impliedFormat":1},{"version":"fbffd9337146eff822c7c00acbb78b01ea7ea23987f6c961eba689349e744f8c","affectsGlobalScope":true,"impliedFormat":1},{"version":"a995c0e49b721312f74fdfb89e4ba29bd9824c770bbb4021d74d2bf560e4c6bd","affectsGlobalScope":true,"impliedFormat":1},{"version":"c7b3542146734342e440a84b213384bfa188835537ddbda50d30766f0593aff9","affectsGlobalScope":true,"impliedFormat":1},{"version":"ce6180fa19b1cccd07ee7f7dbb9a367ac19c0ed160573e4686425060b6df7f57","affectsGlobalScope":true,"impliedFormat":1},{"version":"3f02e2476bccb9dbe21280d6090f0df17d2f66b74711489415a8aa4df73c9675","affectsGlobalScope":true,"impliedFormat":1},{"version":"45e3ab34c1c013c8ab2dc1ba4c80c780744b13b5676800ae2e3be27ae862c40c","affectsGlobalScope":true,"impliedFormat":1},{"version":"805c86f6cca8d7702a62a844856dbaa2a3fd2abef0536e65d48732441dde5b5b","affectsGlobalScope":true,"impliedFormat":1},{"version":"e42e397f1a5a77994f0185fd1466520691456c772d06bf843e5084ceb879a0ad","affectsGlobalScope":true,"impliedFormat":1},{"version":"f4c2b41f90c95b1c532ecc874bd3c111865793b23aebcc1c3cbbabcd5d76ffb0","affectsGlobalScope":true,"impliedFormat":1},{"version":"ab26191cfad5b66afa11b8bf935ef1cd88fabfcb28d30b2dfa6fad877d050332","affectsGlobalScope":true,"impliedFormat":1},{"version":"2088bc26531e38fb05eedac2951480db5309f6be3fa4a08d2221abb0f5b4200d","affectsGlobalScope":true,"impliedFormat":1},{"version":"cb9d366c425fea79716a8fb3af0d78e6b22ebbab3bd64d25063b42dc9f531c1e","affectsGlobalScope":true,"impliedFormat":1},{"version":"500934a8089c26d57ebdb688fc9757389bb6207a3c8f0674d68efa900d2abb34","affectsGlobalScope":true,"impliedFormat":1},{"version":"689da16f46e647cef0d64b0def88910e818a5877ca5379ede156ca3afb780ac3","affectsGlobalScope":true,"impliedFormat":1},{"version":"bc21cc8b6fee4f4c2440d08035b7ea3c06b3511314c8bab6bef7a92de58a2593","affectsGlobalScope":true,"impliedFormat":1},{"version":"7ca53d13d2957003abb47922a71866ba7cb2068f8d154877c596d63c359fed25","affectsGlobalScope":true,"impliedFormat":1},{"version":"54725f8c4df3d900cb4dac84b64689ce29548da0b4e9b7c2de61d41c79293611","affectsGlobalScope":true,"impliedFormat":1},{"version":"e5594bc3076ac29e6c1ebda77939bc4c8833de72f654b6e376862c0473199323","affectsGlobalScope":true,"impliedFormat":1},{"version":"2f3eb332c2d73e729f3364fcc0c2b375e72a121e8157d25a82d67a138c83a95c","affectsGlobalScope":true,"impliedFormat":1},{"version":"6f4427f9642ce8d500970e4e69d1397f64072ab73b97e476b4002a646ac743b1","affectsGlobalScope":true,"impliedFormat":1},{"version":"48915f327cd1dea4d7bd358d9dc7732f58f9e1626a29cc0c05c8c692419d9bb7","affectsGlobalScope":true,"impliedFormat":1},{"version":"b7bf9377723203b5a6a4b920164df22d56a43f593269ba6ae1fdc97774b68855","affectsGlobalScope":true,"impliedFormat":1},{"version":"db9709688f82c9e5f65a119c64d835f906efe5f559d08b11642d56eb85b79357","affectsGlobalScope":true,"impliedFormat":1},{"version":"4b25b8c874acd1a4cf8444c3617e037d444d19080ac9f634b405583fd10ce1f7","affectsGlobalScope":true,"impliedFormat":1},{"version":"37be57d7c90cf1f8112ee2636a068d8fd181289f82b744160ec56a7dc158a9f5","affectsGlobalScope":true,"impliedFormat":1},{"version":"a917a49ac94cd26b754ab84e113369a75d1a47a710661d7cd25e961cc797065f","affectsGlobalScope":true,"impliedFormat":1},{"version":"6d3261badeb7843d157ef3e6f5d1427d0eeb0af0cf9df84a62cfd29fd47ac86e","affectsGlobalScope":true,"impliedFormat":1},{"version":"195daca651dde22f2167ac0d0a05e215308119a3100f5e6268e8317d05a92526","affectsGlobalScope":true,"impliedFormat":1},{"version":"8b11e4285cd2bb164a4dc09248bdec69e9842517db4ca47c1ba913011e44ff2f","affectsGlobalScope":true,"impliedFormat":1},{"version":"0508571a52475e245b02bc50fa1394065a0a3d05277fbf5120c3784b85651799","affectsGlobalScope":true,"impliedFormat":1},{"version":"8f9af488f510c3015af3cc8c267a9e9d96c4dd38a1fdff0e11dc5a544711415b","affectsGlobalScope":true,"impliedFormat":1},{"version":"fc611fea8d30ea72c6bbfb599c9b4d393ce22e2f5bfef2172534781e7d138104","affectsGlobalScope":true,"impliedFormat":1},{"version":"0bd714129fca875f7d4c477a1a392200b0bcd13fb2e80928cd334b63830ea047","affectsGlobalScope":true,"impliedFormat":1},{"version":"e2c9037ae6cd2c52d80ceef0b3c5ffdb488627d71529cf4f63776daf11161c9a","affectsGlobalScope":true,"impliedFormat":1},{"version":"135d5cf4d345f59f1a9caadfafcd858d3d9cc68290db616cc85797224448cccc","affectsGlobalScope":true,"impliedFormat":1},{"version":"bc238c3f81c2984751932b6aab223cd5b830e0ac6cad76389e5e9d2ffc03287d","affectsGlobalScope":true,"impliedFormat":1},{"version":"4a07f9b76d361f572620927e5735b77d6d2101c23cdd94383eb5b706e7b36357","affectsGlobalScope":true,"impliedFormat":1},{"version":"7c4e8dc6ab834cc6baa0227e030606d29e3e8449a9f67cdf5605ea5493c4db29","affectsGlobalScope":true,"impliedFormat":1},{"version":"de7ba0fd02e06cd9a5bd4ab441ed0e122735786e67dde1e849cced1cd8b46b78","affectsGlobalScope":true,"impliedFormat":1},{"version":"6148e4e88d720a06855071c3db02069434142a8332cf9c182cda551adedf3156","affectsGlobalScope":true,"impliedFormat":1},{"version":"d63dba625b108316a40c95a4425f8d4294e0deeccfd6c7e59d819efa19e23409","affectsGlobalScope":true,"impliedFormat":1},{"version":"0568d6befee03dd435bed4fc25c4e46865b24bdcb8c563fdc21f580a2c301904","affectsGlobalScope":true,"impliedFormat":1},{"version":"30d62269b05b584741f19a5369852d5d34895aa2ac4fd948956f886d15f9cc0d","affectsGlobalScope":true,"impliedFormat":1},{"version":"f128dae7c44d8f35ee42e0a437000a57c9f06cc04f8b4fb42eebf44954d53dc8","affectsGlobalScope":true,"impliedFormat":1},{"version":"ffbe6d7b295306b2ba88030f65b74c107d8d99bdcf596ea99c62a02f606108b0","affectsGlobalScope":true,"impliedFormat":1},{"version":"996fb27b15277369c68a4ba46ed138b4e9e839a02fb4ec756f7997629242fd9f","affectsGlobalScope":true,"impliedFormat":1},{"version":"79b712591b270d4778c89706ca2cfc56ddb8c3f895840e477388f1710dc5eda9","affectsGlobalScope":true,"impliedFormat":1},{"version":"20884846cef428b992b9bd032e70a4ef88e349263f63aeddf04dda837a7dba26","affectsGlobalScope":true,"impliedFormat":1},{"version":"5fcab789c73a97cd43828ee3cc94a61264cf24d4c44472ce64ced0e0f148bdb2","affectsGlobalScope":true,"impliedFormat":1},{"version":"db59a81f070c1880ad645b2c0275022baa6a0c4f0acdc58d29d349c6efcf0903","affectsGlobalScope":true,"impliedFormat":1},{"version":"673294292640f5722b700e7d814e17aaf7d93f83a48a2c9b38f33cbc940ad8b0","affectsGlobalScope":true,"impliedFormat":1},{"version":"d786b48f934cbca483b3c6d0a798cb43bbb4ada283e76fb22c28e53ae05b9e69","affectsGlobalScope":true,"impliedFormat":1},{"version":"1ecb8e347cb6b2a8927c09b86263663289418df375f5e68e11a0ae683776978f","affectsGlobalScope":true,"impliedFormat":1},{"version":"142efd4ce210576f777dc34df121777be89eda476942d6d6663b03dcb53be3ff","affectsGlobalScope":true,"impliedFormat":1},{"version":"379bc41580c2d774f82e828c70308f24a005b490c25ba34d679d84bcf05c3d9d","affectsGlobalScope":true,"impliedFormat":1},{"version":"ed484fb2aa8a1a23d0277056ec3336e0a0b52f9b8d6a961f338a642faf43235d","affectsGlobalScope":true,"impliedFormat":1},{"version":"4ffedae1d1c2d53fdbca1c96d3c7dda544281f7d262f99b6880634f8fd8d9820","affectsGlobalScope":true,"impliedFormat":1},{"version":"83a730b125d477dd264df8ba479afab27a3dae7152b005c214ab94dc7ee44fd3","affectsGlobalScope":true,"impliedFormat":1},{"version":"1ce14b81c5cc821994aa8ec1d42b220dd41b27fcc06373bce3958af7421b77d4","affectsGlobalScope":true,"impliedFormat":1},{"version":"b3a048b3e9302ef9a34ef4ebb9aecfb28b66abb3bce577206a79fee559c230da","affectsGlobalScope":true,"impliedFormat":1},{"version":"ef4a897cd2a3f91000c10264e400b3667c7e51e1b7365f03b62e8081dc53bde6","impliedFormat":1},{"version":"6be8a27016e6c12deef9d45a9c5349dacc2b46dab2f3b2f4eed56ce3a0ba7e02","signature":"6b8091108ad58d10b0bd314d33d73ca1d0f4d5a6db9a688ed78da95265b15516"}],"root":[94],"options":{"allowImportingTsExtensions":false,"composite":true,"declaration":true,"declarationDir":"./types","experimentalDecorators":true,"module":99,"outDir":"./esm","rootDir":"../src","skipLibCheck":true,"strict":true,"target":99},"latestChangedDtsFile":"./types/index.d.ts","version":"6.0.3"}

package/lib/types/index.d.ts

@@ -0,0 +1,33 @@
+export type ReleaseType = "major" | "minor" | "patch";
+export declare function parse(version: string): SemVer | null;
+export declare function valid(version: string): string | null;
+export declare function compare(a: string | SemVer, b: string | SemVer): -1 | 0 | 1;
+export declare function satisfies(version: string | SemVer, range: string | Range): boolean;
+export declare function maxSatisfying(versions: ReadonlyArray<string>, range: string | Range): string | null;
+export declare function minSatisfying(versions: ReadonlyArray<string>, range: string | Range): string | null;
+export declare function validRange(range: string): string | null;
+export declare class SemVer {
+    readonly major: number;
+    readonly minor: number;
+    readonly patch: number;
+    readonly prerelease: ReadonlyArray<string | number>;
+    readonly build: ReadonlyArray<string>;
+    readonly version: string;
+    constructor(version: string);
+    compare(other: SemVer): -1 | 0 | 1;
+    comparePre(other: SemVer): -1 | 0 | 1;
+    toString(): string;
+}
+interface Comparator {
+    operator: "" | "<" | ">" | "<=" | ">=" | "=";
+    semver: SemVer | null;
+}
+export declare class Range {
+    readonly raw: string;
+    readonly set: ReadonlyArray<ReadonlyArray<Comparator>>;
+    constructor(range: string | Range);
+    test(version: SemVer | string): boolean;
+    format(): string;
+    toString(): string;
+}
+export {};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@gjsify/semver",
+  "version": "0.3.8",
+  "description": "Subset of node-semver for the gjsify install backend — cross-platform Node + GJS",
+  "type": "module",
+  "module": "lib/esm/index.js",
+  "main": "lib/esm/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/esm/index.js"
+    }
+  },
+  "scripts": {
+    "clear": "rm -rf lib tsconfig.tsbuildinfo test.gjs.mjs test.node.mjs || exit 0",
+    "check": "tsc --noEmit",
+    "build": "yarn build:gjsify && yarn build:types",
+    "build:gjsify": "gjsify build --library 'src/**/*.{ts,js}' --exclude 'src/**/*.spec.{mts,ts}' 'src/test.mts'",
+    "build:types": "tsc -p tsconfig.build.json",
+    "build:test": "yarn build:test:gjs && yarn build:test:node",
+    "build:test:gjs": "gjsify build src/test.mts --app gjs --outfile test.gjs.mjs",
+    "build:test:node": "gjsify build src/test.mts --app node --outfile test.node.mjs",
+    "test": "yarn build:gjsify && yarn build:test && yarn test:node && yarn test:gjs",
+    "test:gjs": "gjsify run test.gjs.mjs",
+    "test:node": "node test.node.mjs"
+  },
+  "keywords": [
+    "gjs",
+    "node",
+    "semver",
+    "install"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@gjsify/cli": "^0.3.8",
+    "@gjsify/unit": "^0.3.8",
+    "typescript": "^6.0.3"
+  }
+}

package/src/index.spec.ts

@@ -0,0 +1,197 @@
+import { describe, it, expect } from "@gjsify/unit";
+import {
+    SemVer,
+    Range,
+    parse,
+    valid,
+    compare,
+    satisfies,
+    maxSatisfying,
+    minSatisfying,
+    validRange,
+} from "./index.js";
+
+export default async () => {
+    await describe("@gjsify/semver — SemVer", async () => {
+        await it("parses major.minor.patch", async () => {
+            const v = new SemVer("1.2.3");
+            expect(v.major).toBe(1);
+            expect(v.minor).toBe(2);
+            expect(v.patch).toBe(3);
+            expect(v.version).toBe("1.2.3");
+        });
+
+        await it("parses prerelease + build", async () => {
+            const v = new SemVer("1.2.3-alpha.1+build.7");
+            expect(v.prerelease.length).toBe(2);
+            expect(v.prerelease[0]).toBe("alpha");
+            expect(v.prerelease[1]).toBe(1);
+            expect(v.build[0]).toBe("build");
+            expect(v.version).toBe("1.2.3-alpha.1+build.7");
+        });
+
+        await it("strips leading v", async () => {
+            expect(new SemVer("v1.2.3").version).toBe("1.2.3");
+        });
+
+        await it("rejects garbage", async () => {
+            expect(parse("not-a-version")).toBeNull();
+            expect(parse("1.2")).toBeNull();
+            expect(valid("1.2.3.4")).toBeNull();
+        });
+
+        await it("compares major/minor/patch", async () => {
+            expect(compare("1.0.0", "2.0.0")).toBe(-1);
+            expect(compare("1.2.3", "1.2.3")).toBe(0);
+            expect(compare("1.2.10", "1.2.9")).toBe(1);
+        });
+
+        await it("non-prerelease > any prerelease", async () => {
+            expect(compare("1.0.0", "1.0.0-alpha")).toBe(1);
+            expect(compare("1.0.0-alpha", "1.0.0")).toBe(-1);
+        });
+
+        await it("compares prerelease tags by parts (numeric < alpha)", async () => {
+            expect(compare("1.0.0-alpha", "1.0.0-alpha.1")).toBe(-1);
+            expect(compare("1.0.0-alpha.1", "1.0.0-alpha.2")).toBe(-1);
+            expect(compare("1.0.0-alpha.10", "1.0.0-alpha.9")).toBe(1);
+            expect(compare("1.0.0-alpha", "1.0.0-beta")).toBe(-1);
+            expect(compare("1.0.0-1", "1.0.0-alpha")).toBe(-1); // numeric < alpha
+        });
+    });
+
+    await describe("@gjsify/semver — Range", async () => {
+        await it("caret narrows on 0.x.y", async () => {
+            const r = new Range("^0.3.7");
+            expect(r.test(new SemVer("0.3.7"))).toBe(true);
+            expect(r.test(new SemVer("0.3.99"))).toBe(true);
+            expect(r.test(new SemVer("0.4.0"))).toBe(false);
+            expect(r.test(new SemVer("0.3.6"))).toBe(false);
+        });
+
+        await it("caret on >=1 keeps the major", async () => {
+            const r = new Range("^1.2.3");
+            expect(r.test("1.2.3")).toBe(true);
+            expect(r.test("1.999.999")).toBe(true);
+            expect(r.test("2.0.0")).toBe(false);
+            expect(r.test("1.2.2")).toBe(false);
+        });
+
+        await it("caret 0.0.x is exact", async () => {
+            const r = new Range("^0.0.3");
+            expect(r.test("0.0.3")).toBe(true);
+            expect(r.test("0.0.4")).toBe(false);
+        });
+
+        await it("tilde", async () => {
+            const r = new Range("~1.2.3");
+            expect(r.test("1.2.3")).toBe(true);
+            expect(r.test("1.2.99")).toBe(true);
+            expect(r.test("1.3.0")).toBe(false);
+            expect(r.test("1.2.2")).toBe(false);
+        });
+
+        await it("x-ranges", async () => {
+            expect(satisfies("1.2.3", "1.x")).toBe(true);
+            expect(satisfies("2.0.0", "1.x")).toBe(false);
+            expect(satisfies("1.2.99", "1.2.x")).toBe(true);
+            expect(satisfies("1.3.0", "1.2.x")).toBe(false);
+        });
+
+        await it("primitives", async () => {
+            expect(satisfies("1.2.3", ">=1.0.0 <2.0.0")).toBe(true);
+            expect(satisfies("2.0.0", ">=1.0.0 <2.0.0")).toBe(false);
+            expect(satisfies("1.2.3", ">1.2.2")).toBe(true);
+            expect(satisfies("1.2.2", ">1.2.2")).toBe(false);
+            expect(satisfies("1.2.3", "<=1.2.3")).toBe(true);
+        });
+
+        await it("primitives on partial RHS", async () => {
+            expect(satisfies("2.0.0", ">1")).toBe(true);
+            expect(satisfies("1.5.0", ">1")).toBe(false);
+            expect(satisfies("0.9.0", "<1")).toBe(true);
+            expect(satisfies("1.0.0", "<1")).toBe(false);
+            expect(satisfies("1.9.9", "<=1")).toBe(true);
+            expect(satisfies("2.0.0", "<=1")).toBe(false);
+        });
+
+        await it("hyphen ranges", async () => {
+            const r = new Range("1.2.3 - 2.3.4");
+            expect(r.test("1.2.3")).toBe(true);
+            expect(r.test("2.0.0")).toBe(true);
+            expect(r.test("2.3.4")).toBe(true);
+            expect(r.test("2.3.5")).toBe(false);
+            expect(r.test("1.2.2")).toBe(false);
+        });
+
+        await it("partial hyphen RHS extends", async () => {
+            const r = new Range("1.2.3 - 2.3");
+            expect(r.test("2.3.99")).toBe(true);
+            expect(r.test("2.4.0")).toBe(false);
+        });
+
+        await it("OR sets", async () => {
+            const r = new Range("^1.0.0 || ^2.0.0");
+            expect(r.test("1.5.0")).toBe(true);
+            expect(r.test("2.5.0")).toBe(true);
+            expect(r.test("3.0.0")).toBe(false);
+        });
+
+        await it("star/* matches anything stable", async () => {
+            expect(satisfies("0.0.0", "*")).toBe(true);
+            expect(satisfies("99.99.99", "*")).toBe(true);
+        });
+
+        await it("rejects prereleases unless explicitly mentioned", async () => {
+            expect(satisfies("1.2.3-alpha", ">=1.0.0")).toBe(false);
+            expect(satisfies("1.2.3-alpha", ">=1.2.3-alpha")).toBe(true);
+            expect(satisfies("1.2.3-beta", ">=1.2.3-alpha")).toBe(true);
+            // Different mmp tuple — not eligible.
+            expect(satisfies("1.3.0-beta", ">=1.2.3-alpha")).toBe(false);
+        });
+
+        await it("validRange formats / rejects garbage", async () => {
+            expect(validRange("^1.2.3")).toBe(">=1.2.3 <2.0.0");
+            expect(validRange("not-a-range !!")).toBeNull();
+        });
+    });
+
+    await describe("@gjsify/semver — maxSatisfying / minSatisfying", async () => {
+        const versions = [
+            "0.0.1",
+            "0.1.0",
+            "0.3.6",
+            "0.3.7",
+            "0.3.7-rc.1",
+            "1.0.0",
+            "1.2.3",
+            "2.0.0-rc.1",
+            "2.0.0",
+        ];
+
+        await it("maxSatisfying ^0.3.0", async () => {
+            expect(maxSatisfying(versions, "^0.3.0")).toBe("0.3.7");
+        });
+
+        await it("maxSatisfying ^1.0.0", async () => {
+            expect(maxSatisfying(versions, "^1.0.0")).toBe("1.2.3");
+        });
+
+        await it("maxSatisfying *", async () => {
+            expect(maxSatisfying(versions, "*")).toBe("2.0.0");
+        });
+
+        await it("minSatisfying >=1", async () => {
+            expect(minSatisfying(versions, ">=1")).toBe("1.0.0");
+        });
+
+        await it("returns null for empty match", async () => {
+            expect(maxSatisfying(versions, "^9.0.0")).toBeNull();
+            expect(minSatisfying([], "*")).toBeNull();
+        });
+
+        await it("ignores invalid version strings", async () => {
+            expect(maxSatisfying(["1.0.0", "garbage", "1.1.0"], "^1.0.0")).toBe("1.1.0");
+        });
+    });
+};

package/src/index.ts

@@ -0,0 +1,386 @@
+// SemVer - subset of node-semver for the gjsify install backend.
+// Implements parse, compare, satisfies, maxSatisfying, minSatisfying, and Range
+// for caret/tilde/hyphen/x/star/comparator/OR ranges.
+// Reference: https://semver.org/spec/v2.0.0.html and refs/npm-cli/.../semver/.
+
+const NUM_RE = /^(0|[1-9]\d*)$/;
+const SEMVER_RE =
+    /^(\d+)\.(\d+)\.(\d+)(?:-((?:[0-9A-Za-z-]+)(?:\.[0-9A-Za-z-]+)*))?(?:\+([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?$/;
+
+export type ReleaseType = "major" | "minor" | "patch";
+
+export function parse(version: string): SemVer | null {
+    try {
+        return new SemVer(version);
+    } catch {
+        return null;
+    }
+}
+
+export function valid(version: string): string | null {
+    const v = parse(version);
+    return v ? v.version : null;
+}
+
+export function compare(a: string | SemVer, b: string | SemVer): -1 | 0 | 1 {
+    const av = a instanceof SemVer ? a : new SemVer(a);
+    const bv = b instanceof SemVer ? b : new SemVer(b);
+    return av.compare(bv);
+}
+
+export function satisfies(version: string | SemVer, range: string | Range): boolean {
+    const r = range instanceof Range ? range : new Range(range);
+    const v = version instanceof SemVer ? version : parse(String(version));
+    if (!v) return false;
+    return r.test(v);
+}
+
+export function maxSatisfying(versions: ReadonlyArray<string>, range: string | Range): string | null {
+    const r = range instanceof Range ? range : new Range(range);
+    let best: SemVer | null = null;
+    for (const raw of versions) {
+        const v = parse(raw);
+        if (!v || !r.test(v)) continue;
+        if (best === null || v.compare(best) > 0) best = v;
+    }
+    return best ? best.version : null;
+}
+
+export function minSatisfying(versions: ReadonlyArray<string>, range: string | Range): string | null {
+    const r = range instanceof Range ? range : new Range(range);
+    let best: SemVer | null = null;
+    for (const raw of versions) {
+        const v = parse(raw);
+        if (!v || !r.test(v)) continue;
+        if (best === null || v.compare(best) < 0) best = v;
+    }
+    return best ? best.version : null;
+}
+
+export function validRange(range: string): string | null {
+    try {
+        return new Range(range).format();
+    } catch {
+        return null;
+    }
+}
+
+export class SemVer {
+    readonly major: number;
+    readonly minor: number;
+    readonly patch: number;
+    readonly prerelease: ReadonlyArray<string | number>;
+    readonly build: ReadonlyArray<string>;
+    readonly version: string;
+
+    constructor(version: string) {
+        const trimmed = String(version).trim().replace(/^v/, "");
+        const m = SEMVER_RE.exec(trimmed);
+        if (!m) throw new TypeError(`Invalid Version: ${version}`);
+        this.major = Number(m[1]);
+        this.minor = Number(m[2]);
+        this.patch = Number(m[3]);
+        this.prerelease = m[4]
+            ? m[4].split(".").map((id) => (NUM_RE.test(id) ? Number(id) : id))
+            : [];
+        this.build = m[5] ? m[5].split(".") : [];
+        this.version =
+            `${this.major}.${this.minor}.${this.patch}` +
+            (this.prerelease.length ? `-${this.prerelease.join(".")}` : "") +
+            (this.build.length ? `+${this.build.join(".")}` : "");
+    }
+
+    compare(other: SemVer): -1 | 0 | 1 {
+        if (this.major !== other.major) return this.major < other.major ? -1 : 1;
+        if (this.minor !== other.minor) return this.minor < other.minor ? -1 : 1;
+        if (this.patch !== other.patch) return this.patch < other.patch ? -1 : 1;
+        return this.comparePre(other);
+    }
+
+    comparePre(other: SemVer): -1 | 0 | 1 {
+        const a = this.prerelease;
+        const b = other.prerelease;
+        if (a.length === 0 && b.length === 0) return 0;
+        if (a.length === 0) return 1;
+        if (b.length === 0) return -1;
+        for (let i = 0; ; i++) {
+            const x = a[i];
+            const y = b[i];
+            if (x === undefined && y === undefined) return 0;
+            if (y === undefined) return 1;
+            if (x === undefined) return -1;
+            if (x === y) continue;
+            const xn = typeof x === "number";
+            const yn = typeof y === "number";
+            if (xn && !yn) return -1;
+            if (!xn && yn) return 1;
+            return x < y ? -1 : 1;
+        }
+    }
+
+    toString(): string {
+        return this.version;
+    }
+}
+
+interface Comparator {
+    operator: "" | "<" | ">" | "<=" | ">=" | "=";
+    semver: SemVer | null;
+}
+
+export class Range {
+    readonly raw: string;
+    readonly set: ReadonlyArray<ReadonlyArray<Comparator>>;
+
+    constructor(range: string | Range) {
+        if (range instanceof Range) {
+            this.raw = range.raw;
+            this.set = range.set;
+            return;
+        }
+        this.raw = String(range).trim();
+        const sets = this.raw.split(/\s*\|\|\s*/);
+        const parsed: Comparator[][] = [];
+        for (const part of sets) {
+            const c = parseRangePart(part);
+            if (c.length === 0) {
+                throw new TypeError(`Invalid range: ${this.raw}`);
+            }
+            parsed.push(c);
+        }
+        if (parsed.length === 0) {
+            throw new TypeError(`Invalid range: ${this.raw}`);
+        }
+        this.set = parsed;
+    }
+
+    test(version: SemVer | string): boolean {
+        const v = version instanceof SemVer ? version : parse(String(version));
+        if (!v) return false;
+        for (const conj of this.set) {
+            if (conj.every((c) => testComparator(c, v))) {
+                if (v.prerelease.length > 0) {
+                    const allowed = conj.some(
+                        (c) =>
+                            c.semver !== null &&
+                            c.semver.prerelease.length > 0 &&
+                            c.semver.major === v.major &&
+                            c.semver.minor === v.minor &&
+                            c.semver.patch === v.patch,
+                    );
+                    if (!allowed) continue;
+                }
+                return true;
+            }
+        }
+        return false;
+    }
+
+    format(): string {
+        return this.set.map((c) => c.map(formatComparator).join(" ")).join(" || ");
+    }
+
+    toString(): string {
+        return this.format();
+    }
+}
+
+function testComparator(c: Comparator, v: SemVer): boolean {
+    if (c.semver === null) return true;
+    const cmp = v.compare(c.semver);
+    switch (c.operator) {
+        case "":
+        case "=":
+            return cmp === 0;
+        case "<":
+            return cmp < 0;
+        case "<=":
+            return cmp <= 0;
+        case ">":
+            return cmp > 0;
+        case ">=":
+            return cmp >= 0;
+    }
+}
+
+function formatComparator(c: Comparator): string {
+    if (c.semver === null) return "*";
+    return `${c.operator}${c.semver.version}`;
+}
+
+function parseRangePart(part: string): Comparator[] {
+    const trimmed = part.trim();
+    if (trimmed === "" || trimmed === "*" || trimmed.toLowerCase() === "latest") {
+        return [{ operator: ">=", semver: new SemVer("0.0.0") }];
+    }
+    const hyphen = trimmed.match(/^\s*(\S+)\s+-\s+(\S+)\s*$/);
+    if (hyphen) return hyphenRange(hyphen[1], hyphen[2]);
+    const tokens = trimmed.split(/\s+/);
+    const out: Comparator[] = [];
+    for (const tok of tokens) out.push(...parseSimple(tok));
+    return out;
+}
+
+function parseSimple(tok: string): Comparator[] {
+    if (tok === "*" || tok === "" || tok.toLowerCase() === "latest") {
+        return [{ operator: ">=", semver: new SemVer("0.0.0") }];
+    }
+    if (tok.startsWith("^")) return caretRange(tok.slice(1));
+    if (tok.startsWith("~")) return tildeRange(tok.slice(1).replace(/^>/, ""));
+    const opMatch = tok.match(/^(<=|>=|<|>|=)\s*(.+)$/);
+    if (opMatch) {
+        const op = opMatch[1] as Comparator["operator"];
+        return primitiveRange(op, opMatch[2]);
+    }
+    return partialRange(tok);
+}
+
+interface PartialVersion {
+    major: number | null;
+    minor: number | null;
+    patch: number | null;
+    pre: string;
+    build: string;
+}
+
+function parsePartial(s: string): PartialVersion {
+    const trimmed = s.trim().replace(/^v/, "");
+    if (trimmed === "" || trimmed === "*") {
+        return { major: null, minor: null, patch: null, pre: "", build: "" };
+    }
+    let pre = "";
+    let build = "";
+    let core = trimmed;
+    const plus = core.indexOf("+");
+    if (plus >= 0) {
+        build = core.slice(plus + 1);
+        core = core.slice(0, plus);
+    }
+    const dash = core.indexOf("-");
+    if (dash >= 0) {
+        pre = core.slice(dash + 1);
+        core = core.slice(0, dash);
+    }
+    const parts = core.split(".");
+    const xr = (part: string | undefined): number | null => {
+        if (part === undefined || part === "") return null;
+        if (part === "x" || part === "X" || part === "*") return null;
+        if (!/^\d+$/.test(part)) {
+            throw new TypeError(`Invalid partial version: ${s}`);
+        }
+        return Number(part);
+    };
+    return {
+        major: xr(parts[0]),
+        minor: xr(parts[1]),
+        patch: xr(parts[2]),
+        pre,
+        build,
+    };
+}
+
+function partialToVersion(p: PartialVersion): string {
+    return `${p.major ?? 0}.${p.minor ?? 0}.${p.patch ?? 0}${p.pre ? `-${p.pre}` : ""}${
+        p.build ? `+${p.build}` : ""
+    }`;
+}
+
+function partialRange(tok: string): Comparator[] {
+    const p = parsePartial(tok);
+    if (p.major === null) return [{ operator: ">=", semver: new SemVer("0.0.0") }];
+    if (p.minor === null) {
+        return [
+            { operator: ">=", semver: new SemVer(`${p.major}.0.0`) },
+            { operator: "<", semver: new SemVer(`${p.major + 1}.0.0`) },
+        ];
+    }
+    if (p.patch === null) {
+        return [
+            { operator: ">=", semver: new SemVer(`${p.major}.${p.minor}.0`) },
+            { operator: "<", semver: new SemVer(`${p.major}.${p.minor + 1}.0`) },
+        ];
+    }
+    return [{ operator: "=", semver: new SemVer(partialToVersion(p)) }];
+}
+
+function caretRange(tok: string): Comparator[] {
+    const p = parsePartial(tok);
+    if (p.major === null) return [{ operator: ">=", semver: new SemVer("0.0.0") }];
+    const lower = `${p.major}.${p.minor ?? 0}.${p.patch ?? 0}${p.pre ? `-${p.pre}` : ""}`;
+    let upper: string;
+    if (p.major > 0 || p.minor === null) {
+        upper = `${p.major + 1}.0.0`;
+    } else if (p.minor > 0 || p.patch === null) {
+        upper = `0.${p.minor + 1}.0`;
+    } else {
+        upper = `0.0.${p.patch + 1}`;
+    }
+    return [
+        { operator: ">=", semver: new SemVer(lower) },
+        { operator: "<", semver: new SemVer(upper) },
+    ];
+}
+
+function tildeRange(tok: string): Comparator[] {
+    const p = parsePartial(tok);
+    if (p.major === null) return [{ operator: ">=", semver: new SemVer("0.0.0") }];
+    const lower = `${p.major}.${p.minor ?? 0}.${p.patch ?? 0}${p.pre ? `-${p.pre}` : ""}`;
+    const upper =
+        p.minor === null
+            ? `${p.major + 1}.0.0`
+            : `${p.major}.${p.minor + 1}.0`;
+    return [
+        { operator: ">=", semver: new SemVer(lower) },
+        { operator: "<", semver: new SemVer(upper) },
+    ];
+}
+
+function primitiveRange(op: Comparator["operator"], rhs: string): Comparator[] {
+    const p = parsePartial(rhs);
+    if (p.major === null) return [{ operator: ">=", semver: new SemVer("0.0.0") }];
+    if (op === "=" || op === "") return partialRange(rhs);
+    if (op === ">") {
+        if (p.minor === null) return [{ operator: ">=", semver: new SemVer(`${p.major + 1}.0.0`) }];
+        if (p.patch === null) return [{ operator: ">=", semver: new SemVer(`${p.major}.${p.minor + 1}.0`) }];
+        return [{ operator: ">", semver: new SemVer(partialToVersion(p)) }];
+    }
+    if (op === "<") {
+        if (p.minor === null) return [{ operator: "<", semver: new SemVer(`${p.major}.0.0`) }];
+        if (p.patch === null) return [{ operator: "<", semver: new SemVer(`${p.major}.${p.minor}.0`) }];
+        return [{ operator: "<", semver: new SemVer(partialToVersion(p)) }];
+    }
+    if (op === ">=") return [{ operator: ">=", semver: new SemVer(partialToVersion(p)) }];
+    if (p.minor === null) return [{ operator: "<", semver: new SemVer(`${p.major + 1}.0.0`) }];
+    if (p.patch === null) return [{ operator: "<", semver: new SemVer(`${p.major}.${p.minor + 1}.0`) }];
+    return [{ operator: "<=", semver: new SemVer(partialToVersion(p)) }];
+}
+
+function hyphenRange(left: string, right: string): Comparator[] {
+    const a = parsePartial(left);
+    const b = parsePartial(right);
+    const lower: Comparator =
+        a.major === null
+            ? { operator: ">=", semver: new SemVer("0.0.0") }
+            : {
+                operator: ">=",
+                semver: new SemVer(
+                    `${a.major}.${a.minor ?? 0}.${a.patch ?? 0}${a.pre ? `-${a.pre}` : ""}`,
+                ),
+            };
+    let upper: Comparator;
+    if (b.major === null) {
+        upper = { operator: ">=", semver: new SemVer("0.0.0") };
+    } else if (b.minor === null) {
+        upper = { operator: "<", semver: new SemVer(`${b.major + 1}.0.0`) };
+    } else if (b.patch === null) {
+        upper = { operator: "<", semver: new SemVer(`${b.major}.${b.minor + 1}.0`) };
+    } else {
+        upper = {
+            operator: "<=",
+            semver: new SemVer(
+                `${b.major}.${b.minor}.${b.patch}${b.pre ? `-${b.pre}` : ""}`,
+            ),
+        };
+    }
+    return [lower, upper];
+}

package/src/test.mts

@@ -0,0 +1,5 @@
+import { run } from "@gjsify/unit";
+
+import semverTestSuite from "./index.spec.js";
+
+run({ semverTestSuite });

package/tsconfig.build.json

@@ -0,0 +1,8 @@
+{
+    "extends": "./tsconfig.json",
+    "exclude": [
+        "src/test.mts",
+        "src/**/*.spec.ts",
+        "src/**/*.spec.mts"
+    ]
+}

package/tsconfig.json

@@ -0,0 +1,22 @@
+{
+    "compilerOptions": {
+        "module": "ESNext",
+        "target": "ESNext",
+        "moduleResolution": "bundler",
+        "experimentalDecorators": true,
+        "declaration": true,
+        "allowImportingTsExtensions": false,
+        "outDir": "lib/esm",
+        "rootDir": "src",
+        "declarationDir": "lib/types",
+        "composite": true,
+        "skipLibCheck": true,
+        "strict": true
+    },
+    "include": [
+        "src/**/*.ts"
+    ],
+    "exclude": [
+        "src/test.mts"
+    ]
+}