deprecation(semver): deprecate ==, ===, !==, and "" operators (#4271)

Co-authored-by: Yoshiya Hinosawa <stibium121@gmail.com>

semver/_comparator_format.ts

@@ -10,5 +10,7 @@ import { format } from "./format.ts";
  */
 export function comparatorFormat(comparator: Comparator): string {
   const { semver, operator } = comparator;
-  return `${operator}${format(semver ?? comparator)}`;
+  return `${operator === undefined ? "" : operator}${
+    format(semver ?? comparator)
+  }`;
 }

semver/_comparator_max.ts

@@ -19,9 +19,10 @@ export function comparatorMax(comparator: Comparator): SemVer {
     case ">=":
       return MAX;
     case "":
-    case "=":
     case "==":
     case "===":
+    case undefined:
+    case "=":
     case "<=":
       return {
         major: semver.major,

semver/_comparator_min.ts

@@ -25,6 +25,7 @@ export function comparatorMin(comparator: Comparator): SemVer {
       // The min(<0.0.0) is MAX
       return greaterThan(semver, MIN) ? MIN : MAX;
     case ">=":
+    case undefined:
     case "":
     case "=":
     case "==":

semver/_constants.ts

@@ -1,5 +1,8 @@
 // Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
 
+/**
+ * @deprecated (will be removed in 0.219.0) `"=="`, `"==="`, `"!=="` and `""` operators are deprecated. Use `"="`, `"!="` or `undefined` instead.
+ */
 export const OPERATORS = [
   "",
   "=",

semver/_is_comparator.ts

@@ -22,7 +22,8 @@ export function isComparator(value: unknown): value is Comparator {
   if (value === NONE || value === ALL) return true;
   const { operator, semver } = value as Comparator;
   return (
-    OPERATORS.includes(operator) &&
+    (operator === undefined ||
+      OPERATORS.includes(operator)) &&
     isSemVer(semver)
   );
 }

semver/_parse_comparator.ts

@@ -28,12 +28,7 @@ export function parseComparator(comparator: string): Comparator {
 
   if (!groups) return NONE;
 
-  const {
-    operator = "",
-
-    prerelease,
-    buildmetadata,
-  } = groups as REGEXP_GROUPS;
+  const { operator, prerelease, buildmetadata } = groups as REGEXP_GROUPS;
 
   const semver = groups.major
     ? {
@@ -45,5 +40,5 @@ export function parseComparator(comparator: string): Comparator {
     }
     : ANY;
 
-  return { operator, ...semver, semver };
+  return { operator: operator || undefined, ...semver, semver };
 }

semver/parse_range.ts

@@ -241,7 +241,7 @@ function handleEqualOperator(groups: RegExpGroups): Comparator[] {
   }
   const prerelease = parsePrerelease(groups.prerelease ?? "");
   const build = parseBuild(groups.build ?? "");
-  return [{ operator: "", major, minor, patch, prerelease, build }];
+  return [{ operator: undefined, major, minor, patch, prerelease, build }];
 }
 
 function parseRangeString(string: string) {

semver/types.ts

@@ -18,6 +18,7 @@ export type ReleaseType =
 
 /**
  * SemVer comparison operators.
+ * @deprecated (will be removed in 0.219.0) `"=="`, `"==="`, `"!=="` and `""` operators are deprecated. Use `"="`, `"!="` or `undefined` instead.
  */
 export type Operator = typeof OPERATORS[number];
 
@@ -26,7 +27,7 @@ export type Operator = typeof OPERATORS[number];
  * @example >=0.0.0
  */
 export interface Comparator extends SemVer {
-  operator: Operator;
+  operator?: Operator;
   /**
    * @deprecated (will be removed after 0.217.0) {@linkcode Comparator} extends {@linkcode SemVer}. Use `major`, `minor`, `patch`, `prerelease`, and `build` properties instead.
    */