@alextheman/utility 4.16.2 → 5.0.0

package/dist/index.cjs

@@ -33,19 +33,19 @@ node_path = __toESM(node_path);
 let libsodium_wrappers = require("libsodium-wrappers");
 libsodium_wrappers = __toESM(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.
 *
@@ -72,7 +72,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.
 *
@@ -96,7 +96,7 @@ function paralleliseArrays(firstArray, secondArray) {
 }
 
 //#endregion
-//#region src/types/APIError.ts
+//#region src/root/types/APIError.ts
 const httpErrorCodeLookup = {
 	400: "BAD_REQUEST",
 	401: "UNAUTHORISED",
@@ -140,11 +140,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;
@@ -179,7 +181,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.
 *
@@ -202,7 +204,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);
 			});
@@ -210,10 +212,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;
@@ -247,33 +249,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.
@@ -283,7 +312,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();
 	}
 	/**
@@ -297,13 +326,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 = zod.default.union([
@@ -319,7 +346,7 @@ const zodVersionNumber = zod.default.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.
 *
@@ -338,7 +365,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({
@@ -346,12 +373,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.
 *
@@ -369,7 +396,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.
 *
@@ -392,7 +419,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.
 *
@@ -424,7 +451,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.
 *
@@ -443,7 +470,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.
 *
@@ -461,7 +488,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.
 *
@@ -477,7 +504,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.
 *
@@ -501,7 +528,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.
 *
@@ -519,7 +546,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;
@@ -540,7 +567,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,
@@ -589,7 +616,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
 *
@@ -619,7 +646,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";
 }
@@ -688,7 +715,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(zod.default.record(zod.default.string(), zod.default.string()), packageInfo.dependencies ?? {}),
+		devDependencies: parseZodSchema(zod.default.record(zod.default.string(), zod.default.string()), packageInfo.devDependencies ?? {})
+	}[dependencyGroup];
+}
+
+//#endregion
+//#region src/root/functions/miscellaneous/isOrdered.ts
 /**
 * Checks to see if the given array is sorted in ascending order.
 *
@@ -706,7 +752,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.
 *
@@ -730,7 +776,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
 *
@@ -745,31 +791,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.
@@ -810,7 +832,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.
 *
@@ -838,7 +860,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.
 *
@@ -867,7 +889,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`.
 *
@@ -882,7 +904,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();
@@ -971,7 +993,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
 *
@@ -1085,7 +1107,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.
 *
@@ -1121,7 +1143,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.
 *
@@ -1143,7 +1165,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
 *
@@ -1162,7 +1184,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.
 *
@@ -1179,7 +1201,7 @@ function getRecordKeys(record) {
 }
 
 //#endregion
-//#region src/functions/objectHelpers/omitProperties.ts
+//#region src/root/functions/objectHelpers/omitProperties.ts
 /**
 * Omits properties from a given object.
 *
@@ -1202,7 +1224,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.).
 *
@@ -1217,7 +1239,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.
 *
@@ -1231,13 +1253,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;
@@ -1251,7 +1273,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}`;
@@ -1261,7 +1283,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.
 *
@@ -1273,19 +1295,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.
 *
@@ -1301,18 +1323,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(zod.z.enum(Env), data, new DataError(data, "INVALID_ENV", "The provided environment type must be one of `test | development | production`"));
+function parseEnv(input) {
+	return parseZodSchema(zod.z.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.
 *
@@ -1343,7 +1365,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.
 *
@@ -1366,7 +1388,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.
 *
@@ -1382,18 +1404,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(zod.default.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(zod.default.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.
 *
@@ -1403,19 +1425,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;
 }
@@ -1443,7 +1465,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.
 *
@@ -1464,32 +1486,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 = libsodium_wrappers.default.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.
 *
@@ -1509,7 +1506,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
 *
@@ -1548,7 +1545,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
 *
@@ -1587,44 +1584,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 = node_path.default.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
 *
@@ -1639,94 +1599,6 @@ function truncate(stringToTruncate, maxLength = 5) {
 	return stringToTruncate.length > maxLength ? `${stringToTruncate.slice(0, maxLength)}...` : stringToTruncate;
 }
 
-//#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
 exports.APIError = APIError;
 exports.DataError = DataError;
@@ -1744,18 +1616,14 @@ exports.createFormData = createFormData;
 exports.createTemplateStringsArray = createTemplateStringsArray;
 exports.deepCopy = deepCopy;
 exports.deepFreeze = deepFreeze;
-exports.determineVersionType = determineVersionType;
 exports.encryptWithKey = encryptWithKey;
 exports.fillArray = fillArray;
 exports.formatDateAndTime = formatDateAndTime;
-exports.getIndividualVersionNumbers = getIndividualVersionNumbers;
-exports.getInterpolations = getInterpolations;
-exports.getPublicAndPrivateKey = getPublicAndPrivateKey;
+exports.getDependenciesFromGroup = getDependenciesFromGroup;
 exports.getRandomNumber = getRandomNumber;
 exports.getRecordKeys = getRecordKeys;
 exports.getStringsAndInterpolations = getStringsAndInterpolations;
 exports.httpErrorCodeLookup = httpErrorCodeLookup;
-exports.incrementVersion = incrementVersion;
 exports.interpolate = interpolate;
 exports.interpolateObjects = interpolateObjects;
 exports.isAnniversary = isAnniversary;
@@ -1765,9 +1633,7 @@ exports.isOrdered = isOrdered;
 exports.isSameDate = isSameDate;
 exports.isTemplateStringsArray = isTemplateStringsArray;
 exports.kebabToCamel = kebabToCamel;
-exports.normaliseImportPath = normaliseImportPath;
 exports.normaliseIndents = normaliseIndents;
-exports.normalizeImportPath = normalizeImportPath;
 exports.normalizeIndents = normalizeIndents;
 exports.omitProperties = omitProperties;
 exports.paralleliseArrays = paralleliseArrays;
@@ -1776,7 +1642,6 @@ exports.parseEnv = parseEnv;
 exports.parseFilePath = parseFilePath;
 exports.parseFormData = parseFormData;
 exports.parseIntStrict = parseIntStrict;
-exports.parseVersion = parseVersion;
 exports.parseVersionType = parseVersionType;
 exports.parseZodSchema = parseZodSchema;
 exports.parseZodSchemaAsync = parseZodSchemaAsync;