@alextheman/utility 4.13.0 → 4.14.1

package/dist/index.cjs

@@ -1,4 +1,5 @@
-//#region rolldown:runtime
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+//#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -34,17 +35,14 @@ libsodium_wrappers = __toESM(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
@@ -72,7 +70,6 @@ function fillArray(callback, length = 1) {
 	})) return Promise.all(outputArray);
 	return outputArray;
 }
-var fillArray_default = fillArray;
 
 //#endregion
 //#region src/functions/arrayHelpers/paralleliseArrays.ts
@@ -97,7 +94,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
@@ -114,7 +110,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.
@@ -137,11 +133,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
@@ -150,7 +146,7 @@ var APIError_default = APIError;
 *
 * @category Types
 */
-var DataError = class extends Error {
+var DataError = class DataError extends Error {
 	code;
 	data;
 	/**
@@ -176,11 +172,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
@@ -206,18 +202,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;
@@ -287,7 +283,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();
 	}
 	/**
@@ -310,7 +306,6 @@ var VersionNumber = class VersionNumber {
 		return VersionNumber.formatString(rawString, options);
 	}
 };
-var VersionNumber_default = VersionNumber;
 
 //#endregion
 //#region src/functions/parsers/parseIntStrict.ts
@@ -329,21 +324,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
@@ -358,11 +352,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
@@ -381,12 +374,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
@@ -419,7 +411,6 @@ function range(start, stop, step = 1) {
 	}
 	return numbers;
 }
-var range_default = range;
 
 //#endregion
 //#region src/functions/arrayHelpers/removeDuplicates.ts
@@ -439,7 +430,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
@@ -458,7 +448,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
@@ -475,7 +464,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
@@ -493,14 +481,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
@@ -516,15 +503,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;
 }
 /**
@@ -541,7 +527,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
@@ -556,7 +541,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,
@@ -567,7 +552,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
@@ -591,7 +576,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
@@ -622,7 +606,6 @@ function convertFileToBase64(file) {
 		};
 	});
 }
-var convertFileToBase64_default = convertFileToBase64;
 
 //#endregion
 //#region src/functions/miscellaneous/createFormData.ts
@@ -692,7 +675,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
@@ -711,7 +693,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
@@ -736,7 +717,6 @@ function deepFreeze(object) {
 	}
 	return Object.freeze(object);
 }
-var deepFreeze_default = deepFreeze;
 
 //#endregion
 //#region src/functions/taggedTemplate/createTemplateStringsArray.ts
@@ -750,13 +730,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:
 *
@@ -766,6 +746,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.
 *
@@ -774,7 +756,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
@@ -791,6 +813,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.
 *
@@ -798,10 +822,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
@@ -811,11 +834,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.
 *
@@ -829,7 +854,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
@@ -852,7 +891,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");
@@ -865,7 +904,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:
@@ -873,10 +912,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.
@@ -892,7 +931,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.
@@ -919,7 +958,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
@@ -931,7 +969,7 @@ var normaliseIndents_default = normaliseIndents;
 * @returns The lyrics string in markdown format.
 */
 function sayHello() {
-	return normaliseIndents_default`
+	return normaliseIndents`
     # Commit To You
 
     ### Verse 1
@@ -1034,7 +1072,6 @@ function sayHello() {
     I'll commit to you!
     `;
 }
-var sayHello_default = sayHello;
 
 //#endregion
 //#region src/functions/miscellaneous/stringifyDotenv.ts
@@ -1051,8 +1088,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;
@@ -1071,7 +1108,6 @@ function stringifyDotenv(contents, options) {
 	}
 	return result;
 }
-var stringifyDotenv_default = stringifyDotenv;
 
 //#endregion
 //#region src/functions/miscellaneous/stringListToArray.ts
@@ -1094,7 +1130,6 @@ function stringListToArray(stringList, { separator = ",", trimWhitespace = true
 		return item.trim();
 	}) : arrayList;
 }
-var stringListToArray_default = stringListToArray;
 
 //#endregion
 //#region src/functions/miscellaneous/wait.ts
@@ -1114,7 +1149,6 @@ function wait(seconds) {
 		}, seconds * 1e3);
 	});
 }
-var wait_default = wait;
 
 //#endregion
 //#region src/functions/objectHelpers/getRecordKeys.ts
@@ -1132,7 +1166,6 @@ var wait_default = wait;
 function getRecordKeys(record) {
 	return Object.keys(record);
 }
-var getRecordKeys_default = getRecordKeys;
 
 //#endregion
 //#region src/functions/objectHelpers/omitProperties.ts
@@ -1156,7 +1189,6 @@ function omitProperties(object, keysToOmit) {
 	});
 	return outputObject;
 }
-var omitProperties_default = omitProperties;
 
 //#endregion
 //#region src/functions/objectHelpers/removeUndefinedFromObject.ts
@@ -1172,7 +1204,6 @@ function removeUndefinedFromObject(object) {
 		return value !== void 0;
 	}));
 }
-var removeUndefinedFromObject_default = removeUndefinedFromObject;
 
 //#endregion
 //#region src/functions/parsers/parseBoolean.ts
@@ -1189,10 +1220,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
@@ -1210,7 +1240,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}`;
@@ -1218,7 +1248,6 @@ function _parseZodSchema(parsedResult, data, onError) {
 	}
 	return parsedResult.data;
 }
-var _parseZodSchema_default = _parseZodSchema;
 
 //#endregion
 //#region src/functions/parsers/zod/parseZodSchema.ts
@@ -1241,9 +1270,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
@@ -1269,9 +1297,8 @@ const Env = {
 * @returns The specified environment if allowed.
 */
 function parseEnv(data) {
-	return parseZodSchema_default(zod.z.enum(Env), data, new DataError_default(data, "INVALID_ENV", "The provided environment type must be one of `test | development | production`"));
+	return parseZodSchema(zod.z.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
@@ -1287,23 +1314,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: node_path.default.join(caughtGroups.groups.directory.replaceAll("\\", "/"), caughtGroups.groups.base)
 	};
 }
-var parseFilePath_default = parseFilePath;
 
 //#endregion
 //#region src/functions/parsers/parseFormData.ts
@@ -1327,7 +1353,6 @@ function parseFormData(formData, dataParser) {
 	if (dataParser) return dataParser(object);
 	return object;
 }
-var parseFormData_default = parseFormData;
 
 //#endregion
 //#region src/functions/parsers/parseVersionType.ts
@@ -1353,9 +1378,8 @@ const VersionType = {
 * @returns The given version type if allowed.
 */
 function parseVersionType(data) {
-	return parseZodSchema_default(zod.default.enum(VersionType), data, new DataError_default(data, "INVALID_VERSION_TYPE", "The provided version type must be one of `major | minor | patch`"));
+	return parseZodSchema(zod.default.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
@@ -1376,9 +1400,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
@@ -1407,7 +1430,6 @@ function deepCopy(object) {
 	}
 	return clonedObject;
 }
-var deepCopy_default = deepCopy;
 
 //#endregion
 //#region src/functions/security/encryptWithKey.ts
@@ -1426,10 +1448,9 @@ async function encryptWithKey(publicKey, plaintextValue) {
 		const encryptedValue = libsodium_wrappers.default.crypto_box_seal(plaintextValue, base64Key);
 		return libsodium_wrappers.default.to_base64(encryptedValue, libsodium_wrappers.default.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
@@ -1447,7 +1468,7 @@ var encryptWithKey_default = encryptWithKey;
 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_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.");
@@ -1455,7 +1476,6 @@ function getPublicAndPrivateKey(outputFormat) {
 	}
 	return keys;
 }
-var getPublicAndPrivateKey_default = getPublicAndPrivateKey;
 
 //#endregion
 //#region src/functions/stringHelpers/appendSemicolon.ts
@@ -1476,7 +1496,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
@@ -1516,7 +1535,6 @@ function camelToKebab(string, options = { preserveConsecutiveCapitals: true }) {
 	}
 	return result;
 }
-var camelToKebab_default = camelToKebab;
 
 //#endregion
 //#region src/functions/stringHelpers/kebabToCamel.ts
@@ -1540,7 +1558,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;
@@ -1556,7 +1574,6 @@ function kebabToCamel(string, options) {
 	}
 	return outputString;
 }
-var kebabToCamel_default = kebabToCamel;
 
 //#endregion
 //#region src/functions/stringHelpers/normalizeImportPath.ts
@@ -1594,7 +1611,6 @@ function normalizeImportPath(importPath) {
 * @returns The import path normalised.
 */
 const normaliseImportPath = normalizeImportPath;
-var normalizeImportPath_default = normalizeImportPath;
 
 //#endregion
 //#region src/functions/stringHelpers/truncate.ts
@@ -1611,7 +1627,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
@@ -1630,11 +1645,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
@@ -1653,11 +1667,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
@@ -1671,12 +1684,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
@@ -1695,73 +1707,74 @@ 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
-exports.APIError = APIError_default;
-exports.DataError = DataError_default;
+exports.APIError = APIError;
+exports.DataError = DataError;
 exports.Env = Env;
-exports.FILE_PATH_REGEX = FILE_PATH_REGEX_default;
-exports.NAMESPACE_EXPORT_REGEX = NAMESPACE_EXPORT_REGEX_default;
-exports.VERSION_NUMBER_REGEX = VERSION_NUMBER_REGEX_default;
-exports.VersionNumber = VersionNumber_default;
+exports.FILE_PATH_REGEX = FILE_PATH_REGEX;
+exports.NAMESPACE_EXPORT_REGEX = NAMESPACE_EXPORT_REGEX;
+exports.VERSION_NUMBER_REGEX = VERSION_NUMBER_REGEX;
+exports.VersionNumber = VersionNumber;
 exports.VersionType = VersionType;
-exports.addDaysToDate = addDaysToDate_default;
-exports.appendSemicolon = appendSemicolon_default;
-exports.camelToKebab = camelToKebab_default;
-exports.convertFileToBase64 = convertFileToBase64_default;
-exports.createFormData = createFormData_default;
-exports.createTemplateStringsArray = createTemplateStringsArray_default;
-exports.deepCopy = deepCopy_default;
-exports.deepFreeze = deepFreeze_default;
-exports.determineVersionType = determineVersionType_default;
-exports.encryptWithKey = encryptWithKey_default;
-exports.fillArray = fillArray_default;
-exports.formatDateAndTime = formatDateAndTime_default;
-exports.getIndividualVersionNumbers = getIndividualVersionNumbers_default;
-exports.getInterpolations = getInterpolations_default;
-exports.getPublicAndPrivateKey = getPublicAndPrivateKey_default;
-exports.getRandomNumber = getRandomNumber_default;
-exports.getRecordKeys = getRecordKeys_default;
+exports.addDaysToDate = addDaysToDate;
+exports.appendSemicolon = appendSemicolon;
+exports.camelToKebab = camelToKebab;
+exports.convertFileToBase64 = convertFileToBase64;
+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.getRandomNumber = getRandomNumber;
+exports.getRecordKeys = getRecordKeys;
+exports.getStringsAndInterpolations = getStringsAndInterpolations;
 exports.httpErrorCodeLookup = httpErrorCodeLookup;
-exports.incrementVersion = incrementVersion_default;
-exports.interpolate = interpolate_default;
-exports.interpolateObjects = interpolateObjects_default;
-exports.isAnniversary = isAnniversary_default;
-exports.isLeapYear = isLeapYear_default;
-exports.isMonthlyMultiple = isMonthlyMultiple_default;
-exports.isOrdered = isOrdered_default;
-exports.isSameDate = isSameDate_default;
-exports.kebabToCamel = kebabToCamel_default;
+exports.incrementVersion = incrementVersion;
+exports.interpolate = interpolate;
+exports.interpolateObjects = interpolateObjects;
+exports.isAnniversary = isAnniversary;
+exports.isLeapYear = isLeapYear;
+exports.isMonthlyMultiple = isMonthlyMultiple;
+exports.isOrdered = isOrdered;
+exports.isSameDate = isSameDate;
+exports.isTemplateStringsArray = isTemplateStringsArray;
+exports.kebabToCamel = kebabToCamel;
 exports.normaliseImportPath = normaliseImportPath;
-exports.normaliseIndents = normaliseIndents_default;
-exports.normalizeImportPath = normalizeImportPath_default;
+exports.normaliseIndents = normaliseIndents;
+exports.normalizeImportPath = normalizeImportPath;
 exports.normalizeIndents = normalizeIndents;
-exports.omitProperties = omitProperties_default;
-exports.paralleliseArrays = paralleliseArrays_default;
-exports.parseBoolean = parseBoolean_default;
-exports.parseEnv = parseEnv_default;
-exports.parseFilePath = parseFilePath_default;
-exports.parseFormData = parseFormData_default;
-exports.parseIntStrict = parseIntStrict_default;
-exports.parseVersion = parseVersion_default;
-exports.parseVersionType = parseVersionType_default;
-exports.parseZodSchema = parseZodSchema_default;
-exports.parseZodSchemaAsync = parseZodSchemaAsync_default;
-exports.randomiseArray = randomiseArray_default;
-exports.range = range_default;
-exports.removeDuplicates = removeDuplicates_default;
-exports.removeUndefinedFromObject = removeUndefinedFromObject_default;
-exports.sayHello = sayHello_default;
-exports.stringListToArray = stringListToArray_default;
-exports.stringifyDotenv = stringifyDotenv_default;
-exports.truncate = truncate_default;
-exports.wait = wait_default;
+exports.omitProperties = omitProperties;
+exports.paralleliseArrays = paralleliseArrays;
+exports.parseBoolean = parseBoolean;
+exports.parseEnv = parseEnv;
+exports.parseFilePath = parseFilePath;
+exports.parseFormData = parseFormData;
+exports.parseIntStrict = parseIntStrict;
+exports.parseVersion = parseVersion;
+exports.parseVersionType = parseVersionType;
+exports.parseZodSchema = parseZodSchema;
+exports.parseZodSchemaAsync = parseZodSchemaAsync;
+exports.randomiseArray = randomiseArray;
+exports.range = range;
+exports.removeDuplicates = removeDuplicates;
+exports.removeUndefinedFromObject = removeUndefinedFromObject;
+exports.sayHello = sayHello;
+exports.stringListToArray = stringListToArray;
+exports.stringifyDotenv = stringifyDotenv;
+exports.truncate = truncate;
+exports.wait = wait;