@alextheman/utility 4.3.3 → 4.3.4

package/dist/index.cjs

@@ -244,7 +244,7 @@ var VersionNumber = class VersionNumber {
 		return firstVersion.major === secondVersion.major && firstVersion.minor === secondVersion.minor && firstVersion.patch === secondVersion.patch;
 	}
 	/**
-	* Determines whether the current instance of `VersionNumber` is a major, minor, or patch version.
+	* Increments the current version number by the given increment type, returning the result as a new reference in memory.
 	*
 	* @param incrementType - The type of increment. Can be one of the following:
 	* - `"major"`: Change the major version `v1.2.3` → `v2.0.0`
@@ -273,6 +273,25 @@ var VersionNumber = class VersionNumber {
 		}[incrementType];
 	}
 	/**
+	* Ensures that the VersionNumber behaves correctly when attempted to be coerced to a string.
+	*
+	* @param hint - Not used as of now, but generally used to help with numeric coercion, I think (which we most likely do not need for version numbers).
+	*
+	* @returns A stringified representation of the current version number, prefixed with `v`.
+	*/
+	[Symbol.toPrimitive](hint) {
+		if (hint === "number") throw new DataError_default(this.toString(), "INVALID_COERCION", "VersionNumber cannot be coerced to a number type.");
+		return this.toString();
+	}
+	/**
+	* Ensures that the VersionNumber behaves correctly when attempted to be converted to JSON.
+	*
+	* @returns A stringified representation of the current version number, prefixed with `v`.
+	*/
+	toJSON() {
+		return this.toString();
+	}
+	/**
 	* Get a string representation of the current version number.
 	*
 	* @param options - Extra additional options to apply.

package/dist/index.d.cts

@@ -296,7 +296,7 @@ declare class VersionNumber {
    */
   static isEqual(firstVersion: VersionNumber, secondVersion: VersionNumber): boolean;
   /**
-   * Determines whether the current instance of `VersionNumber` is a major, minor, or patch version.
+   * Increments the current version number by the given increment type, returning the result as a new reference in memory.
    *
    * @param incrementType - The type of increment. Can be one of the following:
    * - `"major"`: Change the major version `v1.2.3` → `v2.0.0`
@@ -306,6 +306,20 @@ declare class VersionNumber {
    * @returns A new instance of `VersionNumber` with the increment applied.
    */
   increment(incrementType: VersionType): VersionNumber;
+  /**
+   * Ensures that the VersionNumber behaves correctly when attempted to be coerced to a string.
+   *
+   * @param hint - Not used as of now, but generally used to help with numeric coercion, I think (which we most likely do not need for version numbers).
+   *
+   * @returns A stringified representation of the current version number, prefixed with `v`.
+   */
+  [Symbol.toPrimitive](hint: "default" | "string" | "number"): string;
+  /**
+   * Ensures that the VersionNumber behaves correctly when attempted to be converted to JSON.
+   *
+   * @returns A stringified representation of the current version number, prefixed with `v`.
+   */
+  toJSON(): string;
   /**
    * Get a string representation of the current version number.
    *

package/dist/index.d.ts

@@ -296,7 +296,7 @@ declare class VersionNumber {
    */
   static isEqual(firstVersion: VersionNumber, secondVersion: VersionNumber): boolean;
   /**
-   * Determines whether the current instance of `VersionNumber` is a major, minor, or patch version.
+   * Increments the current version number by the given increment type, returning the result as a new reference in memory.
    *
    * @param incrementType - The type of increment. Can be one of the following:
    * - `"major"`: Change the major version `v1.2.3` → `v2.0.0`
@@ -306,6 +306,20 @@ declare class VersionNumber {
    * @returns A new instance of `VersionNumber` with the increment applied.
    */
   increment(incrementType: VersionType): VersionNumber;
+  /**
+   * Ensures that the VersionNumber behaves correctly when attempted to be coerced to a string.
+   *
+   * @param hint - Not used as of now, but generally used to help with numeric coercion, I think (which we most likely do not need for version numbers).
+   *
+   * @returns A stringified representation of the current version number, prefixed with `v`.
+   */
+  [Symbol.toPrimitive](hint: "default" | "string" | "number"): string;
+  /**
+   * Ensures that the VersionNumber behaves correctly when attempted to be converted to JSON.
+   *
+   * @returns A stringified representation of the current version number, prefixed with `v`.
+   */
+  toJSON(): string;
   /**
    * Get a string representation of the current version number.
    *

package/dist/index.js

@@ -215,7 +215,7 @@ var VersionNumber = class VersionNumber {
 		return firstVersion.major === secondVersion.major && firstVersion.minor === secondVersion.minor && firstVersion.patch === secondVersion.patch;
 	}
 	/**
-	* Determines whether the current instance of `VersionNumber` is a major, minor, or patch version.
+	* Increments the current version number by the given increment type, returning the result as a new reference in memory.
 	*
 	* @param incrementType - The type of increment. Can be one of the following:
 	* - `"major"`: Change the major version `v1.2.3` → `v2.0.0`
@@ -244,6 +244,25 @@ var VersionNumber = class VersionNumber {
 		}[incrementType];
 	}
 	/**
+	* Ensures that the VersionNumber behaves correctly when attempted to be coerced to a string.
+	*
+	* @param hint - Not used as of now, but generally used to help with numeric coercion, I think (which we most likely do not need for version numbers).
+	*
+	* @returns A stringified representation of the current version number, prefixed with `v`.
+	*/
+	[Symbol.toPrimitive](hint) {
+		if (hint === "number") throw new DataError_default(this.toString(), "INVALID_COERCION", "VersionNumber cannot be coerced to a number type.");
+		return this.toString();
+	}
+	/**
+	* Ensures that the VersionNumber behaves correctly when attempted to be converted to JSON.
+	*
+	* @returns A stringified representation of the current version number, prefixed with `v`.
+	*/
+	toJSON() {
+		return this.toString();
+	}
+	/**
 	* Get a string representation of the current version number.
 	*
 	* @param options - Extra additional options to apply.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/utility",
-  "version": "4.3.3",
+  "version": "4.3.4",
   "description": "Helpful utility functions",
   "repository": {
     "type": "git",