@alextheman/utility 5.6.1 → 5.6.3

package/dist/node/index.cjs

@@ -1,4 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -7,16 +7,12 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") {
-		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-			key = keys[i];
-			if (!__hasOwnProp.call(to, key) && key !== except) {
-				__defProp(to, key, {
-					get: ((k) => from[k]).bind(null, key),
-					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-				});
-			}
-		}
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
 	}
 	return to;
 };
@@ -24,14 +20,12 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	value: mod,
 	enumerable: true
 }) : target, mod));
-
 //#endregion
 let node_path = require("node:path");
 node_path = __toESM(node_path);
 let zod = require("zod");
 zod = __toESM(zod);
 require("libsodium-wrappers");
-
 //#region src/node/functions/normalizeImportPath.ts
 /**
 * Normalizes an import path meant for use in an import statement in JavaScript.
@@ -67,26 +61,15 @@ function normalizeImportPath(importPath) {
 * @returns The import path normalised.
 */
 const normaliseImportPath = normalizeImportPath;
-
 //#endregion
 //#region src/root/constants/FILE_PATH_REGEX.ts
 const FILE_PATH_PATTERN = String.raw`(?<directory>.+)[\/\\](?<base>[^\/\\]+)`;
 const FILE_PATH_REGEX = RegExp(`^${FILE_PATH_PATTERN}$`);
-
-//#endregion
-//#region src/root/constants/ONE_DAY_IN_MILLISECONDS.ts
-const ONE_DAY_IN_MILLISECONDS = 1440 * 60 * 1e3;
-
-//#endregion
-//#region src/root/constants/UUID_REGEX.ts
-const UUID_PATTERN = "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}";
-const UUID_REGEX = new RegExp(`^${UUID_PATTERN}$`);
-
+new RegExp(`^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$`);
 //#endregion
 //#region src/root/constants/VERSION_NUMBER_REGEX.ts
 const VERSION_NUMBER_PATTERN = String.raw`^(?:v)?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$`;
 const VERSION_NUMBER_REGEX = RegExp(`^${VERSION_NUMBER_PATTERN}$`);
-
 //#endregion
 //#region src/root/functions/arrayHelpers/fillArray.ts
 /**
@@ -113,7 +96,6 @@ function fillArray(callback, length = 1) {
 	})) return Promise.all(outputArray);
 	return outputArray;
 }
-
 //#endregion
 //#region src/root/functions/arrayHelpers/paralleliseArrays.ts
 /**
@@ -137,7 +119,6 @@ function paralleliseArrays(firstArray, secondArray) {
 	for (let i = 0; i < firstArray.length; i++) outputArray.push([firstArray[i], secondArray[i]]);
 	return outputArray;
 }
-
 //#endregion
 //#region src/root/functions/parsers/parseIntStrict.ts
 /**
@@ -159,7 +140,7 @@ function parseIntStrict(string, radix) {
 		string,
 		radix
 	} : { string }, "INTEGER_PARSING_ERROR", `Only numeric values${radix && radix > 10 && radix <= 36 ? ` or character${radix !== 11 ? "s" : ""} A${radix !== 11 ? `-${maxAllowedAlphabeticalCharacter?.toUpperCase()} ` : " "}` : " "}are allowed.`);
-	if (radix && radix < 10 && [...trimmedString].some((character) => {
+	if (radix && radix < 10 && [...trimmedString.replace(/^[+-]/, "")].some((character) => {
 		return parseInt(character) >= radix;
 	})) throw new DataError({
 		string,
@@ -169,7 +150,6 @@ function parseIntStrict(string, radix) {
 	if (isNaN(parseIntResult)) throw new DataError({ string }, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
 	return parseIntResult;
 }
-
 //#endregion
 //#region src/root/functions/taggedTemplate/interpolate.ts
 /**
@@ -197,7 +177,6 @@ function interpolate(strings, ...interpolations) {
 	for (const [string, interpolation = ""] of paralleliseArrays(strings, interpolations)) result += string + interpolation;
 	return result;
 }
-
 //#endregion
 //#region src/root/functions/taggedTemplate/normaliseIndents.ts
 function calculateTabSize(line, whitespaceLength) {
@@ -261,7 +240,6 @@ function normaliseIndents(first, ...args) {
 	const options = typeof args[args.length - 1] === "object" && !Array.isArray(args[args.length - 1]) ? args.pop() : {};
 	return reduceLines(interpolate(strings, ...[...args]).split("\n"), options);
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/sayHello.ts
 /**
@@ -375,7 +353,6 @@ function sayHello() {
     I'll commit to you!
     `;
 }
-
 //#endregion
 //#region src/root/functions/parsers/parseVersionType.ts
 /**
@@ -388,7 +365,6 @@ const VersionType = {
 	MINOR: "minor",
 	PATCH: "patch"
 };
-
 //#endregion
 //#region src/root/types/DataError.ts
 /**
@@ -478,7 +454,6 @@ var DataError = class DataError extends Error {
 		throw new Error("Expected a DataError to be thrown but none was thrown");
 	}
 };
-
 //#endregion
 //#region src/root/types/VersionNumber.ts
 /**
@@ -503,7 +478,7 @@ var VersionNumber = class VersionNumber {
 			this.minor = input.minor;
 			this.patch = input.patch;
 		} else if (typeof input === "string") {
-			if (!RegExp(VERSION_NUMBER_REGEX).test(input)) throw new DataError({ input }, "INVALID_VERSION", `"${input}" is not a valid version number. Version numbers must be of the format "X.Y.Z" or "vX.Y.Z", where X, Y, and Z are non-negative integers.`);
+			if (!VERSION_NUMBER_REGEX.test(input)) throw new DataError({ input }, "INVALID_VERSION", `"${input}" is not a valid version number. Version numbers must be of the format "X.Y.Z" or "vX.Y.Z", where X, Y, and Z are non-negative integers.`);
 			const [major, minor, patch] = VersionNumber.formatString(input, { omitPrefix: true }).split(".").map((number) => {
 				return parseIntStrict(number);
 			});
@@ -520,7 +495,10 @@ var VersionNumber = class VersionNumber {
 			this.major = major;
 			this.minor = minor;
 			this.patch = patch;
-		}
+		} else throw new DataError({ input }, "INVALID_INPUT", normaliseIndents`
+        The provided input can not be parsed into a valid version number.
+        Expected either a string of format X.Y.Z or vX.Y.Z, a tuple of three numbers, or another \`VersionNumber\` instance.
+      `);
 	}
 	/**
 	* Gets the current version type of the current instance of `VersionNumber`.
@@ -632,7 +610,7 @@ var VersionNumber = class VersionNumber {
 		return VersionNumber.formatString(rawString, { omitPrefix: false });
 	}
 };
-const zodVersionNumber = zod.default.union([
+zod.default.union([
 	zod.default.string(),
 	zod.default.tuple([
 		zod.default.number(),
@@ -643,7 +621,6 @@ const zodVersionNumber = zod.default.union([
 ]).transform((rawVersionNumber) => {
 	return new VersionNumber(rawVersionNumber);
 });
-
 //#endregion
 //#region src/node/functions/parseFilePath.ts
 /**
@@ -674,13 +651,11 @@ function parseFilePath(filePath) {
 		fullPath: node_path.default.join(caughtGroups.groups.directory.replaceAll("\\", "/"), caughtGroups.groups.base)
 	};
 }
-
 //#endregion
 //#region src/node/functions/sayHello.ts
 var sayHello_default = sayHello;
-
 //#endregion
 exports.normaliseImportPath = normaliseImportPath;
 exports.normalizeImportPath = normalizeImportPath;
 exports.parseFilePath = parseFilePath;
-exports.sayHello = sayHello_default;
+exports.sayHello = sayHello_default;

package/dist/node/index.js

@@ -1,7 +1,6 @@
 import path from "node:path";
 import z from "zod";
 import "libsodium-wrappers";
-
 //#region src/node/functions/normalizeImportPath.ts
 /**
 * Normalizes an import path meant for use in an import statement in JavaScript.
@@ -37,26 +36,15 @@ function normalizeImportPath(importPath) {
 * @returns The import path normalised.
 */
 const normaliseImportPath = normalizeImportPath;
-
 //#endregion
 //#region src/root/constants/FILE_PATH_REGEX.ts
 const FILE_PATH_PATTERN = String.raw`(?<directory>.+)[\/\\](?<base>[^\/\\]+)`;
 const FILE_PATH_REGEX = RegExp(`^${FILE_PATH_PATTERN}$`);
-
-//#endregion
-//#region src/root/constants/ONE_DAY_IN_MILLISECONDS.ts
-const ONE_DAY_IN_MILLISECONDS = 1440 * 60 * 1e3;
-
-//#endregion
-//#region src/root/constants/UUID_REGEX.ts
-const UUID_PATTERN = "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}";
-const UUID_REGEX = new RegExp(`^${UUID_PATTERN}$`);
-
+new RegExp(`^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$`);
 //#endregion
 //#region src/root/constants/VERSION_NUMBER_REGEX.ts
 const VERSION_NUMBER_PATTERN = String.raw`^(?:v)?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$`;
 const VERSION_NUMBER_REGEX = RegExp(`^${VERSION_NUMBER_PATTERN}$`);
-
 //#endregion
 //#region src/root/functions/arrayHelpers/fillArray.ts
 /**
@@ -83,7 +71,6 @@ function fillArray(callback, length = 1) {
 	})) return Promise.all(outputArray);
 	return outputArray;
 }
-
 //#endregion
 //#region src/root/functions/arrayHelpers/paralleliseArrays.ts
 /**
@@ -107,7 +94,6 @@ function paralleliseArrays(firstArray, secondArray) {
 	for (let i = 0; i < firstArray.length; i++) outputArray.push([firstArray[i], secondArray[i]]);
 	return outputArray;
 }
-
 //#endregion
 //#region src/root/functions/parsers/parseIntStrict.ts
 /**
@@ -129,7 +115,7 @@ function parseIntStrict(string, radix) {
 		string,
 		radix
 	} : { string }, "INTEGER_PARSING_ERROR", `Only numeric values${radix && radix > 10 && radix <= 36 ? ` or character${radix !== 11 ? "s" : ""} A${radix !== 11 ? `-${maxAllowedAlphabeticalCharacter?.toUpperCase()} ` : " "}` : " "}are allowed.`);
-	if (radix && radix < 10 && [...trimmedString].some((character) => {
+	if (radix && radix < 10 && [...trimmedString.replace(/^[+-]/, "")].some((character) => {
 		return parseInt(character) >= radix;
 	})) throw new DataError({
 		string,
@@ -139,7 +125,6 @@ function parseIntStrict(string, radix) {
 	if (isNaN(parseIntResult)) throw new DataError({ string }, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
 	return parseIntResult;
 }
-
 //#endregion
 //#region src/root/functions/taggedTemplate/interpolate.ts
 /**
@@ -167,7 +152,6 @@ function interpolate(strings, ...interpolations) {
 	for (const [string, interpolation = ""] of paralleliseArrays(strings, interpolations)) result += string + interpolation;
 	return result;
 }
-
 //#endregion
 //#region src/root/functions/taggedTemplate/normaliseIndents.ts
 function calculateTabSize(line, whitespaceLength) {
@@ -231,7 +215,6 @@ function normaliseIndents(first, ...args) {
 	const options = typeof args[args.length - 1] === "object" && !Array.isArray(args[args.length - 1]) ? args.pop() : {};
 	return reduceLines(interpolate(strings, ...[...args]).split("\n"), options);
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/sayHello.ts
 /**
@@ -345,7 +328,6 @@ function sayHello() {
     I'll commit to you!
     `;
 }
-
 //#endregion
 //#region src/root/functions/parsers/parseVersionType.ts
 /**
@@ -358,7 +340,6 @@ const VersionType = {
 	MINOR: "minor",
 	PATCH: "patch"
 };
-
 //#endregion
 //#region src/root/types/DataError.ts
 /**
@@ -448,7 +429,6 @@ var DataError = class DataError extends Error {
 		throw new Error("Expected a DataError to be thrown but none was thrown");
 	}
 };
-
 //#endregion
 //#region src/root/types/VersionNumber.ts
 /**
@@ -473,7 +453,7 @@ var VersionNumber = class VersionNumber {
 			this.minor = input.minor;
 			this.patch = input.patch;
 		} else if (typeof input === "string") {
-			if (!RegExp(VERSION_NUMBER_REGEX).test(input)) throw new DataError({ input }, "INVALID_VERSION", `"${input}" is not a valid version number. Version numbers must be of the format "X.Y.Z" or "vX.Y.Z", where X, Y, and Z are non-negative integers.`);
+			if (!VERSION_NUMBER_REGEX.test(input)) throw new DataError({ input }, "INVALID_VERSION", `"${input}" is not a valid version number. Version numbers must be of the format "X.Y.Z" or "vX.Y.Z", where X, Y, and Z are non-negative integers.`);
 			const [major, minor, patch] = VersionNumber.formatString(input, { omitPrefix: true }).split(".").map((number) => {
 				return parseIntStrict(number);
 			});
@@ -490,7 +470,10 @@ var VersionNumber = class VersionNumber {
 			this.major = major;
 			this.minor = minor;
 			this.patch = patch;
-		}
+		} else throw new DataError({ input }, "INVALID_INPUT", normaliseIndents`
+        The provided input can not be parsed into a valid version number.
+        Expected either a string of format X.Y.Z or vX.Y.Z, a tuple of three numbers, or another \`VersionNumber\` instance.
+      `);
 	}
 	/**
 	* Gets the current version type of the current instance of `VersionNumber`.
@@ -602,7 +585,7 @@ var VersionNumber = class VersionNumber {
 		return VersionNumber.formatString(rawString, { omitPrefix: false });
 	}
 };
-const zodVersionNumber = z.union([
+z.union([
 	z.string(),
 	z.tuple([
 		z.number(),
@@ -613,7 +596,6 @@ const zodVersionNumber = z.union([
 ]).transform((rawVersionNumber) => {
 	return new VersionNumber(rawVersionNumber);
 });
-
 //#endregion
 //#region src/node/functions/parseFilePath.ts
 /**
@@ -644,10 +626,8 @@ function parseFilePath(filePath) {
 		fullPath: path.join(caughtGroups.groups.directory.replaceAll("\\", "/"), caughtGroups.groups.base)
 	};
 }
-
 //#endregion
 //#region src/node/functions/sayHello.ts
 var sayHello_default = sayHello;
-
 //#endregion
-export { normaliseImportPath, normalizeImportPath, parseFilePath, sayHello_default as sayHello };
+export { normaliseImportPath, normalizeImportPath, parseFilePath, sayHello_default as sayHello };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/utility",
-  "version": "5.6.1",
+  "version": "5.6.3",
   "description": "Helpful utility functions.",
   "repository": {
     "type": "git",
@@ -36,23 +36,23 @@
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@alextheman/eslint-plugin": "^5.9.1",
-    "@types/node": "^25.3.3",
-    "alex-c-line": "^2.0.0",
+    "@alextheman/eslint-plugin": "^5.10.1",
+    "@types/node": "^25.5.0",
+    "alex-c-line": "^2.2.3",
     "cross-env": "^10.1.0",
     "dotenv-cli": "^11.0.0",
-    "eslint": "^10.0.2",
-    "globals": "^17.3.0",
+    "eslint": "^10.0.3",
+    "globals": "^17.4.0",
     "husky": "^9.1.7",
     "jsdom": "^28.1.0",
     "prettier": "^3.8.1",
     "tempy": "^3.2.0",
-    "tsdown": "^0.20.3",
+    "tsdown": "^0.21.2",
     "tsx": "^4.21.0",
     "typedoc": "^0.28.17",
     "typescript": "^5.9.3",
     "vite-tsconfig-paths": "^6.1.1",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.0"
   },
   "engines": {
     "node": ">=22.3.0"
@@ -63,13 +63,13 @@
     "create-local-package": "pnpm run build && rm -f alextheman-utility-*.tgz && pnpm pack",
     "create-release-note": "bash -c 'git pull origin main && alex-c-line template release-note create $@' --",
     "format": "pnpm run format-prettier && pnpm run format-eslint",
-    "format-eslint": "eslint --fix --suppress-all \"package.json\" \"src/**/*.ts\" \"tests/**/*.ts\" && rm -f eslint-suppressions.json",
+    "format-eslint": "eslint --fix --suppress-all \"package.json\" \"src/**/*.ts\" \"tests/**/*.ts\" \"configs/**/*.ts\" && rm -f eslint-suppressions.json",
     "format-prettier": "pnpm run format-prettier-typescript && pnpm run format-prettier-javascript && pnpm run format-prettier-yml",
     "format-prettier-javascript": "prettier --write \"./**/*.js\"",
     "format-prettier-typescript": "prettier --write --parser typescript \"./**/*.ts\"",
     "format-prettier-yml": "prettier --write \"./**/*.{yml,yaml}\"",
     "lint": "pnpm run lint-tsc && pnpm run lint-eslint && pnpm run lint-prettier && pnpm run lint-pre-release",
-    "lint-eslint": "eslint \"package.json\" \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "lint-eslint": "eslint \"package.json\" \"src/**/*.ts\" \"tests/**/*.ts\" \"configs/**/*.ts\"",
     "lint-pre-release": "alex-c-line package-json check --rules no-pre-release-dependencies",
     "lint-prettier": "pnpm run lint-prettier-typescript && pnpm run lint-prettier-javascript && pnpm run lint-prettier-yml",
     "lint-prettier-javascript": "prettier --check \"./**/*.js\"",