@alextheman/utility 5.6.1 → 5.6.2

package/dist/index.cjs

@@ -1,4 +1,4 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 //#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -7,16 +7,12 @@ var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") {
-		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-			key = keys[i];
-			if (!__hasOwnProp.call(to, key) && key !== except) {
-				__defProp(to, key, {
-					get: ((k) => from[k]).bind(null, key),
-					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-				});
-			}
-		}
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
 	}
 	return to;
 };
@@ -24,31 +20,25 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	value: mod,
 	enumerable: true
 }) : target, mod));
-
 //#endregion
 let zod = require("zod");
 zod = __toESM(zod);
 let libsodium_wrappers = require("libsodium-wrappers");
 libsodium_wrappers = __toESM(libsodium_wrappers);
-
 //#region src/root/constants/FILE_PATH_REGEX.ts
 const FILE_PATH_PATTERN = String.raw`(?<directory>.+)[\/\\](?<base>[^\/\\]+)`;
 const FILE_PATH_REGEX = RegExp(`^${FILE_PATH_PATTERN}$`);
-
 //#endregion
 //#region src/root/constants/ONE_DAY_IN_MILLISECONDS.ts
 const ONE_DAY_IN_MILLISECONDS = 1440 * 60 * 1e3;
-
 //#endregion
 //#region src/root/constants/UUID_REGEX.ts
 const UUID_PATTERN = "[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}";
 const UUID_REGEX = new RegExp(`^${UUID_PATTERN}$`);
-
 //#endregion
 //#region src/root/constants/VERSION_NUMBER_REGEX.ts
 const VERSION_NUMBER_PATTERN = String.raw`^(?:v)?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$`;
 const VERSION_NUMBER_REGEX = RegExp(`^${VERSION_NUMBER_PATTERN}$`);
-
 //#endregion
 //#region src/root/functions/arrayHelpers/fillArray.ts
 /**
@@ -75,7 +65,6 @@ function fillArray(callback, length = 1) {
 	})) return Promise.all(outputArray);
 	return outputArray;
 }
-
 //#endregion
 //#region src/root/functions/arrayHelpers/paralleliseArrays.ts
 /**
@@ -99,7 +88,6 @@ function paralleliseArrays(firstArray, secondArray) {
 	for (let i = 0; i < firstArray.length; i++) outputArray.push([firstArray[i], secondArray[i]]);
 	return outputArray;
 }
-
 //#endregion
 //#region src/root/types/APIError.ts
 const httpErrorCodeLookup = {
@@ -143,7 +131,6 @@ var APIError = class APIError extends Error {
 		return typeof data === "object" && data !== null && typeof data?.status === "number" && typeof data?.message === "string";
 	}
 };
-
 //#endregion
 //#region src/root/types/DataError.ts
 /**
@@ -233,7 +220,6 @@ var DataError = class DataError extends Error {
 		throw new Error("Expected a DataError to be thrown but none was thrown");
 	}
 };
-
 //#endregion
 //#region src/root/types/VersionNumber.ts
 /**
@@ -258,7 +244,7 @@ var VersionNumber = class VersionNumber {
 			this.minor = input.minor;
 			this.patch = input.patch;
 		} else if (typeof input === "string") {
-			if (!RegExp(VERSION_NUMBER_REGEX).test(input)) throw new DataError({ input }, "INVALID_VERSION", `"${input}" is not a valid version number. Version numbers must be of the format "X.Y.Z" or "vX.Y.Z", where X, Y, and Z are non-negative integers.`);
+			if (!VERSION_NUMBER_REGEX.test(input)) throw new DataError({ input }, "INVALID_VERSION", `"${input}" is not a valid version number. Version numbers must be of the format "X.Y.Z" or "vX.Y.Z", where X, Y, and Z are non-negative integers.`);
 			const [major, minor, patch] = VersionNumber.formatString(input, { omitPrefix: true }).split(".").map((number) => {
 				return parseIntStrict(number);
 			});
@@ -275,7 +261,10 @@ var VersionNumber = class VersionNumber {
 			this.major = major;
 			this.minor = minor;
 			this.patch = patch;
-		}
+		} else throw new DataError({ input }, "INVALID_INPUT", normaliseIndents`
+        The provided input can not be parsed into a valid version number.
+        Expected either a string of format X.Y.Z or vX.Y.Z, a tuple of three numbers, or another \`VersionNumber\` instance.
+      `);
 	}
 	/**
 	* Gets the current version type of the current instance of `VersionNumber`.
@@ -398,7 +387,6 @@ const zodVersionNumber = zod.default.union([
 ]).transform((rawVersionNumber) => {
 	return new VersionNumber(rawVersionNumber);
 });
-
 //#endregion
 //#region src/root/functions/parsers/parseIntStrict.ts
 /**
@@ -420,7 +408,7 @@ function parseIntStrict(string, radix) {
 		string,
 		radix
 	} : { string }, "INTEGER_PARSING_ERROR", `Only numeric values${radix && radix > 10 && radix <= 36 ? ` or character${radix !== 11 ? "s" : ""} A${radix !== 11 ? `-${maxAllowedAlphabeticalCharacter?.toUpperCase()} ` : " "}` : " "}are allowed.`);
-	if (radix && radix < 10 && [...trimmedString].some((character) => {
+	if (radix && radix < 10 && [...trimmedString.replace(/^[+-]/, "")].some((character) => {
 		return parseInt(character) >= radix;
 	})) throw new DataError({
 		string,
@@ -430,7 +418,6 @@ function parseIntStrict(string, radix) {
 	if (isNaN(parseIntResult)) throw new DataError({ string }, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
 	return parseIntResult;
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/getRandomNumber.ts
 /**
@@ -448,7 +435,6 @@ function getRandomNumber(lowerBound, upperBound) {
 	const parsedUpperBound = parseIntStrict(`${upperBound}`);
 	return Math.floor(Math.random() * (parsedUpperBound - parsedLowerBound + 1) + parsedLowerBound);
 }
-
 //#endregion
 //#region src/root/functions/arrayHelpers/randomiseArray.ts
 /**
@@ -471,7 +457,6 @@ function randomiseArray(array) {
 	} while (mutableArray.length > 0);
 	return outputArray;
 }
-
 //#endregion
 //#region src/root/functions/arrayHelpers/range.ts
 /**
@@ -511,7 +496,6 @@ function range(start, stop, step = 1) {
 	}
 	return numbers;
 }
-
 //#endregion
 //#region src/root/functions/arrayHelpers/removeDuplicates.ts
 /**
@@ -530,7 +514,6 @@ function removeDuplicates(array) {
 	for (const item of array) if (!outputArray.includes(item)) outputArray.push(item);
 	return outputArray;
 }
-
 //#endregion
 //#region src/root/functions/date/addDaysToDate.ts
 /**
@@ -548,7 +531,6 @@ function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement =
 	newDate.setDate(newDate.getDate() + dayIncrement);
 	return newDate;
 }
-
 //#endregion
 //#region src/root/functions/date/calculateMonthlyDifference.ts
 /**
@@ -563,7 +545,6 @@ function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement =
 function calculateMonthlyDifference(firstDate, secondDate) {
 	return firstDate.getMonth() - secondDate.getMonth();
 }
-
 //#endregion
 //#region src/root/functions/date/isSameDate.ts
 /**
@@ -579,7 +560,6 @@ function calculateMonthlyDifference(firstDate, secondDate) {
 function isSameDate(firstDate, secondDate) {
 	return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth() && firstDate.getFullYear() === secondDate.getFullYear();
 }
-
 //#endregion
 //#region src/root/functions/date/formatDateAndTime.ts
 /**
@@ -603,7 +583,6 @@ function formatDateAndTime(inputDate) {
 	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}`;
 }
-
 //#endregion
 //#region src/root/functions/date/isLeapYear.ts
 /**
@@ -621,7 +600,6 @@ function isLeapYear(year) {
 	const parsedYear = parseIntStrict(`${year}`);
 	return parsedYear % 4 === 0 && parsedYear % 100 !== 0 || parsedYear % 400 === 0;
 }
-
 //#endregion
 //#region src/root/functions/date/isAnniversary.ts
 function checkLeapYear(firstDate, secondDate) {
@@ -642,7 +620,6 @@ function isAnniversary(firstDate, secondDate) {
 	if (checkLeapYear(firstDate, secondDate) || checkLeapYear(secondDate, firstDate)) return true;
 	return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth();
 }
-
 //#endregion
 //#region src/root/functions/date/isMonthlyMultiple.ts
 function endOfMonthChecksButNotFebruary(firstDate, secondDate) {
@@ -691,7 +668,6 @@ function isMonthlyMultiple(firstDate, secondDate) {
 	if (leapYearFebruaryChecks(firstDate, secondDate) || leapYearFebruaryChecks(secondDate, firstDate)) return true;
 	return firstDate.getDate() === secondDate.getDate();
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/convertFileToBase64.ts
 /**
@@ -721,7 +697,6 @@ function convertFileToBase64(file) {
 		};
 	});
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/createFormData.ts
 function getNullableResolutionStrategy(key, strategy) {
@@ -793,7 +768,6 @@ function createFormData(data, options = {
 	} else formData.append(String(key), String(value));
 	return formData;
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/isOrdered.ts
 /**
@@ -811,7 +785,6 @@ function isOrdered(array) {
 	for (const index in newArray) if (newArray[index] !== array[index]) return false;
 	return true;
 }
-
 //#endregion
 //#region src/root/functions/recursive/deepFreeze.ts
 /**
@@ -835,7 +808,6 @@ function deepFreeze(object) {
 	}
 	return Object.freeze(object);
 }
-
 //#endregion
 //#region src/root/functions/taggedTemplate/createTemplateStringsArray.ts
 /**
@@ -850,7 +822,6 @@ function deepFreeze(object) {
 function createTemplateStringsArray(strings) {
 	return deepFreeze(Object.assign([...strings], { raw: [...strings] }));
 }
-
 //#endregion
 //#region src/root/functions/taggedTemplate/getStringsAndInterpolations.ts
 /**
@@ -891,7 +862,6 @@ function getStringsAndInterpolations(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/root/functions/taggedTemplate/interpolate.ts
 /**
@@ -919,7 +889,6 @@ function interpolate(strings, ...interpolations) {
 	for (const [string, interpolation = ""] of paralleliseArrays(strings, interpolations)) result += string + interpolation;
 	return result;
 }
-
 //#endregion
 //#region src/root/functions/taggedTemplate/interpolateObjects.ts
 /**
@@ -948,7 +917,6 @@ function interpolateObjects(strings, ...interpolations) {
 	}
 	return result;
 }
-
 //#endregion
 //#region src/root/functions/taggedTemplate/isTemplateStringsArray.ts
 /**
@@ -963,7 +931,6 @@ function interpolateObjects(strings, ...interpolations) {
 function isTemplateStringsArray(input) {
 	return typeof input === "object" && input !== null && "raw" in input;
 }
-
 //#endregion
 //#region src/root/functions/taggedTemplate/normaliseIndents.ts
 function calculateTabSize(line, whitespaceLength) {
@@ -1052,7 +1019,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;
-
 //#endregion
 //#region src/root/functions/miscellaneous/sayHello.ts
 /**
@@ -1166,7 +1132,6 @@ function sayHello() {
     I'll commit to you!
     `;
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/stringifyDotenv.ts
 /**
@@ -1202,7 +1167,6 @@ function stringifyDotenv(contents, options) {
 	}
 	return result;
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/stringListToArray.ts
 /**
@@ -1224,7 +1188,6 @@ function stringListToArray(stringList, { separator = ",", trimWhitespace = true
 		return item.trim();
 	}) : arrayList;
 }
-
 //#endregion
 //#region src/root/functions/miscellaneous/wait.ts
 /**
@@ -1243,7 +1206,6 @@ function wait(seconds) {
 		}, seconds * 1e3);
 	});
 }
-
 //#endregion
 //#region src/root/functions/objectHelpers/getRecordKeys.ts
 /**
@@ -1260,7 +1222,6 @@ function wait(seconds) {
 function getRecordKeys(record) {
 	return Object.keys(record);
 }
-
 //#endregion
 //#region src/root/functions/objectHelpers/omitProperties.ts
 /**
@@ -1283,7 +1244,6 @@ function omitProperties(object, keysToOmit) {
 	});
 	return outputObject;
 }
-
 //#endregion
 //#region src/root/functions/objectHelpers/removeUndefinedFromObject.ts
 /**
@@ -1298,7 +1258,6 @@ function removeUndefinedFromObject(object) {
 		return value !== void 0;
 	}));
 }
-
 //#endregion
 //#region src/root/functions/parsers/parseBoolean.ts
 /**
@@ -1317,7 +1276,6 @@ function parseBoolean(inputString) {
 	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/root/functions/parsers/zod/_parseZodSchema.ts
 function _parseZodSchema(parsedResult, input, onError) {
@@ -1342,7 +1300,6 @@ function _parseZodSchema(parsedResult, input, onError) {
 	}
 	return parsedResult.data;
 }
-
 //#endregion
 //#region src/root/functions/parsers/zod/parseZodSchema.ts
 /**
@@ -1366,7 +1323,6 @@ function _parseZodSchema(parsedResult, input, onError) {
 function parseZodSchema(schema, input, onError) {
 	return _parseZodSchema(schema.safeParse(input), input, onError);
 }
-
 //#endregion
 //#region src/root/functions/parsers/parseEnv.ts
 /**
@@ -1393,7 +1349,6 @@ const Env = {
 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/root/functions/parsers/parseFormData.ts
 /**
@@ -1416,7 +1371,6 @@ function parseFormData(formData, dataParser) {
 	if (dataParser) return dataParser(object);
 	return object;
 }
-
 //#endregion
 //#region src/root/functions/parsers/parseUUID.ts
 /**
@@ -1435,7 +1389,6 @@ function parseUUID(input) {
 	if (!UUID_REGEX.test(input)) throw new DataError({ input }, "INVALID_UUID", "The provided input does not match the expected shape for a UUID.");
 	return input;
 }
-
 //#endregion
 //#region src/root/functions/parsers/parseVersionType.ts
 /**
@@ -1462,7 +1415,6 @@ const VersionType = {
 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/root/functions/parsers/zod/parseZodSchemaAsync.ts
 /**
@@ -1484,7 +1436,6 @@ function parseVersionType(input) {
 async function parseZodSchemaAsync(schema, input, onError) {
 	return _parseZodSchema(await schema.safeParseAsync(input), input, onError);
 }
-
 //#endregion
 //#region src/root/functions/recursive/deepCopy.ts
 function callDeepCopy(input) {
@@ -1512,7 +1463,6 @@ function deepCopy(object) {
 	}
 	return clonedObject;
 }
-
 //#endregion
 //#region src/root/functions/security/encryptWithKey.ts
 /**
@@ -1533,7 +1483,6 @@ async function encryptWithKey(publicKey, plaintextValue) {
 		throw new DataError({ publicKey }, "ENCRYPTION_FAILED", "Encryption failed. Please double-check that the given key is a valid base 64 string.");
 	}
 }
-
 //#endregion
 //#region src/root/functions/stringHelpers/appendSemicolon.ts
 /**
@@ -1553,7 +1502,6 @@ function appendSemicolon(stringToAppendTo) {
 	if (stringWithNoTrailingWhitespace === "") return "";
 	return stringWithNoTrailingWhitespace[stringWithNoTrailingWhitespace.length - 1] === ";" ? stringWithNoTrailingWhitespace : `${stringWithNoTrailingWhitespace};`;
 }
-
 //#endregion
 //#region src/root/functions/stringHelpers/camelToKebab.ts
 /**
@@ -1592,7 +1540,6 @@ function camelToKebab(string, options = { preserveConsecutiveCapitals: true }) {
 	}
 	return result;
 }
-
 //#endregion
 //#region src/root/functions/stringHelpers/kebabToCamel.ts
 /**
@@ -1632,7 +1579,6 @@ function kebabToCamel(input, options) {
 	}
 	return outputString;
 }
-
 //#endregion
 //#region src/root/functions/stringHelpers/truncate.ts
 /**
@@ -1648,7 +1594,6 @@ function kebabToCamel(input, options) {
 function truncate(stringToTruncate, maxLength = 5) {
 	return stringToTruncate.length > maxLength ? `${stringToTruncate.slice(0, maxLength)}...` : stringToTruncate;
 }
-
 //#endregion
 exports.APIError = APIError;
 exports.DataError = DataError;
@@ -1708,4 +1653,4 @@ exports.stringListToArray = stringListToArray;
 exports.stringifyDotenv = stringifyDotenv;
 exports.truncate = truncate;
 exports.wait = wait;
-exports.zodVersionNumber = zodVersionNumber;
+exports.zodVersionNumber = zodVersionNumber;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import z, { ZodError, ZodType, z as z$1 } from "zod";
+import z$1, { ZodError, ZodType, z } from "zod";
 import { DotenvParseOutput } from "dotenv";
 
 //#region src/root/constants/FILE_PATH_REGEX.d.ts
@@ -30,7 +30,7 @@ declare const VERSION_NUMBER_REGEX: RegExp;
  *
  * @returns A Promise resolving to an array of the callback results.
  */
-declare function fillArray<ItemType>(callback: (index: number) => Promise<ItemType>, length?: number): Promise<ItemType[]>;
+declare function fillArray<ItemType>(callback: (index: number) => Promise<ItemType>, length?: number): Promise<Array<ItemType>>;
 /**
  * Creates a new array where each element is the result of the provided synchronous callback.
  *
@@ -44,7 +44,7 @@ declare function fillArray<ItemType>(callback: (index: number) => Promise<ItemTy
  *
  * @returns An array of the callback results.
  */
-declare function fillArray<ItemType>(callback: (index: number) => ItemType, length?: number): ItemType[];
+declare function fillArray<ItemType>(callback: (index: number) => ItemType, length?: number): Array<ItemType>;
 //#endregion
 //#region src/root/functions/arrayHelpers/paralleliseArrays.d.ts
 type ParallelTuple<A, B> = [A, B | undefined];
@@ -64,7 +64,7 @@ type ParallelTuple<A, B> = [A, B | undefined];
  *
  * @returns An array of `[firstItem, secondItem]` tuples for each index in `firstArray`.
  */
-declare function paralleliseArrays<FirstArrayItem, SecondArrayItem>(firstArray: readonly FirstArrayItem[], secondArray: readonly SecondArrayItem[]): ParallelTuple<FirstArrayItem, SecondArrayItem>[];
+declare function paralleliseArrays<FirstArrayItem, SecondArrayItem>(firstArray: ReadonlyArray<FirstArrayItem>, secondArray: ReadonlyArray<SecondArrayItem>): Array<ParallelTuple<FirstArrayItem, SecondArrayItem>>;
 //#endregion
 //#region src/root/functions/arrayHelpers/randomiseArray.d.ts
 /**
@@ -78,7 +78,7 @@ declare function paralleliseArrays<FirstArrayItem, SecondArrayItem>(firstArray:
  *
  * @returns A new array with the items randomised.
  */
-declare function randomiseArray<ItemType>(array: ItemType[]): ItemType[];
+declare function randomiseArray<ItemType>(array: Array<ItemType>): Array<ItemType>;
 //#endregion
 //#region src/root/functions/arrayHelpers/range.d.ts
 /**
@@ -98,7 +98,7 @@ declare function randomiseArray<ItemType>(array: ItemType[]): ItemType[];
  *
  * @returns An array of numbers satisfying the range provided.
  */
-declare function range(start: number, stop: number, step?: number): number[];
+declare function range(start: number, stop: number, step?: number): Array<number>;
 //#endregion
 //#region src/root/functions/arrayHelpers/removeDuplicates.d.ts
 /**
@@ -112,7 +112,7 @@ declare function range(start: number, stop: number, step?: number): number[];
  *
  * @returns A new array with a different reference in memory, with the duplicates removed.
  */
-declare function removeDuplicates<ItemType>(array: ItemType[] | readonly ItemType[]): ItemType[];
+declare function removeDuplicates<ItemType>(array: Array<ItemType> | ReadonlyArray<ItemType>): Array<ItemType>;
 //#endregion
 //#region src/root/functions/date/addDaysToDate.d.ts
 /**
@@ -409,7 +409,7 @@ declare class VersionNumber {
    */
   toString(): string;
 }
-declare const zodVersionNumber: z.ZodType<VersionNumber>;
+declare const zodVersionNumber: z$1.ZodType<VersionNumber>;
 //#endregion
 //#region src/root/types/ArrayElement.d.ts
 /**
@@ -419,7 +419,7 @@ declare const zodVersionNumber: z.ZodType<VersionNumber>;
  *
  * @template ArrayType - The type of the array itself.
  */
-type ArrayElement<ArrayType extends readonly unknown[]> = ArrayType extends readonly (infer ElementType)[] ? ElementType : never;
+type ArrayElement<ArrayType extends ReadonlyArray<unknown>> = ArrayType extends ReadonlyArray<infer ElementType> ? ElementType : never;
 //#endregion
 //#region src/root/types/CallReturnType.d.ts
 type CallReturnType<Function, Arguments> = Function extends ((arg: Arguments) => infer Return) ? Return : never;
@@ -578,7 +578,7 @@ declare function getRandomNumber(lowerBound: number, upperBound: number): number
  *
  * @returns `true` if the array is sorted in ascending order, and `false` otherwise.
  */
-declare function isOrdered(array: readonly number[]): boolean;
+declare function isOrdered(array: ReadonlyArray<number>): boolean;
 //#endregion
 //#region src/root/functions/miscellaneous/sayHello.d.ts
 /**
@@ -633,7 +633,7 @@ interface StringListToArrayOptions {
 declare function stringListToArray(stringList: string, {
   separator,
   trimWhitespace
-}?: StringListToArrayOptions): string[];
+}?: StringListToArrayOptions): Array<string>;
 //#endregion
 //#region src/root/functions/miscellaneous/wait.d.ts
 /**
@@ -659,7 +659,7 @@ declare function wait(seconds: number): Promise<void>;
  *
  * @returns An array with all the keys of the input object in string form, but properly typed as `keyof InputRecordType`.
  */
-declare function getRecordKeys<InputRecordType extends Record<RecordKey, unknown>>(record: InputRecordType & object): (keyof InputRecordType)[];
+declare function getRecordKeys<InputRecordType extends Record<RecordKey, unknown>>(record: InputRecordType & object): Array<keyof InputRecordType>;
 //#endregion
 //#region src/root/functions/objectHelpers/omitProperties.d.ts
 /**
@@ -675,7 +675,7 @@ declare function getRecordKeys<InputRecordType extends Record<RecordKey, unknown
  *
  * @returns An object with a new reference in memory, with the properties omitted.
  */
-declare function omitProperties<ObjectType extends Record<string, unknown> | Readonly<Record<string, unknown>>, KeysToOmit extends keyof ObjectType>(object: ObjectType, keysToOmit: KeysToOmit | readonly KeysToOmit[]): Omit<ObjectType, KeysToOmit>;
+declare function omitProperties<ObjectType extends Record<string, unknown> | Readonly<Record<string, unknown>>, KeysToOmit extends keyof ObjectType>(object: ObjectType, keysToOmit: KeysToOmit | ReadonlyArray<KeysToOmit>): Omit<ObjectType, KeysToOmit>;
 //#endregion
 //#region src/root/functions/objectHelpers/removeUndefinedFromObject.d.ts
 type RemoveUndefined<RecordType extends Record<RecordKey, unknown>> = { [Key in keyof RecordType]: Exclude<RecordType[Key], undefined> };
@@ -821,7 +821,7 @@ declare function parseVersionType(input: unknown): VersionType;
  *
  * @returns The parsed data from the Zod schema.
  */
-declare function parseZodSchema<SchemaType extends ZodType, ErrorType extends Error = DataError>(schema: SchemaType, input: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): z$1.infer<SchemaType>;
+declare function parseZodSchema<SchemaType extends ZodType, ErrorType extends Error = DataError>(schema: SchemaType, input: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): z.infer<SchemaType>;
 //#endregion
 //#region src/root/functions/parsers/zod/parseZodSchemaAsync.d.ts
 /**
@@ -840,7 +840,7 @@ declare function parseZodSchema<SchemaType extends ZodType, ErrorType extends Er
  *
  * @returns The parsed data from the Zod schema.
  */
-declare function parseZodSchemaAsync<SchemaType extends ZodType, ErrorType extends Error = DataError>(schema: SchemaType, input: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): Promise<z$1.infer<SchemaType>>;
+declare function parseZodSchemaAsync<SchemaType extends ZodType, ErrorType extends Error = DataError>(schema: SchemaType, input: unknown, onError?: ErrorType | ((zodError: ZodError) => ErrorType | void)): Promise<z.infer<SchemaType>>;
 //#endregion
 //#region src/root/functions/recursive/deepCopy.d.ts
 /**
@@ -965,7 +965,7 @@ declare function truncate(stringToTruncate: string, maxLength?: number): string;
  *
  * @returns A template strings array that can be passed as the first argument of any tagged template function.
  */
-declare function createTemplateStringsArray(strings: readonly string[]): TemplateStringsArray;
+declare function createTemplateStringsArray(strings: ReadonlyArray<string>): TemplateStringsArray;
 //#endregion
 //#region src/root/functions/taggedTemplate/getStringsAndInterpolations.d.ts
 /**
@@ -997,7 +997,7 @@ declare function createTemplateStringsArray(strings: readonly string[]): Templat
  * interpolate(...getStringsAndInterpolations`The package ${packageName} uses the ${packageManager} package manager.`);
  * ```
  */
-declare function getStringsAndInterpolations<const InterpolationsType extends readonly unknown[]>(strings: TemplateStringsArray, ...interpolations: InterpolationsType): [TemplateStringsArray, ...InterpolationsType];
+declare function getStringsAndInterpolations<const InterpolationsType extends ReadonlyArray<unknown>>(strings: TemplateStringsArray, ...interpolations: InterpolationsType): [TemplateStringsArray, ...InterpolationsType];
 //#endregion
 //#region src/root/functions/taggedTemplate/interpolate.d.ts
 /**
@@ -1020,7 +1020,7 @@ declare function getStringsAndInterpolations<const InterpolationsType extends re
  *
  * @returns A new string with the strings and interpolations from the template applied.
  */
-declare function interpolate<const InterpolationsType extends readonly unknown[]>(strings: TemplateStringsArray, ...interpolations: InterpolationsType): string;
+declare function interpolate<const InterpolationsType extends ReadonlyArray<unknown>>(strings: TemplateStringsArray, ...interpolations: InterpolationsType): string;
 //#endregion
 //#region src/root/functions/taggedTemplate/interpolateObjects.d.ts
 /**
@@ -1041,7 +1041,7 @@ declare function interpolate<const InterpolationsType extends readonly unknown[]
  *
  * @returns A new string with the strings and interpolations from the template applied, with objects stringified.
  */
-declare function interpolateObjects<const InterpolationsType extends readonly unknown[]>(strings: TemplateStringsArray, ...interpolations: InterpolationsType): string;
+declare function interpolateObjects<const InterpolationsType extends ReadonlyArray<unknown>>(strings: TemplateStringsArray, ...interpolations: InterpolationsType): string;
 //#endregion
 //#region src/root/functions/taggedTemplate/isTemplateStringsArray.d.ts
 /**
@@ -1066,7 +1066,7 @@ interface NormaliseIndentsOptions {
   preserveTabs?: boolean;
 }
 type NormalizeIndentsOptions = NormaliseIndentsOptions;
-type NormaliseIndentsFunction = (strings: TemplateStringsArray, ...interpolations: unknown[]) => string;
+type NormaliseIndentsFunction = (strings: TemplateStringsArray, ...interpolations: Array<unknown>) => string;
 type NormalizeIndentsFunction = NormaliseIndentsFunction;
 /**
  * Provides a new function that removes any extraneous indents from a multi-line template string, with the given options applied.
@@ -1096,7 +1096,7 @@ declare function normaliseIndents(options: NormaliseIndentsOptions): NormaliseIn
  *
  * @returns A new string with the strings and interpolations from the template applied, and extraneous indents removed.
  */
-declare function normaliseIndents(strings: TemplateStringsArray, ...interpolations: unknown[]): string;
+declare function normaliseIndents(strings: TemplateStringsArray, ...interpolations: Array<unknown>): string;
 /**
  * Applies any options if provided, then removes any extraneous indents from a multi-line template string.
  *