@alextheman/utility 4.13.0 → 4.14.1

package/dist/index.js

@@ -4,17 +4,14 @@ import sodium from "libsodium-wrappers";
 
 //#region src/constants/FILE_PATH_REGEX.ts
 const FILE_PATH_REGEX = String.raw`^(?<directory>.+)[\/\\](?<base>[^\/\\]+)$`;
-var FILE_PATH_REGEX_default = FILE_PATH_REGEX;
 
 //#endregion
 //#region src/constants/NAMESPACE_EXPORT_REGEX.ts
 const NAMESPACE_EXPORT_REGEX = "export\\s+\\*\\s+from";
-var NAMESPACE_EXPORT_REGEX_default = NAMESPACE_EXPORT_REGEX;
 
 //#endregion
 //#region src/constants/VERSION_NUMBER_REGEX.ts
 const VERSION_NUMBER_REGEX = "^(?:v)?(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)$";
-var VERSION_NUMBER_REGEX_default = VERSION_NUMBER_REGEX;
 
 //#endregion
 //#region src/functions/arrayHelpers/fillArray.ts
@@ -42,7 +39,6 @@ function fillArray(callback, length = 1) {
 	})) return Promise.all(outputArray);
 	return outputArray;
 }
-var fillArray_default = fillArray;
 
 //#endregion
 //#region src/functions/arrayHelpers/paralleliseArrays.ts
@@ -67,7 +63,6 @@ function paralleliseArrays(firstArray, secondArray) {
 	for (let i = 0; i < firstArray.length; i++) outputArray.push([firstArray[i], secondArray[i]]);
 	return outputArray;
 }
-var paralleliseArrays_default = paralleliseArrays;
 
 //#endregion
 //#region src/types/APIError.ts
@@ -84,7 +79,7 @@ const httpErrorCodeLookup = {
 *
 * @category Types
 */
-var APIError = class extends Error {
+var APIError = class APIError extends Error {
 	status;
 	/**
 	* @param status - A HTTP status code. Can be any number, but numbers between 400 and 600 are encouraged to fit with HTTP status code conventions.
@@ -107,11 +102,11 @@ var APIError = class extends Error {
 	* @returns `true` if the input is an APIError, and `false` otherwise. The type of the input will also be narrowed down to APIError if `true`.
 	*/
 	static check(input) {
+		if (input instanceof APIError) return true;
 		const data = input;
 		return typeof data === "object" && data !== null && typeof data?.status === "number" && typeof data?.message === "string";
 	}
 };
-var APIError_default = APIError;
 
 //#endregion
 //#region src/types/DataError.ts
@@ -120,7 +115,7 @@ var APIError_default = APIError;
 *
 * @category Types
 */
-var DataError = class extends Error {
+var DataError = class DataError extends Error {
 	code;
 	data;
 	/**
@@ -146,11 +141,11 @@ var DataError = class extends Error {
 	* @returns `true` if the input is a DataError, and `false` otherwise. The type of the input will also be narrowed down to DataError if `true`.
 	*/
 	static check(input) {
+		if (input instanceof DataError) return true;
 		const data = input;
 		return typeof data === "object" && data !== null && typeof data.message === "string" && typeof data.code === "string" && "data" in data;
 	}
 };
-var DataError_default = DataError;
 
 //#endregion
 //#region src/types/VersionNumber.ts
@@ -176,18 +171,18 @@ var VersionNumber = class VersionNumber {
 			this.minor = input.minor;
 			this.patch = input.patch;
 		} else if (typeof input === "string") {
-			if (!RegExp(VERSION_NUMBER_REGEX_default).test(input)) throw new DataError_default(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_default(number);
+				return parseIntStrict(number);
 			});
 			this.major = major;
 			this.minor = minor;
 			this.patch = patch;
 		} else if (Array.isArray(input)) {
-			if (input.length !== 3) throw new DataError_default(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_default(number?.toString());
-				if (parsedInteger < 0) throw new DataError_default(input, "NEGATIVE_INPUTS", VersionNumber.NON_NEGATIVE_TUPLE_ERROR);
+				const parsedInteger = parseIntStrict(number?.toString());
+				if (parsedInteger < 0) throw new DataError(input, "NEGATIVE_INPUTS", VersionNumber.NON_NEGATIVE_TUPLE_ERROR);
 				return parsedInteger;
 			});
 			this.major = major;
@@ -257,7 +252,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_default(this.toString(), "INVALID_COERCION", "VersionNumber cannot be coerced to a number type.");
+		if (hint === "number") throw new DataError(this.toString(), "INVALID_COERCION", "VersionNumber cannot be coerced to a number type.");
 		return this.toString();
 	}
 	/**
@@ -280,7 +275,6 @@ var VersionNumber = class VersionNumber {
 		return VersionNumber.formatString(rawString, options);
 	}
 };
-var VersionNumber_default = VersionNumber;
 
 //#endregion
 //#region src/functions/parsers/parseIntStrict.ts
@@ -299,21 +293,20 @@ var VersionNumber_default = VersionNumber;
 function parseIntStrict(string, radix) {
 	const trimmedString = string.trim();
 	const maxAllowedAlphabeticalCharacter = radix && radix > 10 && radix <= 36 ? String.fromCharCode(87 + radix - 1) : void 0;
-	if (!(radix && radix > 10 && radix <= 36 ? new RegExp(`^[+-]?[0-9a-${maxAllowedAlphabeticalCharacter}]+$`, "i") : /^[+-]?\d+$/).test(trimmedString)) throw new DataError_default(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.`);
 	if (radix && radix < 10 && [...trimmedString].some((character) => {
 		return parseInt(character) >= radix;
-	})) throw new DataError_default({
+	})) throw new DataError({
 		string,
 		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_default(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;
 }
-var parseIntStrict_default = parseIntStrict;
 
 //#endregion
 //#region src/functions/miscellaneous/getRandomNumber.ts
@@ -328,11 +321,10 @@ var parseIntStrict_default = parseIntStrict;
 * @returns A random number between the provided lower bound and upper bound.
 */
 function getRandomNumber(lowerBound, upperBound) {
-	const parsedLowerBound = parseIntStrict_default(`${lowerBound}`);
-	const parsedUpperBound = parseIntStrict_default(`${upperBound}`);
+	const parsedLowerBound = parseIntStrict(`${lowerBound}`);
+	const parsedUpperBound = parseIntStrict(`${upperBound}`);
 	return Math.floor(Math.random() * (parsedUpperBound - parsedLowerBound + 1) + parsedLowerBound);
 }
-var getRandomNumber_default = getRandomNumber;
 
 //#endregion
 //#region src/functions/arrayHelpers/randomiseArray.ts
@@ -351,12 +343,11 @@ function randomiseArray(array) {
 	const mutableArray = [...array];
 	const outputArray = [];
 	do {
-		const indexToRemove = getRandomNumber_default(0, mutableArray.length - 1);
+		const indexToRemove = getRandomNumber(0, mutableArray.length - 1);
 		outputArray.push(mutableArray.splice(indexToRemove, 1)[0]);
 	} while (mutableArray.length > 0);
 	return outputArray;
 }
-var randomiseArray_default = randomiseArray;
 
 //#endregion
 //#region src/functions/arrayHelpers/range.ts
@@ -389,7 +380,6 @@ function range(start, stop, step = 1) {
 	}
 	return numbers;
 }
-var range_default = range;
 
 //#endregion
 //#region src/functions/arrayHelpers/removeDuplicates.ts
@@ -409,7 +399,6 @@ function removeDuplicates(array) {
 	for (const item of array) if (!outputArray.includes(item)) outputArray.push(item);
 	return outputArray;
 }
-var removeDuplicates_default = removeDuplicates;
 
 //#endregion
 //#region src/functions/date/addDaysToDate.ts
@@ -428,7 +417,6 @@ function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement =
 	newDate.setDate(newDate.getDate() + dayIncrement);
 	return newDate;
 }
-var addDaysToDate_default = addDaysToDate;
 
 //#endregion
 //#region src/functions/date/isSameDate.ts
@@ -445,7 +433,6 @@ var addDaysToDate_default = addDaysToDate;
 function isSameDate(firstDate, secondDate) {
 	return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth() && firstDate.getFullYear() === secondDate.getFullYear();
 }
-var isSameDate_default = isSameDate;
 
 //#endregion
 //#region src/functions/date/formatDateAndTime.ts
@@ -463,14 +450,13 @@ var isSameDate_default = isSameDate;
 * - For any other date, the output will be something like `DD/MM/YYYY, HH:MM`
 */
 function formatDateAndTime(inputDate) {
-	const yesterday = addDaysToDate_default(/* @__PURE__ */ new Date(), -1);
+	const yesterday = addDaysToDate(/* @__PURE__ */ new Date(), -1);
 	const today = /* @__PURE__ */ new Date();
 	const inputTime = `${inputDate.getHours().toString().padStart(2, "0")}:${inputDate.getMinutes().toString().padStart(2, "0")}`;
-	if (isSameDate_default(inputDate, yesterday)) return `Yesterday at ${inputTime}`;
-	if (isSameDate_default(inputDate, today)) return `Today at ${inputTime}`;
+	if (isSameDate(inputDate, yesterday)) return `Yesterday at ${inputTime}`;
+	if (isSameDate(inputDate, today)) return `Today at ${inputTime}`;
 	return `${inputDate.getDate().toString().padStart(2, "0")}/${(inputDate.getMonth() + 1).toString().padStart(2, "0")}/${inputDate.getFullYear().toString()}, ${inputTime}`;
 }
-var formatDateAndTime_default = formatDateAndTime;
 
 //#endregion
 //#region src/functions/date/isLeapYear.ts
@@ -486,15 +472,14 @@ var formatDateAndTime_default = formatDateAndTime;
 * @returns True if the year is a leap year, and false otherwise.
 */
 function isLeapYear(year) {
-	const parsedYear = parseIntStrict_default(`${year}`);
+	const parsedYear = parseIntStrict(`${year}`);
 	return parsedYear % 4 === 0 && parsedYear % 100 !== 0 || parsedYear % 400 === 0;
 }
-var isLeapYear_default = isLeapYear;
 
 //#endregion
 //#region src/functions/date/isAnniversary.ts
 function checkLeapYear(firstDate, secondDate) {
-	if (isLeapYear_default(firstDate.getFullYear()) && firstDate.getMonth() === 1 && secondDate.getMonth() === 1) return firstDate.getDate() === 29 && secondDate.getDate() === 28;
+	if (isLeapYear(firstDate.getFullYear()) && firstDate.getMonth() === 1 && secondDate.getMonth() === 1) return firstDate.getDate() === 29 && secondDate.getDate() === 28;
 	return false;
 }
 /**
@@ -511,7 +496,6 @@ function isAnniversary(firstDate, secondDate) {
 	if (checkLeapYear(firstDate, secondDate) || checkLeapYear(secondDate, firstDate)) return true;
 	return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth();
 }
-var isAnniversary_default = isAnniversary;
 
 //#endregion
 //#region src/functions/date/isMonthlyMultiple.ts
@@ -526,7 +510,7 @@ function endOfMonthChecksButNotFebruary(firstDate, secondDate) {
 }
 function nonLeapYearFebruaryChecks(firstDate, secondDate) {
 	if (firstDate.getMonth() === 1) {
-		if (!isLeapYear_default(firstDate.getFullYear()) && firstDate.getDate() === 28) return [
+		if (!isLeapYear(firstDate.getFullYear()) && firstDate.getDate() === 28) return [
 			28,
 			29,
 			30,
@@ -537,7 +521,7 @@ function nonLeapYearFebruaryChecks(firstDate, secondDate) {
 }
 function leapYearFebruaryChecks(firstDate, secondDate) {
 	if (firstDate.getMonth() === 1) {
-		if (isLeapYear_default(firstDate.getFullYear()) && firstDate.getDate() === 29) return [
+		if (isLeapYear(firstDate.getFullYear()) && firstDate.getDate() === 29) return [
 			29,
 			30,
 			31
@@ -561,7 +545,6 @@ function isMonthlyMultiple(firstDate, secondDate) {
 	if (leapYearFebruaryChecks(firstDate, secondDate) || leapYearFebruaryChecks(secondDate, firstDate)) return true;
 	return firstDate.getDate() === secondDate.getDate();
 }
-var isMonthlyMultiple_default = isMonthlyMultiple;
 
 //#endregion
 //#region src/functions/miscellaneous/convertFileToBase64.ts
@@ -592,7 +575,6 @@ function convertFileToBase64(file) {
 		};
 	});
 }
-var convertFileToBase64_default = convertFileToBase64;
 
 //#endregion
 //#region src/functions/miscellaneous/createFormData.ts
@@ -662,7 +644,6 @@ function createFormData(data, options = {
 	} else formData.append(String(key), String(value));
 	return formData;
 }
-var createFormData_default = createFormData;
 
 //#endregion
 //#region src/functions/miscellaneous/isOrdered.ts
@@ -681,7 +662,6 @@ function isOrdered(array) {
 	for (const index in newArray) if (newArray[index] !== array[index]) return false;
 	return true;
 }
-var isOrdered_default = isOrdered;
 
 //#endregion
 //#region src/functions/recursive/deepFreeze.ts
@@ -706,7 +686,6 @@ function deepFreeze(object) {
 	}
 	return Object.freeze(object);
 }
-var deepFreeze_default = deepFreeze;
 
 //#endregion
 //#region src/functions/taggedTemplate/createTemplateStringsArray.ts
@@ -720,13 +699,13 @@ var deepFreeze_default = deepFreeze;
 * @returns A template strings array that can be passed as the first argument of any tagged template function.
 */
 function createTemplateStringsArray(strings) {
-	return deepFreeze_default(Object.assign([...strings], { raw: [...strings] }));
+	return deepFreeze(Object.assign([...strings], { raw: [...strings] }));
 }
-var createTemplateStringsArray_default = createTemplateStringsArray;
 
 //#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:
 *
@@ -736,6 +715,8 @@ var createTemplateStringsArray_default = createTemplateStringsArray;
 *
 * @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.
 *
@@ -744,7 +725,47 @@ var createTemplateStringsArray_default = createTemplateStringsArray;
 function getInterpolations(strings, ...interpolations) {
 	return [strings, interpolations];
 }
-var getInterpolations_default = getInterpolations;
+
+//#endregion
+//#region src/functions/taggedTemplate/getStringsAndInterpolations.ts
+/**
+*
+* Gets the strings and interpolations separately from a template string.
+* You can pass a template string directly by doing:
+*
+* ```typescript
+* getStringsAndInterpolations`Template string here`;
+* ```
+*
+* @category Tagged Template
+*
+* @template InterpolationsType - The type of the interpolations.
+*
+* @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 remaining items are the interpolations.
+*
+* The return of this function may also be spread into any other tagged template function in the following way:
+*
+* ```typescript
+* import { interpolate } from "@alextheman/utility"; // Example function
+*
+* const packageName = "@alextheman/utility";
+* const packageManager = getPackageManager(packageName);
+*
+* interpolate(...getStringsAndInterpolations`The package ${packageName} uses the ${packageManager} package manager.`);
+* ```
+*/
+function getStringsAndInterpolations(strings, ...interpolations) {
+	if (strings.length !== interpolations.length + 1) throw new DataError({
+		stringsLength: strings.length,
+		interpolationsLength: interpolations.length,
+		strings,
+		interpolations
+	}, "INVALID_STRINGS_AND_INTERPOLATIONS_LENGTH", "The length of the strings must be exactly one more than the length of the interpolations.");
+	return [createTemplateStringsArray(strings), ...interpolations];
+}
 
 //#endregion
 //#region src/functions/taggedTemplate/interpolate.ts
@@ -761,6 +782,8 @@ var getInterpolations_default = getInterpolations;
 *
 * @category Tagged Template
 *
+* @template InterpolationsType - The type of the interpolations.
+*
 * @param strings - The strings from the template to process.
 * @param interpolations - An array of all interpolations from the template.
 *
@@ -768,10 +791,9 @@ var getInterpolations_default = getInterpolations;
 */
 function interpolate(strings, ...interpolations) {
 	let result = "";
-	for (const [string, interpolation = ""] of paralleliseArrays_default(strings, interpolations)) result += string + interpolation;
+	for (const [string, interpolation = ""] of paralleliseArrays(strings, interpolations)) result += string + interpolation;
 	return result;
 }
-var interpolate_default = interpolate;
 
 //#endregion
 //#region src/functions/taggedTemplate/interpolateObjects.ts
@@ -781,11 +803,13 @@ var interpolate_default = interpolate;
 * You can pass a template string directly by doing:
 *
 * ```typescript
-* interpolateObjects`Template string here ${{ my: "object" }}`.
+* interpolateObjects`Template string here ${{ my: "object" }}`;
 * ```
 *
 * @category Tagged Template
 *
+* @template InterpolationsType - The type of the interpolations.
+*
 * @param strings - The strings from the template to process.
 * @param interpolations - An array of all interpolations from the template.
 *
@@ -799,7 +823,21 @@ function interpolateObjects(strings, ...interpolations) {
 	}
 	return result;
 }
-var interpolateObjects_default = interpolateObjects;
+
+//#endregion
+//#region src/functions/taggedTemplate/isTemplateStringsArray.ts
+/**
+* Determines whether or not the input is a valid `TemplateStringsArray`.
+*
+* @category Tagged Template
+*
+* @param input - The input to check
+*
+* @returns `true` if the input is a valid `TemplateStringsArray`, and false otherwise. The type of the input will also be narrowed down to `TemplateStringsArray` if `true`.
+*/
+function isTemplateStringsArray(input) {
+	return typeof input === "object" && input !== null && "raw" in input;
+}
 
 //#endregion
 //#region src/functions/taggedTemplate/normaliseIndents.ts
@@ -822,7 +860,7 @@ function reduceLines(lines, { preserveTabs = true }) {
 	const whitespaceLength = getWhitespaceLength(isFirstLineEmpty ? lines : slicedLines);
 	return (isFirstLineEmpty ? slicedLines : lines).map((line) => {
 		const tabSize = calculateTabSize(line, whitespaceLength);
-		return (preserveTabs ? fillArray_default(() => {
+		return (preserveTabs ? fillArray(() => {
 			return " ";
 		}, tabSize).join("") : "") + line.trimStart();
 	}).join("\n");
@@ -835,7 +873,7 @@ function reduceLines(lines, { preserveTabs = true }) {
 * ```typescript
 * normaliseIndents`Template string here
 *     with a new line
-*     and another new line`.
+*     and another new line`;
 * ```
 *
 * You may also pass the options first, then invoke the resulting function with a template string:
@@ -843,10 +881,10 @@ function reduceLines(lines, { preserveTabs = true }) {
 * ```typescript
 * normaliseIndents({ preserveTabs: false })`Template string here
 *     with a new line
-*     and another new line`.
+*     and another new line`;
 * ```
 *
-*@category Tagged Template
+* @category Tagged Template
 *
 * @param first - The strings from the template to process, or the options to apply.
 * @param args - An array of all interpolations from the template.
@@ -862,7 +900,7 @@ function normaliseIndents(first, ...args) {
 	}
 	const strings = first;
 	const options = typeof args[args.length - 1] === "object" && !Array.isArray(args[args.length - 1]) ? args.pop() : {};
-	return reduceLines(interpolate_default(strings, ...[...args]).split("\n"), options);
+	return reduceLines(interpolate(strings, ...[...args]).split("\n"), options);
 }
 /**
 * Applies any options if provided, then removes any extraneous indents from a multi-line template string.
@@ -889,7 +927,6 @@ function normaliseIndents(first, ...args) {
 * @returns An additional function to invoke, or a new string with the strings and interpolations from the template applied, and extraneous indents removed.
 */
 const normalizeIndents = normaliseIndents;
-var normaliseIndents_default = normaliseIndents;
 
 //#endregion
 //#region src/functions/miscellaneous/sayHello.ts
@@ -901,7 +938,7 @@ var normaliseIndents_default = normaliseIndents;
 * @returns The lyrics string in markdown format.
 */
 function sayHello() {
-	return normaliseIndents_default`
+	return normaliseIndents`
     # Commit To You
 
     ### Verse 1
@@ -1004,7 +1041,6 @@ function sayHello() {
     I'll commit to you!
     `;
 }
-var sayHello_default = sayHello;
 
 //#endregion
 //#region src/functions/miscellaneous/stringifyDotenv.ts
@@ -1021,8 +1057,8 @@ function stringifyDotenv(contents, options) {
 	const { quoteStyle = "double" } = options ?? {};
 	let result = "";
 	for (const key in contentsCopy) {
-		if (/[ \t\r\n]/.test(key)) throw new DataError_default({ [key]: contentsCopy[key] }, "INVALID_KEY", "Environment variables are not allowed to have whitespace.");
-		if (quoteStyle === "none") if (/[ \t\r\n]/.test(contentsCopy[key]) || contentsCopy[key].includes("#") || contentsCopy[key].includes("=") || contentsCopy[key].includes("\\")) throw new DataError_default({ [key]: contentsCopy[key] }, "INCOMPATIBLE_QUOTE_STYLE", "Cannot use `{ quoteStyle: \"none\" }` when value has whitespace, #, =, or \\");
+		if (/[ \t\r\n]/.test(key)) throw new DataError({ [key]: contentsCopy[key] }, "INVALID_KEY", "Environment variables are not allowed to have whitespace.");
+		if (quoteStyle === "none") if (/[ \t\r\n]/.test(contentsCopy[key]) || contentsCopy[key].includes("#") || contentsCopy[key].includes("=") || contentsCopy[key].includes("\\")) throw new DataError({ [key]: contentsCopy[key] }, "INCOMPATIBLE_QUOTE_STYLE", "Cannot use `{ quoteStyle: \"none\" }` when value has whitespace, #, =, or \\");
 		else {
 			result += `${key}=${contentsCopy[key]}\n`;
 			continue;
@@ -1041,7 +1077,6 @@ function stringifyDotenv(contents, options) {
 	}
 	return result;
 }
-var stringifyDotenv_default = stringifyDotenv;
 
 //#endregion
 //#region src/functions/miscellaneous/stringListToArray.ts
@@ -1064,7 +1099,6 @@ function stringListToArray(stringList, { separator = ",", trimWhitespace = true
 		return item.trim();
 	}) : arrayList;
 }
-var stringListToArray_default = stringListToArray;
 
 //#endregion
 //#region src/functions/miscellaneous/wait.ts
@@ -1084,7 +1118,6 @@ function wait(seconds) {
 		}, seconds * 1e3);
 	});
 }
-var wait_default = wait;
 
 //#endregion
 //#region src/functions/objectHelpers/getRecordKeys.ts
@@ -1102,7 +1135,6 @@ var wait_default = wait;
 function getRecordKeys(record) {
 	return Object.keys(record);
 }
-var getRecordKeys_default = getRecordKeys;
 
 //#endregion
 //#region src/functions/objectHelpers/omitProperties.ts
@@ -1126,7 +1158,6 @@ function omitProperties(object, keysToOmit) {
 	});
 	return outputObject;
 }
-var omitProperties_default = omitProperties;
 
 //#endregion
 //#region src/functions/objectHelpers/removeUndefinedFromObject.ts
@@ -1142,7 +1173,6 @@ function removeUndefinedFromObject(object) {
 		return value !== void 0;
 	}));
 }
-var removeUndefinedFromObject_default = removeUndefinedFromObject;
 
 //#endregion
 //#region src/functions/parsers/parseBoolean.ts
@@ -1159,10 +1189,9 @@ var removeUndefinedFromObject_default = removeUndefinedFromObject;
 */
 function parseBoolean(inputString) {
 	const normalisedString = inputString.toLowerCase();
-	if (!["true", "false"].includes(normalisedString)) throw new DataError_default(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";
 }
-var parseBoolean_default = parseBoolean;
 
 //#endregion
 //#region src/functions/parsers/zod/_parseZodSchema.ts
@@ -1180,7 +1209,7 @@ function _parseZodSchema(parsedResult, data, onError) {
 			const code = issue.code.toUpperCase();
 			allErrorCodes[code] = (allErrorCodes[code] ?? 0) + 1;
 		}
-		throw new DataError_default(data, Object.entries(allErrorCodes).toSorted(([_, firstCount], [__, secondCount]) => {
+		throw new DataError(data, Object.entries(allErrorCodes).toSorted(([_, firstCount], [__, secondCount]) => {
 			return secondCount - firstCount;
 		}).map(([code, count], _, allErrorCodes) => {
 			return allErrorCodes.length === 1 && count === 1 ? code : `${code}×${count}`;
@@ -1188,7 +1217,6 @@ function _parseZodSchema(parsedResult, data, onError) {
 	}
 	return parsedResult.data;
 }
-var _parseZodSchema_default = _parseZodSchema;
 
 //#endregion
 //#region src/functions/parsers/zod/parseZodSchema.ts
@@ -1211,9 +1239,8 @@ var _parseZodSchema_default = _parseZodSchema;
 * @returns The parsed data from the Zod schema.
 */
 function parseZodSchema(schema, data, onError) {
-	return _parseZodSchema_default(schema.safeParse(data), data, onError);
+	return _parseZodSchema(schema.safeParse(data), data, onError);
 }
-var parseZodSchema_default = parseZodSchema;
 
 //#endregion
 //#region src/functions/parsers/parseEnv.ts
@@ -1239,9 +1266,8 @@ const Env = {
 * @returns The specified environment if allowed.
 */
 function parseEnv(data) {
-	return parseZodSchema_default(z$1.enum(Env), data, new DataError_default(data, "INVALID_ENV", "The provided environment type must be one of `test | development | production`"));
+	return parseZodSchema(z$1.enum(Env), data, new DataError(data, "INVALID_ENV", "The provided environment type must be one of `test | development | production`"));
 }
-var parseEnv_default = parseEnv;
 
 //#endregion
 //#region src/functions/parsers/parseFilePath.ts
@@ -1257,23 +1283,22 @@ var parseEnv_default = parseEnv;
 * @returns An object representing the different ways the file path can be represented.
 */
 function parseFilePath(filePath) {
-	const caughtGroups = filePath.match(RegExp(FILE_PATH_REGEX_default));
+	const caughtGroups = filePath.match(RegExp(FILE_PATH_REGEX));
 	if (!caughtGroups) {
 		if (!(filePath.includes("/") || filePath.includes("\\")) && filePath.includes(".")) return {
 			directory: "",
 			base: filePath,
 			fullPath: filePath
 		};
-		throw new DataError_default({ filePath }, "INVALID_FILE_PATH", "The file path you provided is not valid.");
+		throw new DataError({ filePath }, "INVALID_FILE_PATH", "The file path you provided is not valid.");
 	}
-	if (!caughtGroups.groups) throw new DataError_default({ filePath }, "PARSING_ERROR", "An error occurred while trying to parse the data.");
+	if (!caughtGroups.groups) throw new DataError({ filePath }, "PARSING_ERROR", "An error occurred while trying to parse the data.");
 	return {
 		directory: caughtGroups.groups.directory,
 		base: caughtGroups.groups.base,
 		fullPath: path.join(caughtGroups.groups.directory.replaceAll("\\", "/"), caughtGroups.groups.base)
 	};
 }
-var parseFilePath_default = parseFilePath;
 
 //#endregion
 //#region src/functions/parsers/parseFormData.ts
@@ -1297,7 +1322,6 @@ function parseFormData(formData, dataParser) {
 	if (dataParser) return dataParser(object);
 	return object;
 }
-var parseFormData_default = parseFormData;
 
 //#endregion
 //#region src/functions/parsers/parseVersionType.ts
@@ -1323,9 +1347,8 @@ const VersionType = {
 * @returns The given version type if allowed.
 */
 function parseVersionType(data) {
-	return parseZodSchema_default(z.enum(VersionType), data, new DataError_default(data, "INVALID_VERSION_TYPE", "The provided version type must be one of `major | minor | patch`"));
+	return parseZodSchema(z.enum(VersionType), data, new DataError(data, "INVALID_VERSION_TYPE", "The provided version type must be one of `major | minor | patch`"));
 }
-var parseVersionType_default = parseVersionType;
 
 //#endregion
 //#region src/functions/parsers/zod/parseZodSchemaAsync.ts
@@ -1346,9 +1369,8 @@ var parseVersionType_default = parseVersionType;
 * @returns The parsed data from the Zod schema.
 */
 async function parseZodSchemaAsync(schema, data, onError) {
-	return _parseZodSchema_default(await schema.safeParseAsync(data), data, onError);
+	return _parseZodSchema(await schema.safeParseAsync(data), data, onError);
 }
-var parseZodSchemaAsync_default = parseZodSchemaAsync;
 
 //#endregion
 //#region src/functions/recursive/deepCopy.ts
@@ -1377,7 +1399,6 @@ function deepCopy(object) {
 	}
 	return clonedObject;
 }
-var deepCopy_default = deepCopy;
 
 //#endregion
 //#region src/functions/security/encryptWithKey.ts
@@ -1396,10 +1417,9 @@ async function encryptWithKey(publicKey, plaintextValue) {
 		const encryptedValue = sodium.crypto_box_seal(plaintextValue, base64Key);
 		return sodium.to_base64(encryptedValue, sodium.base64_variants.ORIGINAL);
 	} catch {
-		throw new DataError_default({ publicKey }, "ENCRYPTION_FAILED", "Encryption failed. Please double-check that the given key is a valid base 64 string.");
+		throw new DataError({ publicKey }, "ENCRYPTION_FAILED", "Encryption failed. Please double-check that the given key is a valid base 64 string.");
 	}
 }
-var encryptWithKey_default = encryptWithKey;
 
 //#endregion
 //#region src/functions/security/getPublicAndPrivateKey.ts
@@ -1417,7 +1437,7 @@ var encryptWithKey_default = encryptWithKey;
 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_default({
+		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.");
@@ -1425,7 +1445,6 @@ function getPublicAndPrivateKey(outputFormat) {
 	}
 	return keys;
 }
-var getPublicAndPrivateKey_default = getPublicAndPrivateKey;
 
 //#endregion
 //#region src/functions/stringHelpers/appendSemicolon.ts
@@ -1446,7 +1465,6 @@ function appendSemicolon(stringToAppendTo) {
 	if (stringWithNoTrailingWhitespace === "") return "";
 	return stringWithNoTrailingWhitespace[stringWithNoTrailingWhitespace.length - 1] === ";" ? stringWithNoTrailingWhitespace : `${stringWithNoTrailingWhitespace};`;
 }
-var appendSemicolon_default = appendSemicolon;
 
 //#endregion
 //#region src/functions/stringHelpers/camelToKebab.ts
@@ -1486,7 +1504,6 @@ function camelToKebab(string, options = { preserveConsecutiveCapitals: true }) {
 	}
 	return result;
 }
-var camelToKebab_default = camelToKebab;
 
 //#endregion
 //#region src/functions/stringHelpers/kebabToCamel.ts
@@ -1510,7 +1527,7 @@ function kebabToCamel(string, options) {
 			skip = false;
 			continue;
 		}
-		const index = parseIntStrict_default(stringIndex);
+		const index = parseIntStrict(stringIndex);
 		if (index === 0 && options?.startWithUpper) {
 			outputString += string[index].toUpperCase();
 			continue;
@@ -1526,7 +1543,6 @@ function kebabToCamel(string, options) {
 	}
 	return outputString;
 }
-var kebabToCamel_default = kebabToCamel;
 
 //#endregion
 //#region src/functions/stringHelpers/normalizeImportPath.ts
@@ -1564,7 +1580,6 @@ function normalizeImportPath(importPath) {
 * @returns The import path normalised.
 */
 const normaliseImportPath = normalizeImportPath;
-var normalizeImportPath_default = normalizeImportPath;
 
 //#endregion
 //#region src/functions/stringHelpers/truncate.ts
@@ -1581,7 +1596,6 @@ var normalizeImportPath_default = normalizeImportPath;
 function truncate(stringToTruncate, maxLength = 5) {
 	return stringToTruncate.length > maxLength ? `${stringToTruncate.slice(0, maxLength)}...` : stringToTruncate;
 }
-var truncate_default = truncate;
 
 //#endregion
 //#region src/functions/versioning/parseVersion.ts
@@ -1600,11 +1614,10 @@ var truncate_default = truncate;
 * @returns The validated version number, prefixed with `v` if it was not already.
 */
 function parseVersion(input, options) {
-	if (!RegExp(VERSION_NUMBER_REGEX_default).test(input)) throw new DataError_default(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.`);
 	if (options?.omitPrefix) return input.startsWith("v") ? input.slice(1) : input;
 	return input.startsWith("v") ? input : `v${input}`;
 }
-var parseVersion_default = parseVersion;
 
 //#endregion
 //#region src/functions/versioning/getIndividualVersionNumbers.ts
@@ -1623,11 +1636,10 @@ var parseVersion_default = parseVersion;
 * @returns A tuple of three numbers indicating `[major, minor, patch]`.
 */
 function getIndividualVersionNumbers(version) {
-	return parseVersion_default(version, { omitPrefix: true }).split(".").map((versionNumber) => {
-		return parseIntStrict_default(versionNumber);
+	return parseVersion(version, { omitPrefix: true }).split(".").map((versionNumber) => {
+		return parseIntStrict(versionNumber);
 	});
 }
-var getIndividualVersionNumbers_default = getIndividualVersionNumbers;
 
 //#endregion
 //#region src/functions/versioning/determineVersionType.ts
@@ -1641,12 +1653,11 @@ var getIndividualVersionNumbers_default = getIndividualVersionNumbers;
 * @returns Either `"major"`, `"minor"`, or `"patch"`, depending on the version type.
 */
 function determineVersionType(version) {
-	const [_major, minor, patch] = getIndividualVersionNumbers_default(version);
+	const [_major, minor, patch] = getIndividualVersionNumbers(version);
 	if (minor === 0 && patch === 0) return "major";
 	if (patch === 0) return "minor";
 	return "patch";
 }
-var determineVersionType_default = determineVersionType;
 
 //#endregion
 //#region src/functions/versioning/incrementVersion.ts
@@ -1665,15 +1676,14 @@ var determineVersionType_default = determineVersionType;
 * @returns A new string representing the version with the increment applied.
 */
 function incrementVersion(version, incrementType, options) {
-	const [major, minor, patch] = getIndividualVersionNumbers_default(version);
+	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_default(newVersion, { omitPrefix: options?.omitPrefix });
+	return parseVersion(newVersion, { omitPrefix: options?.omitPrefix });
 }
-var incrementVersion_default = incrementVersion;
 
 //#endregion
-export { APIError_default as APIError, DataError_default as DataError, Env, FILE_PATH_REGEX_default as FILE_PATH_REGEX, NAMESPACE_EXPORT_REGEX_default as NAMESPACE_EXPORT_REGEX, VERSION_NUMBER_REGEX_default as VERSION_NUMBER_REGEX, VersionNumber_default as VersionNumber, VersionType, addDaysToDate_default as addDaysToDate, appendSemicolon_default as appendSemicolon, camelToKebab_default as camelToKebab, convertFileToBase64_default as convertFileToBase64, createFormData_default as createFormData, createTemplateStringsArray_default as createTemplateStringsArray, deepCopy_default as deepCopy, deepFreeze_default as deepFreeze, determineVersionType_default as determineVersionType, encryptWithKey_default as encryptWithKey, fillArray_default as fillArray, formatDateAndTime_default as formatDateAndTime, getIndividualVersionNumbers_default as getIndividualVersionNumbers, getInterpolations_default as getInterpolations, getPublicAndPrivateKey_default as getPublicAndPrivateKey, getRandomNumber_default as getRandomNumber, getRecordKeys_default as getRecordKeys, httpErrorCodeLookup, incrementVersion_default as incrementVersion, interpolate_default as interpolate, interpolateObjects_default as interpolateObjects, isAnniversary_default as isAnniversary, isLeapYear_default as isLeapYear, isMonthlyMultiple_default as isMonthlyMultiple, isOrdered_default as isOrdered, isSameDate_default as isSameDate, kebabToCamel_default as kebabToCamel, normaliseImportPath, normaliseIndents_default as normaliseIndents, normalizeImportPath_default as normalizeImportPath, normalizeIndents, omitProperties_default as omitProperties, paralleliseArrays_default as paralleliseArrays, parseBoolean_default as parseBoolean, parseEnv_default as parseEnv, parseFilePath_default as parseFilePath, parseFormData_default as parseFormData, parseIntStrict_default as parseIntStrict, parseVersion_default as parseVersion, parseVersionType_default as parseVersionType, parseZodSchema_default as parseZodSchema, parseZodSchemaAsync_default as parseZodSchemaAsync, randomiseArray_default as randomiseArray, range_default as range, removeDuplicates_default as removeDuplicates, removeUndefinedFromObject_default as removeUndefinedFromObject, sayHello_default as sayHello, stringListToArray_default as stringListToArray, stringifyDotenv_default as stringifyDotenv, truncate_default as truncate, wait_default as wait };
+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 };