@alextheman/utility 4.16.2 → 5.0.0

package/dist/index.js

@@ -2,19 +2,19 @@ import z, { z as z$1 } from "zod";
 import path from "node:path";
 import sodium from "libsodium-wrappers";
 
-//#region src/constants/FILE_PATH_REGEX.ts
+//#region src/root/constants/FILE_PATH_REGEX.ts
 const FILE_PATH_REGEX = String.raw`^(?<directory>.+)[\/\\](?<base>[^\/\\]+)$`;
 
 //#endregion
-//#region src/constants/NAMESPACE_EXPORT_REGEX.ts
+//#region src/root/constants/NAMESPACE_EXPORT_REGEX.ts
 const NAMESPACE_EXPORT_REGEX = "export\\s+\\*\\s+from";
 
 //#endregion
-//#region src/constants/VERSION_NUMBER_REGEX.ts
+//#region src/root/constants/VERSION_NUMBER_REGEX.ts
 const VERSION_NUMBER_REGEX = "^(?:v)?(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$";
 
 //#endregion
-//#region src/functions/arrayHelpers/fillArray.ts
+//#region src/root/functions/arrayHelpers/fillArray.ts
 /**
 * Creates a new array where each element is the result of the provided callback.
 *
@@ -41,7 +41,7 @@ function fillArray(callback, length = 1) {
 }
 
 //#endregion
-//#region src/functions/arrayHelpers/paralleliseArrays.ts
+//#region src/root/functions/arrayHelpers/paralleliseArrays.ts
 /**
 * Creates a new array of tuples, each containing the item at the given index from both arrays.
 *
@@ -65,7 +65,7 @@ function paralleliseArrays(firstArray, secondArray) {
 }
 
 //#endregion
-//#region src/types/APIError.ts
+//#region src/root/types/APIError.ts
 const httpErrorCodeLookup = {
 	400: "BAD_REQUEST",
 	401: "UNAUTHORISED",
@@ -109,11 +109,13 @@ var APIError = class APIError extends Error {
 };
 
 //#endregion
-//#region src/types/DataError.ts
+//#region src/root/types/DataError.ts
 /**
 * Represents errors you may get that may've been caused by a specific piece of data.
 *
 * @category Types
+*
+* @template DataType - The type of the data that caused the error.
 */
 var DataError = class DataError extends Error {
 	code;
@@ -148,7 +150,7 @@ var DataError = class DataError extends Error {
 };
 
 //#endregion
-//#region src/types/VersionNumber.ts
+//#region src/root/types/VersionNumber.ts
 /**
 * Represents a software version number, considered to be made up of a major, minor, and patch part.
 *
@@ -171,7 +173,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 (!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.`);
 			const [major, minor, patch] = VersionNumber.formatString(input, { omitPrefix: true }).split(".").map((number) => {
 				return parseIntStrict(number);
 			});
@@ -179,10 +181,10 @@ var VersionNumber = class VersionNumber {
 			this.minor = minor;
 			this.patch = patch;
 		} else if (Array.isArray(input)) {
-			if (input.length !== 3) throw new DataError(input, "INVALID_LENGTH", VersionNumber.NON_NEGATIVE_TUPLE_ERROR);
+			if (input.length !== 3) throw new DataError({ input }, "INVALID_LENGTH", VersionNumber.NON_NEGATIVE_TUPLE_ERROR);
 			const [major, minor, patch] = input.map((number) => {
 				const parsedInteger = parseIntStrict(number?.toString());
-				if (parsedInteger < 0) throw new DataError(input, "NEGATIVE_INPUTS", VersionNumber.NON_NEGATIVE_TUPLE_ERROR);
+				if (parsedInteger < 0) throw new DataError({ input }, "NEGATIVE_INPUTS", VersionNumber.NON_NEGATIVE_TUPLE_ERROR);
 				return parsedInteger;
 			});
 			this.major = major;
@@ -216,33 +218,60 @@ var VersionNumber = class VersionNumber {
 		return firstVersion.major === secondVersion.major && firstVersion.minor === secondVersion.minor && firstVersion.patch === secondVersion.patch;
 	}
 	/**
+	* Get a formatted string representation of the current version number
+	*
+	* @param options - Options to apply to the string formatting.
+	*
+	* @returns A formatted string representation of the current version number with the options applied.
+	*/
+	format(options) {
+		let baseOutput = `${this.major}`;
+		if (!options?.omitMinor) {
+			baseOutput += `.${this.minor}`;
+			if (!options?.omitPatch) baseOutput += `.${this.patch}`;
+		}
+		return VersionNumber.formatString(baseOutput, { omitPrefix: options?.omitPrefix });
+	}
+	/**
 	* 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`
 	* - `"minor"`: Change the minor version `v1.2.3` → `v1.3.0`
 	* - `"patch"`: Change the patch version `v1.2.3` → `v1.2.4`
+	* @param incrementAmount - The amount to increment by (defaults to 1).
 	*
 	* @returns A new instance of `VersionNumber` with the increment applied.
 	*/
-	increment(incrementType) {
-		return {
-			major: new VersionNumber([
-				this.major + 1,
+	increment(incrementType, incrementAmount = 1) {
+		const incrementBy = parseIntStrict(String(incrementAmount));
+		const calculatedRawVersion = {
+			major: [
+				this.major + incrementBy,
 				0,
 				0
-			]),
-			minor: new VersionNumber([
+			],
+			minor: [
 				this.major,
-				this.minor + 1,
+				this.minor + incrementBy,
 				0
-			]),
-			patch: new VersionNumber([
+			],
+			patch: [
 				this.major,
 				this.minor,
-				this.patch + 1
-			])
+				this.patch + incrementBy
+			]
 		}[incrementType];
+		try {
+			return new VersionNumber(calculatedRawVersion);
+		} catch (error) {
+			if (DataError.check(error) && error.code === "NEGATIVE_INPUTS") throw new DataError({
+				currentVersion: this.toString(),
+				calculatedRawVersion: `v${calculatedRawVersion.join(".")}`,
+				incrementAmount
+			}, "NEGATIVE_VERSION", "Cannot apply this increment amount as it would lead to a negative version number.");
+			else throw error;
+		}
 	}
 	/**
 	* Ensures that the VersionNumber behaves correctly when attempted to be coerced to a string.
@@ -252,7 +281,7 @@ var VersionNumber = class VersionNumber {
 	* @returns A stringified representation of the current version number, prefixed with `v`.
 	*/
 	[Symbol.toPrimitive](hint) {
-		if (hint === "number") throw new DataError(this.toString(), "INVALID_COERCION", "VersionNumber cannot be coerced to a number type.");
+		if (hint === "number") throw new DataError({ thisVersion: this.toString() }, "INVALID_COERCION", "VersionNumber cannot be coerced to a number type.");
 		return this.toString();
 	}
 	/**
@@ -266,13 +295,11 @@ var VersionNumber = class VersionNumber {
 	/**
 	* Get a string representation of the current version number.
 	*
-	* @param options - Extra additional options to apply.
-	*
-	* @returns A stringified representation of the current version number, leaving out the prefix if `omitPrefix` option was set to true.
+	* @returns A stringified representation of the current version number with the prefix.
 	*/
-	toString(options) {
+	toString() {
 		const rawString = `${this.major}.${this.minor}.${this.patch}`;
-		return VersionNumber.formatString(rawString, options);
+		return VersionNumber.formatString(rawString, { omitPrefix: false });
 	}
 };
 const zodVersionNumber = z.union([
@@ -288,7 +315,7 @@ const zodVersionNumber = z.union([
 });
 
 //#endregion
-//#region src/functions/parsers/parseIntStrict.ts
+//#region src/root/functions/parsers/parseIntStrict.ts
 /**
 * Converts a string to an integer and throws an error if it cannot be converted.
 *
@@ -307,7 +334,7 @@ function parseIntStrict(string, radix) {
 	if (!(radix && radix > 10 && radix <= 36 ? new RegExp(`^[+-]?[0-9a-${maxAllowedAlphabeticalCharacter}]+$`, "i") : /^[+-]?\d+$/).test(trimmedString)) throw new DataError(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.`);
+	} : { 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) => {
 		return parseInt(character) >= radix;
 	})) throw new DataError({
@@ -315,12 +342,12 @@ function parseIntStrict(string, radix) {
 		radix
 	}, "INTEGER_PARSING_ERROR", "Value contains one or more digits outside of the range of the given radix.");
 	const parseIntResult = parseInt(trimmedString, radix);
-	if (isNaN(parseIntResult)) throw new DataError(string, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
+	if (isNaN(parseIntResult)) throw new DataError({ string }, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
 	return parseIntResult;
 }
 
 //#endregion
-//#region src/functions/miscellaneous/getRandomNumber.ts
+//#region src/root/functions/miscellaneous/getRandomNumber.ts
 /**
 * Gets a random number between the given bounds.
 *
@@ -338,7 +365,7 @@ function getRandomNumber(lowerBound, upperBound) {
 }
 
 //#endregion
-//#region src/functions/arrayHelpers/randomiseArray.ts
+//#region src/root/functions/arrayHelpers/randomiseArray.ts
 /**
 * Randomises the order of a given array and returns the result in a new array without mutating the original.
 *
@@ -361,7 +388,7 @@ function randomiseArray(array) {
 }
 
 //#endregion
-//#region src/functions/arrayHelpers/range.ts
+//#region src/root/functions/arrayHelpers/range.ts
 /**
 * Creates an array of numbers within a given range.
 *
@@ -393,7 +420,7 @@ function range(start, stop, step = 1) {
 }
 
 //#endregion
-//#region src/functions/arrayHelpers/removeDuplicates.ts
+//#region src/root/functions/arrayHelpers/removeDuplicates.ts
 /**
 * Removes duplicate values from an array.
 *
@@ -412,7 +439,7 @@ function removeDuplicates(array) {
 }
 
 //#endregion
-//#region src/functions/date/addDaysToDate.ts
+//#region src/root/functions/date/addDaysToDate.ts
 /**
 * Adds a given number of days to the provided date, returning the result as a new instance of Date.
 *
@@ -430,7 +457,7 @@ function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement =
 }
 
 //#endregion
-//#region src/functions/date/isSameDate.ts
+//#region src/root/functions/date/isSameDate.ts
 /**
 * Checks if the provided dates happen on the exact same day, month, and year.
 *
@@ -446,7 +473,7 @@ function isSameDate(firstDate, secondDate) {
 }
 
 //#endregion
-//#region src/functions/date/formatDateAndTime.ts
+//#region src/root/functions/date/formatDateAndTime.ts
 /**
 * Creates a human-readable string with information about the input date.
 *
@@ -470,7 +497,7 @@ function formatDateAndTime(inputDate) {
 }
 
 //#endregion
-//#region src/functions/date/isLeapYear.ts
+//#region src/root/functions/date/isLeapYear.ts
 /**
 * Checks if the provided year is a leap year.
 *
@@ -488,7 +515,7 @@ function isLeapYear(year) {
 }
 
 //#endregion
-//#region src/functions/date/isAnniversary.ts
+//#region src/root/functions/date/isAnniversary.ts
 function checkLeapYear(firstDate, secondDate) {
 	if (isLeapYear(firstDate.getFullYear()) && firstDate.getMonth() === 1 && secondDate.getMonth() === 1) return firstDate.getDate() === 29 && secondDate.getDate() === 28;
 	return false;
@@ -509,7 +536,7 @@ function isAnniversary(firstDate, secondDate) {
 }
 
 //#endregion
-//#region src/functions/date/isMonthlyMultiple.ts
+//#region src/root/functions/date/isMonthlyMultiple.ts
 function endOfMonthChecksButNotFebruary(firstDate, secondDate) {
 	if ([
 		3,
@@ -558,7 +585,7 @@ function isMonthlyMultiple(firstDate, secondDate) {
 }
 
 //#endregion
-//#region src/functions/miscellaneous/convertFileToBase64.ts
+//#region src/root/functions/miscellaneous/convertFileToBase64.ts
 /**
 * Asynchronously converts a file to a base 64 string
 *
@@ -588,7 +615,7 @@ function convertFileToBase64(file) {
 }
 
 //#endregion
-//#region src/functions/miscellaneous/createFormData.ts
+//#region src/root/functions/miscellaneous/createFormData.ts
 function getNullableResolutionStrategy(key, strategy) {
 	return (typeof strategy === "object" ? strategy[key] : strategy) ?? "empty";
 }
@@ -657,7 +684,26 @@ function createFormData(data, options = {
 }
 
 //#endregion
-//#region src/functions/miscellaneous/isOrdered.ts
+//#region src/root/functions/miscellaneous/getDependenciesFromGroup.ts
+/**
+* Get the dependencies from a given dependency group in `package.json`.
+*
+* @category Miscellaneous
+*
+* @param packageInfo - The data coming from `package.json`.
+* @param dependencyGroup - The group to get dependency information about (can be `dependencies` or `devDependencies`).
+*
+* @returns A record consisting of the package names and version ranges from the given dependency group.
+*/
+function getDependenciesFromGroup(packageInfo, dependencyGroup) {
+	return {
+		dependencies: parseZodSchema(z.record(z.string(), z.string()), packageInfo.dependencies ?? {}),
+		devDependencies: parseZodSchema(z.record(z.string(), z.string()), packageInfo.devDependencies ?? {})
+	}[dependencyGroup];
+}
+
+//#endregion
+//#region src/root/functions/miscellaneous/isOrdered.ts
 /**
 * Checks to see if the given array is sorted in ascending order.
 *
@@ -675,7 +721,7 @@ function isOrdered(array) {
 }
 
 //#endregion
-//#region src/functions/recursive/deepFreeze.ts
+//#region src/root/functions/recursive/deepFreeze.ts
 /**
 * Deeply freezes an object or array such that all child objects/arrays are also frozen.
 *
@@ -699,7 +745,7 @@ function deepFreeze(object) {
 }
 
 //#endregion
-//#region src/functions/taggedTemplate/createTemplateStringsArray.ts
+//#region src/root/functions/taggedTemplate/createTemplateStringsArray.ts
 /**
 * Creates a template strings array given a regular array of strings
 *
@@ -714,31 +760,7 @@ function createTemplateStringsArray(strings) {
 }
 
 //#endregion
-//#region src/functions/taggedTemplate/getInterpolations.ts
-/**
-*
-* Gets the strings and interpolations separately from a template string.
-* You can pass a template string directly by doing:
-*
-* ```typescript
-* getInterpolations`Template string here`.
-* ```
-*
-* @category Tagged Template
-*
-* @deprecated Please use `getStringsAndInterpolations` instead.
-*
-* @param strings - The strings from the template to process.
-* @param interpolations - An array of all interpolations from the template.
-*
-* @returns A tuple where the first item is the strings from the template, and the second is the interpolations.
-*/
-function getInterpolations(strings, ...interpolations) {
-	return [strings, interpolations];
-}
-
-//#endregion
-//#region src/functions/taggedTemplate/getStringsAndInterpolations.ts
+//#region src/root/functions/taggedTemplate/getStringsAndInterpolations.ts
 /**
 *
 * Gets the strings and interpolations separately from a template string.
@@ -779,7 +801,7 @@ function getStringsAndInterpolations(strings, ...interpolations) {
 }
 
 //#endregion
-//#region src/functions/taggedTemplate/interpolate.ts
+//#region src/root/functions/taggedTemplate/interpolate.ts
 /**
 * Returns the result of interpolating a template string when given the strings and interpolations separately.
 *
@@ -807,7 +829,7 @@ function interpolate(strings, ...interpolations) {
 }
 
 //#endregion
-//#region src/functions/taggedTemplate/interpolateObjects.ts
+//#region src/root/functions/taggedTemplate/interpolateObjects.ts
 /**
 * Returns the result of interpolating a template string, also stringifying objects.
 *
@@ -836,7 +858,7 @@ function interpolateObjects(strings, ...interpolations) {
 }
 
 //#endregion
-//#region src/functions/taggedTemplate/isTemplateStringsArray.ts
+//#region src/root/functions/taggedTemplate/isTemplateStringsArray.ts
 /**
 * Determines whether or not the input is a valid `TemplateStringsArray`.
 *
@@ -851,7 +873,7 @@ function isTemplateStringsArray(input) {
 }
 
 //#endregion
-//#region src/functions/taggedTemplate/normaliseIndents.ts
+//#region src/root/functions/taggedTemplate/normaliseIndents.ts
 function calculateTabSize(line, whitespaceLength) {
 	const potentialWhitespacePart = line.slice(0, whitespaceLength);
 	const trimmedString = line.trimStart();
@@ -940,7 +962,7 @@ function normaliseIndents(first, ...args) {
 const normalizeIndents = normaliseIndents;
 
 //#endregion
-//#region src/functions/miscellaneous/sayHello.ts
+//#region src/root/functions/miscellaneous/sayHello.ts
 /**
 * Returns a string representing the lyrics to the package's theme song, Commit To You
 *
@@ -1054,7 +1076,7 @@ function sayHello() {
 }
 
 //#endregion
-//#region src/functions/miscellaneous/stringifyDotenv.ts
+//#region src/root/functions/miscellaneous/stringifyDotenv.ts
 /**
 * Converts an object into a string in .env file format.
 *
@@ -1090,7 +1112,7 @@ function stringifyDotenv(contents, options) {
 }
 
 //#endregion
-//#region src/functions/miscellaneous/stringListToArray.ts
+//#region src/root/functions/miscellaneous/stringListToArray.ts
 /**
 * Converts a stringly-typed list to a proper array.
 *
@@ -1112,7 +1134,7 @@ function stringListToArray(stringList, { separator = ",", trimWhitespace = true
 }
 
 //#endregion
-//#region src/functions/miscellaneous/wait.ts
+//#region src/root/functions/miscellaneous/wait.ts
 /**
 * Waits for the given number of seconds
 *
@@ -1131,7 +1153,7 @@ function wait(seconds) {
 }
 
 //#endregion
-//#region src/functions/objectHelpers/getRecordKeys.ts
+//#region src/root/functions/objectHelpers/getRecordKeys.ts
 /**
 * Gets the keys from a given record object, properly typed to be an array of the key of the input object's type.
 *
@@ -1148,7 +1170,7 @@ function getRecordKeys(record) {
 }
 
 //#endregion
-//#region src/functions/objectHelpers/omitProperties.ts
+//#region src/root/functions/objectHelpers/omitProperties.ts
 /**
 * Omits properties from a given object.
 *
@@ -1171,7 +1193,7 @@ function omitProperties(object, keysToOmit) {
 }
 
 //#endregion
-//#region src/functions/objectHelpers/removeUndefinedFromObject.ts
+//#region src/root/functions/objectHelpers/removeUndefinedFromObject.ts
 /**
 * Removes entries whose values are `undefined` from a given object (not including null etc.).
 *
@@ -1186,7 +1208,7 @@ function removeUndefinedFromObject(object) {
 }
 
 //#endregion
-//#region src/functions/parsers/parseBoolean.ts
+//#region src/root/functions/parsers/parseBoolean.ts
 /**
 * Takes a stringly-typed boolean and converts it to an actual boolean type.
 *
@@ -1200,13 +1222,13 @@ function removeUndefinedFromObject(object) {
 */
 function parseBoolean(inputString) {
 	const normalisedString = inputString.toLowerCase();
-	if (!["true", "false"].includes(normalisedString)) throw new DataError(inputString, "INVALID_BOOLEAN_STRING", "The provided boolean string must be one of `true | false`");
+	if (!["true", "false"].includes(normalisedString)) throw new DataError({ inputString }, "INVALID_BOOLEAN_STRING", "The provided boolean string must be one of `true | false`");
 	return normalisedString === "true";
 }
 
 //#endregion
-//#region src/functions/parsers/zod/_parseZodSchema.ts
-function _parseZodSchema(parsedResult, data, onError) {
+//#region src/root/functions/parsers/zod/_parseZodSchema.ts
+function _parseZodSchema(parsedResult, input, onError) {
 	if (!parsedResult.success) {
 		if (onError) {
 			if (onError instanceof Error) throw onError;
@@ -1220,7 +1242,7 @@ function _parseZodSchema(parsedResult, data, onError) {
 			const code = issue.code.toUpperCase();
 			allErrorCodes[code] = (allErrorCodes[code] ?? 0) + 1;
 		}
-		throw new DataError(data, Object.entries(allErrorCodes).toSorted(([_, firstCount], [__, secondCount]) => {
+		throw new DataError({ input }, Object.entries(allErrorCodes).toSorted(([_, firstCount], [__, secondCount]) => {
 			return secondCount - firstCount;
 		}).map(([code, count], _, allErrorCodes) => {
 			return allErrorCodes.length === 1 && count === 1 ? code : `${code}×${count}`;
@@ -1230,7 +1252,7 @@ function _parseZodSchema(parsedResult, data, onError) {
 }
 
 //#endregion
-//#region src/functions/parsers/zod/parseZodSchema.ts
+//#region src/root/functions/parsers/zod/parseZodSchema.ts
 /**
 * An alternative function to zodSchema.parse() that can be used to strictly parse Zod schemas.
 *
@@ -1242,19 +1264,19 @@ function _parseZodSchema(parsedResult, data, onError) {
 * @template ErrorType - The type of error to throw on invalid data.
 *
 * @param schema - The Zod schema to use in parsing.
-* @param data - The data to parse.
+* @param input - The data to parse.
 * @param onError - A custom error to throw on invalid data (defaults to `DataError`). May either be the error itself, or a function that returns the error or nothing. If nothing is returned, the default error is thrown instead.
 *
 * @throws {DataError} If the given data cannot be parsed according to the schema.
 *
 * @returns The parsed data from the Zod schema.
 */
-function parseZodSchema(schema, data, onError) {
-	return _parseZodSchema(schema.safeParse(data), data, onError);
+function parseZodSchema(schema, input, onError) {
+	return _parseZodSchema(schema.safeParse(input), input, onError);
 }
 
 //#endregion
-//#region src/functions/parsers/parseEnv.ts
+//#region src/root/functions/parsers/parseEnv.ts
 /**
 * Represents the three common development environments.
 *
@@ -1270,18 +1292,18 @@ const Env = {
 *
 * @category Parsers
 *
-* @param data - The data to parse.
+* @param input - The data to parse.
 *
 * @throws {DataError} If the data does not match one of the environments allowed by the Env types ("test" | "development" | "production").
 *
 * @returns The specified environment if allowed.
 */
-function parseEnv(data) {
-	return parseZodSchema(z$1.enum(Env), data, new DataError(data, "INVALID_ENV", "The provided environment type must be one of `test | development | production`"));
+function parseEnv(input) {
+	return parseZodSchema(z$1.enum(Env), input, new DataError({ input }, "INVALID_ENV", "The provided environment type must be one of `test | development | production`"));
 }
 
 //#endregion
-//#region src/functions/parsers/parseFilePath.ts
+//#region src/root/functions/parsers/parseFilePath.ts
 /**
 * Takes a file path string and parses it into the directory part, the base part, and the full path.
 *
@@ -1312,7 +1334,7 @@ function parseFilePath(filePath) {
 }
 
 //#endregion
-//#region src/functions/parsers/parseFormData.ts
+//#region src/root/functions/parsers/parseFormData.ts
 /**
 * Returns an object given FormData and an optional data parser function to call on the resulting object.
 *
@@ -1335,7 +1357,7 @@ function parseFormData(formData, dataParser) {
 }
 
 //#endregion
-//#region src/functions/parsers/parseVersionType.ts
+//#region src/root/functions/parsers/parseVersionType.ts
 /**
 * Represents the three common software version types.
 *
@@ -1351,18 +1373,18 @@ const VersionType = {
 *
 * @category Parsers
 *
-* @param data - The data to parse.
+* @param input - The data to parse.
 *
 * @throws {DataError} If the data does not match one of the allowed version types (`"major" | "minor" | "patch"`).
 *
 * @returns The given version type if allowed.
 */
-function parseVersionType(data) {
-	return parseZodSchema(z.enum(VersionType), data, new DataError(data, "INVALID_VERSION_TYPE", "The provided version type must be one of `major | minor | patch`"));
+function parseVersionType(input) {
+	return parseZodSchema(z.enum(VersionType), input, new DataError({ input }, "INVALID_VERSION_TYPE", "The provided version type must be one of `major | minor | patch`"));
 }
 
 //#endregion
-//#region src/functions/parsers/zod/parseZodSchemaAsync.ts
+//#region src/root/functions/parsers/zod/parseZodSchemaAsync.ts
 /**
 * An alternative function to zodSchema.parseAsync() that can be used to strictly parse asynchronous Zod schemas.
 *
@@ -1372,19 +1394,19 @@ function parseVersionType(data) {
 * @template ErrorType - The type of error to throw on invalid data.
 *
 * @param schema - The Zod schema to use in parsing.
-* @param data - The data to parse.
+* @param input - The data to parse.
 * @param onError - A custom error to throw on invalid data (defaults to `DataError`). May either be the error itself, or a function that returns the error or nothing. If nothing is returned, the default error is thrown instead.
 *
 * @throws {DataError} If the given data cannot be parsed according to the schema.
 *
 * @returns The parsed data from the Zod schema.
 */
-async function parseZodSchemaAsync(schema, data, onError) {
-	return _parseZodSchema(await schema.safeParseAsync(data), data, onError);
+async function parseZodSchemaAsync(schema, input, onError) {
+	return _parseZodSchema(await schema.safeParseAsync(input), input, onError);
 }
 
 //#endregion
-//#region src/functions/recursive/deepCopy.ts
+//#region src/root/functions/recursive/deepCopy.ts
 function callDeepCopy(input) {
 	return typeof input === "object" && input !== null ? deepCopy(input) : input;
 }
@@ -1412,7 +1434,7 @@ function deepCopy(object) {
 }
 
 //#endregion
-//#region src/functions/security/encryptWithKey.ts
+//#region src/root/functions/security/encryptWithKey.ts
 /**
 * Encrypt a secret given the public base64 key and the thing you want to encrypt.
 *
@@ -1433,32 +1455,7 @@ async function encryptWithKey(publicKey, plaintextValue) {
 }
 
 //#endregion
-//#region src/functions/security/getPublicAndPrivateKey.ts
-/**
-* Returns the public key and private key, properly narrowing down types depending on the provided `outputFormat`.
-*
-* @deprecated Please use `sodium.crypto_box_keypair` from `libsodium-wrappers` instead.
-*
-* This function was initially created to deal with a typing issue with the package introduced in v0.8.1 of said package, but this seems to have been fixed in v0.8.2
-*
-* @param outputFormat - The format of the resulting publicKey and privateKey you would like to use.
-*
-* @returns An object containing both the publicKey and privateKey, along with a keyType.
-*/
-function getPublicAndPrivateKey(outputFormat) {
-	const keys = sodium.crypto_box_keypair(outputFormat);
-	if (outputFormat === "uint8array" || outputFormat === void 0) {
-		if (!(keys?.publicKey instanceof Uint8Array && keys?.privateKey instanceof Uint8Array)) throw new DataError({
-			publicKey: `<redacted: ${keys?.publicKey?.constructor?.name ?? typeof keys?.publicKey}>`,
-			privateKey: `<redacted: ${keys?.privateKey?.constructor?.name ?? typeof keys?.privateKey}>`
-		}, "INVALID_KEY_TYPES", "Expected Uint8Array keypair from libsodium.");
-		return keys;
-	}
-	return keys;
-}
-
-//#endregion
-//#region src/functions/stringHelpers/appendSemicolon.ts
+//#region src/root/functions/stringHelpers/appendSemicolon.ts
 /**
 * Appends a semicolon to the end of a string, trimming where necessary first.
 *
@@ -1478,7 +1475,7 @@ function appendSemicolon(stringToAppendTo) {
 }
 
 //#endregion
-//#region src/functions/stringHelpers/camelToKebab.ts
+//#region src/root/functions/stringHelpers/camelToKebab.ts
 /**
 * Converts a string from camelCase to kebab-case
 *
@@ -1517,7 +1514,7 @@ function camelToKebab(string, options = { preserveConsecutiveCapitals: true }) {
 }
 
 //#endregion
-//#region src/functions/stringHelpers/kebabToCamel.ts
+//#region src/root/functions/stringHelpers/kebabToCamel.ts
 /**
 * Converts a string from kebab-case to camelCase
 *
@@ -1556,44 +1553,7 @@ function kebabToCamel(string, options) {
 }
 
 //#endregion
-//#region src/functions/stringHelpers/normalizeImportPath.ts
-/**
-* Normalizes an import path meant for use in an import statement in JavaScript.
-* When multiple slashes are found, they're replaced by a single one; when the path contains a trailing slash, it is preserved. On Windows backslashes are used. If the path is a zero-length string, '.' is returned, representing the current working directory.
-*
-* If the path starts with ./, it is preserved (unlike what would happen with path.posix.normalize() normally).
-*
-* Helpful for custom linter rules that need to check (or fix) import paths.
-*
-* @category String Helpers
-*
-* @param importPath - The import path to normalize.
-*
-* @returns The import path normalized.
-*/
-function normalizeImportPath(importPath) {
-	const normalizedPath = path.posix.normalize(importPath);
-	if (importPath.startsWith("./") && !normalizedPath.startsWith("./")) return `./${normalizedPath}`;
-	return normalizedPath;
-}
-/**
-* Normalises an import path meant for use in an import statement in JavaScript.
-* When multiple slashes are found, they're replaced by a single one; when the path contains a trailing slash, it is preserved. On Windows backslashes are used. If the path is a zero-length string, '.' is returned, representing the current working directory.
-*
-* If the path starts with ./, it is preserved (unlike what would happen with path.posix.normalize() normally).
-*
-* Helpful for custom linter rules that need to check (or fix) import paths.
-*
-* @category String Helpers
-*
-* @param importPath - The import path to normalise.
-*
-* @returns The import path normalised.
-*/
-const normaliseImportPath = normalizeImportPath;
-
-//#endregion
-//#region src/functions/stringHelpers/truncate.ts
+//#region src/root/functions/stringHelpers/truncate.ts
 /**
 * Truncates a string and appends `...` to the end of it
 *
@@ -1609,92 +1569,4 @@ function truncate(stringToTruncate, maxLength = 5) {
 }
 
 //#endregion
-//#region src/functions/versioning/parseVersion.ts
-/**
-* Parses a string and verifies it is a valid package version number.
-*
-* Valid formats: `X.Y.Z` or `vX.Y.Z`, where X, Y, and Z are non-negative integers.
-*
-* @deprecated This function does not support the new class-based handling of VersionNumber. Please use `new VersionNumber(input)` instead.
-*
-* @param input - The version string to parse.
-* @param options - Extra options to apply.
-*
-* @throws {DataError} If the input is not a valid version number.
-*
-* @returns The validated version number, prefixed with `v` if it was not already.
-*/
-function parseVersion(input, options) {
-	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 (options?.omitPrefix) return input.startsWith("v") ? input.slice(1) : input;
-	return input.startsWith("v") ? input : `v${input}`;
-}
-
-//#endregion
-//#region src/functions/versioning/getIndividualVersionNumbers.ts
-/**
-* Gets the individual version numbers from a given version number as a tuple of numbers.
-*
-* @deprecated This function does not support the new class-based handling of VersionNumber. Please use one of the following instead:
-*      ```typescript
-*      new VersionNumber(version).major
-*      new VersionNumber(version).minor
-*      new VersionNumber(version).patch
-*      ```
-*
-* @param version - The version number.
-*
-* @returns A tuple of three numbers indicating `[major, minor, patch]`.
-*/
-function getIndividualVersionNumbers(version) {
-	return parseVersion(version, { omitPrefix: true }).split(".").map((versionNumber) => {
-		return parseIntStrict(versionNumber);
-	});
-}
-
-//#endregion
-//#region src/functions/versioning/determineVersionType.ts
-/**
-* Determines whether the given version is a major, minor, or patch version.
-*
-* @deprecated This function does not support the new class-based handling of VersionNumber. Please use `new VersionNumber(version).type` instead.
-*
-* @param version - The version number.
-*
-* @returns Either `"major"`, `"minor"`, or `"patch"`, depending on the version type.
-*/
-function determineVersionType(version) {
-	const [_major, minor, patch] = getIndividualVersionNumbers(version);
-	if (minor === 0 && patch === 0) return "major";
-	if (patch === 0) return "minor";
-	return "patch";
-}
-
-//#endregion
-//#region src/functions/versioning/incrementVersion.ts
-/**
-* Increments the given input version depending on the given increment type.
-*
-* @deprecated This function does not support the new class-based handling of VersionNumber. Please use `new VersionNumber(version).increment(incrementType)` instead.
-*
-* @param version - The version to increment
-* @param incrementType - The type of increment. Can be one of the following:
-* - `"major"`: Change the major version `v1.2.3` → `v2.0.0`
-* - `"minor"`: Change the minor version `v1.2.3` → `v1.3.0`
-* - `"patch"`: Change the patch version `v1.2.3` → `v1.2.4`
-* @param options - Extra options to apply.
-*
-* @returns A new string representing the version with the increment applied.
-*/
-function incrementVersion(version, incrementType, options) {
-	const [major, minor, patch] = getIndividualVersionNumbers(version);
-	const newVersion = {
-		major: `${major + 1}.0.0`,
-		minor: `${major}.${minor + 1}.0`,
-		patch: `${major}.${minor}.${patch + 1}`
-	}[incrementType];
-	return parseVersion(newVersion, { omitPrefix: options?.omitPrefix });
-}
-
-//#endregion
-export { APIError, DataError, Env, FILE_PATH_REGEX, NAMESPACE_EXPORT_REGEX, VERSION_NUMBER_REGEX, VersionNumber, VersionType, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, determineVersionType, encryptWithKey, fillArray, formatDateAndTime, getIndividualVersionNumbers, getInterpolations, getPublicAndPrivateKey, getRandomNumber, getRecordKeys, getStringsAndInterpolations, httpErrorCodeLookup, incrementVersion, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, isTemplateStringsArray, kebabToCamel, normaliseImportPath, normaliseIndents, normalizeImportPath, normalizeIndents, omitProperties, paralleliseArrays, parseBoolean, parseEnv, parseFilePath, parseFormData, parseIntStrict, parseVersion, parseVersionType, parseZodSchema, parseZodSchemaAsync, randomiseArray, range, removeDuplicates, removeUndefinedFromObject, sayHello, stringListToArray, stringifyDotenv, truncate, wait, zodVersionNumber };
+export { APIError, DataError, Env, FILE_PATH_REGEX, NAMESPACE_EXPORT_REGEX, VERSION_NUMBER_REGEX, VersionNumber, VersionType, addDaysToDate, appendSemicolon, camelToKebab, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, encryptWithKey, fillArray, formatDateAndTime, getDependenciesFromGroup, getRandomNumber, getRecordKeys, getStringsAndInterpolations, httpErrorCodeLookup, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isOrdered, isSameDate, isTemplateStringsArray, kebabToCamel, normaliseIndents, normalizeIndents, omitProperties, paralleliseArrays, parseBoolean, parseEnv, parseFilePath, parseFormData, parseIntStrict, parseVersionType, parseZodSchema, parseZodSchemaAsync, randomiseArray, range, removeDuplicates, removeUndefinedFromObject, sayHello, stringListToArray, stringifyDotenv, truncate, wait, zodVersionNumber };