@alextheman/utility 5.23.1 → 5.24.0

package/dist/index.cjs

@@ -24,19 +24,19 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 let zod = require("zod");
 zod = __toESM(zod, 1);
 //#region src/root/constants/FILE_PATH_REGEX.ts
-const FILE_PATH_PATTERN = String.raw`(?<directory>.+)[\/\\](?<base>[^\/\\]+)`;
-const FILE_PATH_REGEX = RegExp(`^${FILE_PATH_PATTERN}$`);
+const FILE_PATH_REGEX_PATTERN = String.raw`(?<directory>.+)[\/\\](?<base>[^\/\\]+)`;
+const FILE_PATH_REGEX = RegExp(`^${FILE_PATH_REGEX_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}$`);
+const UUID_REGEX_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_REGEX_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}$`);
+const VERSION_NUMBER_REGEX_PATTERN = String.raw`(?:v)?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)`;
+const VERSION_NUMBER_REGEX = RegExp(`^${VERSION_NUMBER_REGEX_PATTERN}$`);
 //#endregion
 //#region src/root/deprecated/APIError.ts
 const httpErrorCodeLookup = {
@@ -1942,6 +1942,8 @@ function normaliseIndents(first, ...args) {
 *     and another new line`.
 * ```
 *
+* @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.
 *
@@ -2040,17 +2042,32 @@ var DataError = class DataError extends Error {
 	}
 };
 //#endregion
+//#region src/root/deprecated/FILE_PATH_PATTERN.ts
+/** @deprecated This has been renamed to `FILE_PATH_REGEX_PATTERN`. */
+const FILE_PATH_PATTERN = FILE_PATH_REGEX_PATTERN;
+//#endregion
+//#region src/root/deprecated/UUID_PATTERN.ts
+/** @deprecated This has been renamed to `UUID_REGEX_PATTERN`. */
+const UUID_PATTERN = UUID_REGEX_PATTERN;
+//#endregion
+//#region src/root/deprecated/VERSION_NUMBER_PATTERN.ts
+/** @deprecated This has been renamed to `VERSION_NUMBER_REGEX_PATTERN`. */
+const VERSION_NUMBER_PATTERN = String.raw`^(?:v)?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$`;
+//#endregion
 exports.APIError = APIError;
 exports.DataError = DataError;
 exports.Env = Env;
 exports.FILE_PATH_PATTERN = FILE_PATH_PATTERN;
 exports.FILE_PATH_REGEX = FILE_PATH_REGEX;
+exports.FILE_PATH_REGEX_PATTERN = FILE_PATH_REGEX_PATTERN;
 exports.ONE_DAY_IN_MILLISECONDS = ONE_DAY_IN_MILLISECONDS;
 exports.SortDirection = SortDirection;
 exports.UUID_PATTERN = UUID_PATTERN;
 exports.UUID_REGEX = UUID_REGEX;
+exports.UUID_REGEX_PATTERN = UUID_REGEX_PATTERN;
 exports.VERSION_NUMBER_PATTERN = VERSION_NUMBER_PATTERN;
 exports.VERSION_NUMBER_REGEX = VERSION_NUMBER_REGEX;
+exports.VERSION_NUMBER_REGEX_PATTERN = VERSION_NUMBER_REGEX_PATTERN;
 exports.VersionNumber = VersionNumber;
 exports.VersionType = VersionType;
 exports.addDaysToDate = addDaysToDate;

package/dist/index.d.cts

@@ -2,18 +2,18 @@ import z, { ZodCoercedDate, ZodCoercedNumber, ZodError, ZodType, z as z$1 } from
 import { DotenvParseOutput } from "dotenv";
 
 //#region src/root/constants/FILE_PATH_REGEX.d.ts
-declare const FILE_PATH_PATTERN: string;
+declare const FILE_PATH_REGEX_PATTERN: string;
 declare const FILE_PATH_REGEX: RegExp;
 //#endregion
 //#region src/root/constants/ONE_DAY_IN_MILLISECONDS.d.ts
 declare const ONE_DAY_IN_MILLISECONDS: number;
 //#endregion
 //#region src/root/constants/UUID_REGEX.d.ts
-declare 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}";
+declare const UUID_REGEX_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}";
 declare const UUID_REGEX: RegExp;
 //#endregion
 //#region src/root/constants/VERSION_NUMBER_REGEX.d.ts
-declare const VERSION_NUMBER_PATTERN: string;
+declare const VERSION_NUMBER_REGEX_PATTERN: string;
 declare const VERSION_NUMBER_REGEX: RegExp;
 //#endregion
 //#region src/root/deprecated/APIError.d.ts
@@ -102,6 +102,18 @@ declare class DataError<DataType extends Record<PropertyKey, unknown> = Record<P
   static expectErrorAsync(errorFunction: () => Promise<unknown>, options?: ExpectErrorOptions$1): Promise<DataError>;
 }
 //#endregion
+//#region src/root/deprecated/FILE_PATH_PATTERN.d.ts
+/** @deprecated This has been renamed to `FILE_PATH_REGEX_PATTERN`. */
+declare const FILE_PATH_PATTERN: string;
+//#endregion
+//#region src/root/deprecated/UUID_PATTERN.d.ts
+/** @deprecated This has been renamed to `UUID_REGEX_PATTERN`. */
+declare 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}";
+//#endregion
+//#region src/root/deprecated/VERSION_NUMBER_PATTERN.d.ts
+/** @deprecated This has been renamed to `VERSION_NUMBER_REGEX_PATTERN`. */
+declare const VERSION_NUMBER_PATTERN: string;
+//#endregion
 //#region src/root/deprecated/RecordKey.d.ts
 /**
  * Represents the native Record's possible key type.
@@ -1154,6 +1166,8 @@ declare function normaliseIndents(options: NormaliseIndentsOptions): NormaliseIn
  *     and another new line`;
  * ```
  *
+ * @category Tagged Template
+ *
  * @template InterpolationsType - The type of the interpolations.
  *
  * @param strings - The strings from the template to process.
@@ -1181,6 +1195,8 @@ declare function normaliseIndents(strings: TemplateStringsArray, ...interpolatio
  *     and another new line`.
  * ```
  *
+ * @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.
  *
@@ -1483,4 +1499,4 @@ interface ZodParsingErrorData {
   issues: Array<z.core.$ZodIssue>;
 }
 //#endregion
-export { APIError, type ArrayElement, type CallReturnType, type CamelToKebabOptions, type CreateEnumType, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, DataError, type DisallowUndefined, Env, FILE_PATH_PATTERN, FILE_PATH_REGEX, type FormDataArrayResolutionStrategy, type FormDataNullableResolutionStrategy, type HTTPErrorCode, type IgnoreCase, type IsTypeArgumentString, type KebabToCamelOptions, type NonNull, type NonUndefined, type NormaliseIndentsFunction, type NormaliseIndentsOptions, type NormalizeIndentsFunction, type NormalizeIndentsOptions, type NullableOnCondition, ONE_DAY_IN_MILLISECONDS, type OptionalOnCondition, type ParallelTuple, type RecordKey, type RemoveUndefined, SortDirection, type StringListToArrayOptions, type ToTitleCaseOptions, UUID_PATTERN, UUID_REGEX, VERSION_NUMBER_PATTERN, VERSION_NUMBER_REGEX, VersionNumber, type FormatOptionsBase as VersionNumberToStringOptions, VersionType, type ZodParsingErrorData, addDaysToDate, appendSemicolon, assertNotNull, assertNotNullable, assertNotUndefined, az, calculateMonthlyDifference, camelToKebab, containsKeys, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, escapeHTML, escapeRegexPattern, fillArray, formatDateAndTime, getRandomNumber, getRecordKeys, getStringsAndInterpolations, httpErrorCodeLookup, identity, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isNonNullableObject, isOrdered, isSameDate, isTemplateStringsArray, kebabToCamel, normaliseIndents, normalizeIndents, objectContainsKeys, omitProperties, paralleliseArrays, parseBoolean, parseEnv, parseFormData, parseIntStrict, parseUUID, parseVersionType, parseZodSchema, parseZodSchemaAsync, pickProperties, randomiseArray, range, removeDuplicates, removeUndefinedFromObject, sayHello, sortBy, stringListToArray, stringifyDotenv, toTitleCase, truncate, wait, zodVersionNumber };
+export { APIError, type ArrayElement, type CallReturnType, type CamelToKebabOptions, type CreateEnumType, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, DataError, type DisallowUndefined, Env, FILE_PATH_PATTERN, FILE_PATH_REGEX, FILE_PATH_REGEX_PATTERN, type FormDataArrayResolutionStrategy, type FormDataNullableResolutionStrategy, type HTTPErrorCode, type IgnoreCase, type IsTypeArgumentString, type KebabToCamelOptions, type NonNull, type NonUndefined, type NormaliseIndentsFunction, type NormaliseIndentsOptions, type NormalizeIndentsFunction, type NormalizeIndentsOptions, type NullableOnCondition, ONE_DAY_IN_MILLISECONDS, type OptionalOnCondition, type ParallelTuple, type RecordKey, type RemoveUndefined, SortDirection, type StringListToArrayOptions, type ToTitleCaseOptions, UUID_PATTERN, UUID_REGEX, UUID_REGEX_PATTERN, VERSION_NUMBER_PATTERN, VERSION_NUMBER_REGEX, VERSION_NUMBER_REGEX_PATTERN, VersionNumber, type FormatOptionsBase as VersionNumberToStringOptions, VersionType, type ZodParsingErrorData, addDaysToDate, appendSemicolon, assertNotNull, assertNotNullable, assertNotUndefined, az, calculateMonthlyDifference, camelToKebab, containsKeys, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, escapeHTML, escapeRegexPattern, fillArray, formatDateAndTime, getRandomNumber, getRecordKeys, getStringsAndInterpolations, httpErrorCodeLookup, identity, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isNonNullableObject, isOrdered, isSameDate, isTemplateStringsArray, kebabToCamel, normaliseIndents, normalizeIndents, objectContainsKeys, omitProperties, paralleliseArrays, parseBoolean, parseEnv, parseFormData, parseIntStrict, parseUUID, parseVersionType, parseZodSchema, parseZodSchemaAsync, pickProperties, randomiseArray, range, removeDuplicates, removeUndefinedFromObject, sayHello, sortBy, stringListToArray, stringifyDotenv, toTitleCase, truncate, wait, zodVersionNumber };

package/dist/index.d.ts

@@ -2,18 +2,18 @@ import z, { ZodCoercedDate, ZodCoercedNumber, ZodError, ZodType, z as z$1 } from
 import { DotenvParseOutput } from "dotenv";
 
 //#region src/root/constants/FILE_PATH_REGEX.d.ts
-declare const FILE_PATH_PATTERN: string;
+declare const FILE_PATH_REGEX_PATTERN: string;
 declare const FILE_PATH_REGEX: RegExp;
 //#endregion
 //#region src/root/constants/ONE_DAY_IN_MILLISECONDS.d.ts
 declare const ONE_DAY_IN_MILLISECONDS: number;
 //#endregion
 //#region src/root/constants/UUID_REGEX.d.ts
-declare 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}";
+declare const UUID_REGEX_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}";
 declare const UUID_REGEX: RegExp;
 //#endregion
 //#region src/root/constants/VERSION_NUMBER_REGEX.d.ts
-declare const VERSION_NUMBER_PATTERN: string;
+declare const VERSION_NUMBER_REGEX_PATTERN: string;
 declare const VERSION_NUMBER_REGEX: RegExp;
 //#endregion
 //#region src/root/deprecated/APIError.d.ts
@@ -102,6 +102,18 @@ declare class DataError<DataType extends Record<PropertyKey, unknown> = Record<P
   static expectErrorAsync(errorFunction: () => Promise<unknown>, options?: ExpectErrorOptions$1): Promise<DataError>;
 }
 //#endregion
+//#region src/root/deprecated/FILE_PATH_PATTERN.d.ts
+/** @deprecated This has been renamed to `FILE_PATH_REGEX_PATTERN`. */
+declare const FILE_PATH_PATTERN: string;
+//#endregion
+//#region src/root/deprecated/UUID_PATTERN.d.ts
+/** @deprecated This has been renamed to `UUID_REGEX_PATTERN`. */
+declare 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}";
+//#endregion
+//#region src/root/deprecated/VERSION_NUMBER_PATTERN.d.ts
+/** @deprecated This has been renamed to `VERSION_NUMBER_REGEX_PATTERN`. */
+declare const VERSION_NUMBER_PATTERN: string;
+//#endregion
 //#region src/root/deprecated/RecordKey.d.ts
 /**
  * Represents the native Record's possible key type.
@@ -1154,6 +1166,8 @@ declare function normaliseIndents(options: NormaliseIndentsOptions): NormaliseIn
  *     and another new line`;
  * ```
  *
+ * @category Tagged Template
+ *
  * @template InterpolationsType - The type of the interpolations.
  *
  * @param strings - The strings from the template to process.
@@ -1181,6 +1195,8 @@ declare function normaliseIndents(strings: TemplateStringsArray, ...interpolatio
  *     and another new line`.
  * ```
  *
+ * @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.
  *
@@ -1483,4 +1499,4 @@ interface ZodParsingErrorData {
   issues: Array<z.core.$ZodIssue>;
 }
 //#endregion
-export { APIError, type ArrayElement, type CallReturnType, type CamelToKebabOptions, type CreateEnumType, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, DataError, type DisallowUndefined, Env, FILE_PATH_PATTERN, FILE_PATH_REGEX, type FormDataArrayResolutionStrategy, type FormDataNullableResolutionStrategy, type HTTPErrorCode, type IgnoreCase, type IsTypeArgumentString, type KebabToCamelOptions, type NonNull, type NonUndefined, type NormaliseIndentsFunction, type NormaliseIndentsOptions, type NormalizeIndentsFunction, type NormalizeIndentsOptions, type NullableOnCondition, ONE_DAY_IN_MILLISECONDS, type OptionalOnCondition, type ParallelTuple, type RecordKey, type RemoveUndefined, SortDirection, type StringListToArrayOptions, type ToTitleCaseOptions, UUID_PATTERN, UUID_REGEX, VERSION_NUMBER_PATTERN, VERSION_NUMBER_REGEX, VersionNumber, type FormatOptionsBase as VersionNumberToStringOptions, VersionType, type ZodParsingErrorData, addDaysToDate, appendSemicolon, assertNotNull, assertNotNullable, assertNotUndefined, az, calculateMonthlyDifference, camelToKebab, containsKeys, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, escapeHTML, escapeRegexPattern, fillArray, formatDateAndTime, getRandomNumber, getRecordKeys, getStringsAndInterpolations, httpErrorCodeLookup, identity, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isNonNullableObject, isOrdered, isSameDate, isTemplateStringsArray, kebabToCamel, normaliseIndents, normalizeIndents, objectContainsKeys, omitProperties, paralleliseArrays, parseBoolean, parseEnv, parseFormData, parseIntStrict, parseUUID, parseVersionType, parseZodSchema, parseZodSchemaAsync, pickProperties, randomiseArray, range, removeDuplicates, removeUndefinedFromObject, sayHello, sortBy, stringListToArray, stringifyDotenv, toTitleCase, truncate, wait, zodVersionNumber };
+export { APIError, type ArrayElement, type CallReturnType, type CamelToKebabOptions, type CreateEnumType, type CreateFormDataOptions, type CreateFormDataOptionsNullableResolution, type CreateFormDataOptionsUndefinedOrNullResolution, DataError, type DisallowUndefined, Env, FILE_PATH_PATTERN, FILE_PATH_REGEX, FILE_PATH_REGEX_PATTERN, type FormDataArrayResolutionStrategy, type FormDataNullableResolutionStrategy, type HTTPErrorCode, type IgnoreCase, type IsTypeArgumentString, type KebabToCamelOptions, type NonNull, type NonUndefined, type NormaliseIndentsFunction, type NormaliseIndentsOptions, type NormalizeIndentsFunction, type NormalizeIndentsOptions, type NullableOnCondition, ONE_DAY_IN_MILLISECONDS, type OptionalOnCondition, type ParallelTuple, type RecordKey, type RemoveUndefined, SortDirection, type StringListToArrayOptions, type ToTitleCaseOptions, UUID_PATTERN, UUID_REGEX, UUID_REGEX_PATTERN, VERSION_NUMBER_PATTERN, VERSION_NUMBER_REGEX, VERSION_NUMBER_REGEX_PATTERN, VersionNumber, type FormatOptionsBase as VersionNumberToStringOptions, VersionType, type ZodParsingErrorData, addDaysToDate, appendSemicolon, assertNotNull, assertNotNullable, assertNotUndefined, az, calculateMonthlyDifference, camelToKebab, containsKeys, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, escapeHTML, escapeRegexPattern, fillArray, formatDateAndTime, getRandomNumber, getRecordKeys, getStringsAndInterpolations, httpErrorCodeLookup, identity, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isNonNullableObject, isOrdered, isSameDate, isTemplateStringsArray, kebabToCamel, normaliseIndents, normalizeIndents, objectContainsKeys, omitProperties, paralleliseArrays, parseBoolean, parseEnv, parseFormData, parseIntStrict, parseUUID, parseVersionType, parseZodSchema, parseZodSchemaAsync, pickProperties, randomiseArray, range, removeDuplicates, removeUndefinedFromObject, sayHello, sortBy, stringListToArray, stringifyDotenv, toTitleCase, truncate, wait, zodVersionNumber };

package/dist/index.js

@@ -1,18 +1,18 @@
 import z, { z as z$1 } from "zod";
 //#region src/root/constants/FILE_PATH_REGEX.ts
-const FILE_PATH_PATTERN = String.raw`(?<directory>.+)[\/\\](?<base>[^\/\\]+)`;
-const FILE_PATH_REGEX = RegExp(`^${FILE_PATH_PATTERN}$`);
+const FILE_PATH_REGEX_PATTERN = String.raw`(?<directory>.+)[\/\\](?<base>[^\/\\]+)`;
+const FILE_PATH_REGEX = RegExp(`^${FILE_PATH_REGEX_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}$`);
+const UUID_REGEX_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_REGEX_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}$`);
+const VERSION_NUMBER_REGEX_PATTERN = String.raw`(?:v)?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)`;
+const VERSION_NUMBER_REGEX = RegExp(`^${VERSION_NUMBER_REGEX_PATTERN}$`);
 //#endregion
 //#region src/root/deprecated/APIError.ts
 const httpErrorCodeLookup = {
@@ -1918,6 +1918,8 @@ function normaliseIndents(first, ...args) {
 *     and another new line`.
 * ```
 *
+* @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.
 *
@@ -2016,4 +2018,16 @@ var DataError = class DataError extends Error {
 	}
 };
 //#endregion
-export { APIError, DataError, Env, FILE_PATH_PATTERN, FILE_PATH_REGEX, ONE_DAY_IN_MILLISECONDS, SortDirection, UUID_PATTERN, UUID_REGEX, VERSION_NUMBER_PATTERN, VERSION_NUMBER_REGEX, VersionNumber, VersionType, addDaysToDate, appendSemicolon, assertNotNull, assertNotNullable, assertNotUndefined, az, calculateMonthlyDifference, camelToKebab, containsKeys, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, escapeHTML, escapeRegexPattern, fillArray, formatDateAndTime, getRandomNumber, getRecordKeys, getStringsAndInterpolations, httpErrorCodeLookup, identity, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isNonNullableObject, isOrdered, isSameDate, isTemplateStringsArray, kebabToCamel, normaliseIndents, normalizeIndents, objectContainsKeys, omitProperties, paralleliseArrays, parseBoolean, parseEnv, parseFormData, parseIntStrict, parseUUID, parseVersionType, parseZodSchema, parseZodSchemaAsync, pickProperties, randomiseArray, range, removeDuplicates, removeUndefinedFromObject, sayHello, sortBy, stringListToArray, stringifyDotenv, toTitleCase, truncate, wait, zodVersionNumber };
+//#region src/root/deprecated/FILE_PATH_PATTERN.ts
+/** @deprecated This has been renamed to `FILE_PATH_REGEX_PATTERN`. */
+const FILE_PATH_PATTERN = FILE_PATH_REGEX_PATTERN;
+//#endregion
+//#region src/root/deprecated/UUID_PATTERN.ts
+/** @deprecated This has been renamed to `UUID_REGEX_PATTERN`. */
+const UUID_PATTERN = UUID_REGEX_PATTERN;
+//#endregion
+//#region src/root/deprecated/VERSION_NUMBER_PATTERN.ts
+/** @deprecated This has been renamed to `VERSION_NUMBER_REGEX_PATTERN`. */
+const VERSION_NUMBER_PATTERN = String.raw`^(?:v)?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$`;
+//#endregion
+export { APIError, DataError, Env, FILE_PATH_PATTERN, FILE_PATH_REGEX, FILE_PATH_REGEX_PATTERN, ONE_DAY_IN_MILLISECONDS, SortDirection, UUID_PATTERN, UUID_REGEX, UUID_REGEX_PATTERN, VERSION_NUMBER_PATTERN, VERSION_NUMBER_REGEX, VERSION_NUMBER_REGEX_PATTERN, VersionNumber, VersionType, addDaysToDate, appendSemicolon, assertNotNull, assertNotNullable, assertNotUndefined, az, calculateMonthlyDifference, camelToKebab, containsKeys, convertFileToBase64, createFormData, createTemplateStringsArray, deepCopy, deepFreeze, escapeHTML, escapeRegexPattern, fillArray, formatDateAndTime, getRandomNumber, getRecordKeys, getStringsAndInterpolations, httpErrorCodeLookup, identity, interpolate, interpolateObjects, isAnniversary, isLeapYear, isMonthlyMultiple, isNonNullableObject, isOrdered, isSameDate, isTemplateStringsArray, kebabToCamel, normaliseIndents, normalizeIndents, objectContainsKeys, omitProperties, paralleliseArrays, parseBoolean, parseEnv, parseFormData, parseIntStrict, parseUUID, parseVersionType, parseZodSchema, parseZodSchemaAsync, pickProperties, randomiseArray, range, removeDuplicates, removeUndefinedFromObject, sayHello, sortBy, stringListToArray, stringifyDotenv, toTitleCase, truncate, wait, zodVersionNumber };

package/dist/internal/index.cjs

@@ -34,8 +34,8 @@ const DependencyGroup = {
 };
 //#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}$`);
+const VERSION_NUMBER_REGEX_PATTERN = String.raw`(?:v)?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)`;
+const VERSION_NUMBER_REGEX = RegExp(`^${VERSION_NUMBER_REGEX_PATTERN}$`);
 //#endregion
 //#region src/v6/CodeError.ts
 /**
@@ -244,49 +244,6 @@ var DataError = class DataError extends CodeError {
 	}
 };
 //#endregion
-//#region src/root/functions/parsers/parseIntStrict.ts
-/**
-* Converts a string to an integer and throws an error if it cannot be converted.
-*
-* @category Parsers
-*
-* @param string - A string to convert into a number.
-* @param radix - A value between 2 and 36 that specifies the base of the number in string. If this argument is not supplied, strings with a prefix of '0x' are considered hexadecimal. All other strings are considered decimal.
-*
-* @throws {DataError} If the provided string cannot safely be converted to an integer.
-*
-* @returns The integer parsed from the input string.
-*/
-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(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.replace(/^[+-]/, "")].some((character) => {
-		return parseInt(character) >= radix;
-	})) 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({ string }, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
-	return parseIntResult;
-}
-//#endregion
-//#region src/root/functions/parsers/parseVersionType.ts
-/**
-* Represents the three common software version types.
-*
-* @category Types
-*/
-const VersionType = {
-	MAJOR: "major",
-	MINOR: "minor",
-	PATCH: "patch"
-};
-//#endregion
 //#region src/root/functions/arrayHelpers/range.ts
 /**
 * Creates an array of numbers within a given range.
@@ -428,6 +385,49 @@ function paralleliseArrays(firstArray, secondArray) {
 	return outputArray;
 }
 //#endregion
+//#region src/root/functions/parsers/parseIntStrict.ts
+/**
+* Converts a string to an integer and throws an error if it cannot be converted.
+*
+* @category Parsers
+*
+* @param string - A string to convert into a number.
+* @param radix - A value between 2 and 36 that specifies the base of the number in string. If this argument is not supplied, strings with a prefix of '0x' are considered hexadecimal. All other strings are considered decimal.
+*
+* @throws {DataError} If the provided string cannot safely be converted to an integer.
+*
+* @returns The integer parsed from the input string.
+*/
+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(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.replace(/^[+-]/, "")].some((character) => {
+		return parseInt(character) >= radix;
+	})) 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({ string }, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
+	return parseIntResult;
+}
+//#endregion
+//#region src/root/functions/parsers/parseVersionType.ts
+/**
+* Represents the three common software version types.
+*
+* @category Types
+*/
+const VersionType = {
+	MAJOR: "major",
+	MINOR: "minor",
+	PATCH: "patch"
+};
+//#endregion
 //#region src/root/functions/taggedTemplate/interpolate.ts
 /**
 * Returns the result of interpolating a template string when given the strings and interpolations separately.

package/dist/internal/index.js

@@ -9,8 +9,8 @@ const DependencyGroup = {
 };
 //#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}$`);
+const VERSION_NUMBER_REGEX_PATTERN = String.raw`(?:v)?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)`;
+const VERSION_NUMBER_REGEX = RegExp(`^${VERSION_NUMBER_REGEX_PATTERN}$`);
 //#endregion
 //#region src/v6/CodeError.ts
 /**
@@ -219,49 +219,6 @@ var DataError = class DataError extends CodeError {
 	}
 };
 //#endregion
-//#region src/root/functions/parsers/parseIntStrict.ts
-/**
-* Converts a string to an integer and throws an error if it cannot be converted.
-*
-* @category Parsers
-*
-* @param string - A string to convert into a number.
-* @param radix - A value between 2 and 36 that specifies the base of the number in string. If this argument is not supplied, strings with a prefix of '0x' are considered hexadecimal. All other strings are considered decimal.
-*
-* @throws {DataError} If the provided string cannot safely be converted to an integer.
-*
-* @returns The integer parsed from the input string.
-*/
-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(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.replace(/^[+-]/, "")].some((character) => {
-		return parseInt(character) >= radix;
-	})) 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({ string }, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
-	return parseIntResult;
-}
-//#endregion
-//#region src/root/functions/parsers/parseVersionType.ts
-/**
-* Represents the three common software version types.
-*
-* @category Types
-*/
-const VersionType = {
-	MAJOR: "major",
-	MINOR: "minor",
-	PATCH: "patch"
-};
-//#endregion
 //#region src/root/functions/arrayHelpers/range.ts
 /**
 * Creates an array of numbers within a given range.
@@ -403,6 +360,49 @@ function paralleliseArrays(firstArray, secondArray) {
 	return outputArray;
 }
 //#endregion
+//#region src/root/functions/parsers/parseIntStrict.ts
+/**
+* Converts a string to an integer and throws an error if it cannot be converted.
+*
+* @category Parsers
+*
+* @param string - A string to convert into a number.
+* @param radix - A value between 2 and 36 that specifies the base of the number in string. If this argument is not supplied, strings with a prefix of '0x' are considered hexadecimal. All other strings are considered decimal.
+*
+* @throws {DataError} If the provided string cannot safely be converted to an integer.
+*
+* @returns The integer parsed from the input string.
+*/
+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(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.replace(/^[+-]/, "")].some((character) => {
+		return parseInt(character) >= radix;
+	})) 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({ string }, "INTEGER_PARSING_ERROR", "Value is not a valid integer.");
+	return parseIntResult;
+}
+//#endregion
+//#region src/root/functions/parsers/parseVersionType.ts
+/**
+* Represents the three common software version types.
+*
+* @category Types
+*/
+const VersionType = {
+	MAJOR: "major",
+	MINOR: "minor",
+	PATCH: "patch"
+};
+//#endregion
 //#region src/root/functions/taggedTemplate/interpolate.ts
 /**
 * Returns the result of interpolating a template string when given the strings and interpolations separately.

package/dist/node/index.cjs

@@ -60,8 +60,8 @@ function normalizeImportPath(importPath) {
 const normaliseImportPath = normalizeImportPath;
 //#endregion
 //#region src/root/constants/FILE_PATH_REGEX.ts
-const FILE_PATH_PATTERN = String.raw`(?<directory>.+)[\/\\](?<base>[^\/\\]+)`;
-const FILE_PATH_REGEX = RegExp(`^${FILE_PATH_PATTERN}$`);
+const FILE_PATH_REGEX_PATTERN = String.raw`(?<directory>.+)[\/\\](?<base>[^\/\\]+)`;
+const FILE_PATH_REGEX = RegExp(`^${FILE_PATH_REGEX_PATTERN}$`);
 //#endregion
 //#region src/root/functions/arrayHelpers/range.ts
 /**

package/dist/node/index.js

@@ -36,8 +36,8 @@ function normalizeImportPath(importPath) {
 const normaliseImportPath = normalizeImportPath;
 //#endregion
 //#region src/root/constants/FILE_PATH_REGEX.ts
-const FILE_PATH_PATTERN = String.raw`(?<directory>.+)[\/\\](?<base>[^\/\\]+)`;
-const FILE_PATH_REGEX = RegExp(`^${FILE_PATH_PATTERN}$`);
+const FILE_PATH_REGEX_PATTERN = String.raw`(?<directory>.+)[\/\\](?<base>[^\/\\]+)`;
+const FILE_PATH_REGEX = RegExp(`^${FILE_PATH_REGEX_PATTERN}$`);
 //#endregion
 //#region src/root/functions/arrayHelpers/range.ts
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/utility",
-  "version": "5.23.1",
+  "version": "5.24.0",
   "description": "Helpful utility functions.",
   "repository": {
     "type": "git",
@@ -40,26 +40,26 @@
     "execa": "9.6.1"
   },
   "devDependencies": {
-    "@alextheman/eslint-plugin": "5.17.1",
-    "@types/node": "25.9.3",
-    "alex-c-line": "2.10.3",
+    "@alextheman/eslint-plugin": "5.18.0",
+    "@types/node": "26.1.0",
+    "alex-c-line": "2.11.3",
     "cross-env": "10.1.0",
     "dotenv-cli": "11.0.0",
-    "eslint": "10.5.0",
-    "globals": "17.6.0",
+    "eslint": "10.6.0",
+    "globals": "17.7.0",
     "husky": "9.1.7",
     "jsdom": "29.1.1",
-    "markdownlint-cli2": "0.22.1",
-    "prettier": "3.8.4",
+    "markdownlint-cli2": "0.23.0",
+    "prettier": "3.9.4",
     "tempy": "3.2.0",
     "tsdown": "0.22.3",
-    "tsx": "4.22.4",
+    "tsx": "4.23.0",
     "typedoc": "0.28.19",
     "typedoc-plugin-markdown": "4.12.0",
     "typedoc-rhineai-theme": "1.2.0",
     "typescript": "6.0.3",
-    "typescript-eslint": "8.61.1",
-    "vite": "8.0.16",
+    "typescript-eslint": "8.62.1",
+    "vite": "8.1.3",
     "vitest": "4.1.9",
     "zod": "4.4.3"
   },
@@ -82,7 +82,7 @@
     "format-prettier-javascript": "prettier --write \"./**/*.js\"",
     "format-prettier-typescript": "prettier --write --parser typescript \"./**/*.ts\"",
     "format-prettier-yml": "prettier --write \"./**/*.{yml,yaml}\"",
-    "lint": "pnpm run lint-tsc && pnpm run lint-eslint && pnpm run lint-markdownlint pnpm run lint-prettier && pnpm run lint-pre-release",
+    "lint": "pnpm run lint-tsc && pnpm run lint-eslint && pnpm run lint-markdownlint && pnpm run lint-prettier && pnpm run lint-pre-release",
     "lint-eslint": "eslint \"package.json\" \"{src,tests,configs}/**/*.ts\"",
     "lint-markdownlint": "bash -o pipefail -c 'pnpm exec markdownlint-cli2 \"**/*.md\" \"!{node_modules,dist}/**\"| grep -v \"^Finding:\"'",
     "lint-pre-release": "alex-c-line package-json check --rules no-pre-release-dependencies",