@alextheman/utility 3.5.8 → 3.5.10

package/dist/index.cjs

@@ -51,9 +51,12 @@ var appendSemicolon_default = appendSemicolon;
 *
 * If the callback returns at least one Promise, the entire result will be wrapped
 * in a `Promise` and resolved with `Promise.all`. Otherwise, a plain array is returned.
+*
 * @template ItemType
+*
 * @param callback - A function invoked with the current index. May return a value or a Promise.
-* @param [length] - The desired length of the resulting array.
+* @param length - The desired length of the resulting array.
+*
 * @returns An array of the callback results, or a Promise resolving to one if the callback is async.
 */
 function fillArray(callback, length = 1) {
@@ -74,10 +77,13 @@ var fillArray_default = fillArray;
 *
 * If `secondArray` is shorter than `firstArray`, the second position in the tuple
 * will be `undefined`. Iteration always uses the length of the first array.
+*
 * @template FirstArrayItem
 * @template SecondArrayItem
+*
 * @param firstArray - The first array. Each item in this will take up the first tuple spot.
 * @param secondArray - The second array. Each item in this will take up the second tuple spot.
+*
 * @returns An array of `[firstItem, secondItem]` tuples for each index in `firstArray`.
 */
 function paralleliseArrays(firstArray, secondArray) {
@@ -113,6 +119,15 @@ var getRandomNumber_default = getRandomNumber;
 
 //#endregion
 //#region src/functions/arrayHelpers/randomiseArray.ts
+/**
+* Randomises the order of a given array and returns the result in a new array without mutating the original.
+*
+* @template ItemType - The type of the array items.
+*
+* @param array - The array to randomise.
+*
+* @returns A new array with the items randomised.
+*/
 function randomiseArray(array) {
 	const mutableArray = [...array];
 	const outputArray = [];
@@ -126,6 +141,21 @@ var randomiseArray_default = randomiseArray;
 
 //#endregion
 //#region src/functions/arrayHelpers/range.ts
+/**
+* Creates an array of numbers within a given range.
+*
+* The range is inclusive of `start` and exclusive of `stop`.
+* The sign of `step` must match the direction of the range.
+*
+* @param start - The number to start at (inclusive).
+* @param stop - The number to stop at (exclusive).
+* @param step - The step size between numbers, defaulting to 1.
+*
+* @throws {Error} If `step` is `0`.
+* @throws {Error} If `step` direction does not match the order of `start` and `stop`.
+*
+* @returns An array of numbers satisfying the range provided.
+*/
 function range(start, stop, step = 1) {
 	const numbers = [];
 	if (step === 0) throw new Error("ZERO_STEP_SIZE_NOT_ALLOWED");
@@ -234,8 +264,16 @@ var createTemplateStringsArray_default = createTemplateStringsArray;
 
 //#endregion
 //#region src/functions/date/addDaysToDate.ts
+/**
+* Adds a given number of days to the provided date, returning the result as a new instance of Date.
+*
+* @param currentDate - The starting date (defaults to today).
+* @param dayIncrement - The amount of days you want to add (defaults to 1)
+*
+* @returns A new Date instance with the number of days added to the initially provided date.
+*/
 function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement = 1) {
-	const newDate = currentDate;
+	const newDate = new Date(currentDate);
 	newDate.setDate(newDate.getDate() + dayIncrement);
 	return newDate;
 }
@@ -243,6 +281,14 @@ var addDaysToDate_default = addDaysToDate;
 
 //#endregion
 //#region src/functions/date/isSameDate.ts
+/**
+* Checks if the provided dates happen on the exact same day, month, and year.
+*
+* @param firstDate - The first date to compare.
+* @param secondDate - The second date to compare.
+*
+* @returns True if the provided dates occur on exactly the same day, month, and year, and returns false otherwise.
+*/
 function isSameDate(firstDate, secondDate) {
 	return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth() && firstDate.getFullYear() === secondDate.getFullYear();
 }
@@ -250,6 +296,17 @@ var isSameDate_default = isSameDate;
 
 //#endregion
 //#region src/functions/date/formatDateAndTime.ts
+/**
+* Creates a human-readable string with information about the input date.
+*
+* @param inputDate - The date to base the string on.
+*
+* @returns A new string with information about the given date.
+*
+* - If the date given is today, the output will be something like `Today at HH:MM`
+* - If the date given happened yesterday, the output will be something like `Yesterday at HH:MM`
+* - 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 today = /* @__PURE__ */ new Date();
@@ -262,6 +319,15 @@ var formatDateAndTime_default = formatDateAndTime;
 
 //#endregion
 //#region src/functions/date/isLeapYear.ts
+/**
+* Checks if the provided year is a leap year.
+*
+* @param year - The year to check as a number.
+*
+* @throws {TypeError} If the year provided is not an integer.
+*
+* @returns True if the year is a leap year, and false otherwise.
+*/
 function isLeapYear(year) {
 	const parsedYear = parseIntStrict_default(`${year}`);
 	return parsedYear % 4 === 0 && parsedYear % 100 !== 0 || parsedYear % 400 === 0;
@@ -274,6 +340,14 @@ function checkLeapYear(firstDate, secondDate) {
 	if (isLeapYear_default(firstDate.getFullYear()) && firstDate.getMonth() === 1 && secondDate.getMonth() === 1) return firstDate.getDate() === 29 && secondDate.getDate() === 28;
 	return false;
 }
+/**
+* Checks if the provided dates are exactly a whole number of years apart.
+*
+* @param firstDate - The first date to compare.
+* @param secondDate - The second date to compare.
+*
+* @returns True if the provided dates are exactly a whole number of years apart, and false otherwise.
+*/
 function isAnniversary(firstDate, secondDate) {
 	if (checkLeapYear(firstDate, secondDate) || checkLeapYear(secondDate, firstDate)) return true;
 	return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth();
@@ -312,6 +386,14 @@ function leapYearFebruaryChecks(firstDate, secondDate) {
 	}
 	return false;
 }
+/**
+* Checks if the provided dates are exactly a whole number of months apart.
+*
+* @param firstDate - The first date to compare.
+* @param secondDate - The second date to compare.
+*
+* @returns True if the provided dates are exactly a whole number of months apart, and false otherwise.
+*/
 function isMonthlyMultiple(firstDate, secondDate) {
 	if (endOfMonthChecksButNotFebruary(firstDate, secondDate) || endOfMonthChecksButNotFebruary(secondDate, firstDate)) return true;
 	if (nonLeapYearFebruaryChecks(firstDate, secondDate) || nonLeapYearFebruaryChecks(secondDate, firstDate)) return true;

package/dist/index.d.cts

@@ -12,9 +12,12 @@ declare function appendSemicolon(stringToAppendTo: string): string;
  *
  * The callback will be invoked once for each index from `0` to `length - 1`.
  * If no length is provided, a single-element array will be produced.
+ *
  * @template ItemType
+ *
  * @param callback - An asynchronous function invoked with the current index.
- * @param [length] - The desired length of the resulting array.
+ * @param length - The desired length of the resulting array.
+ *
  * @returns A Promise resolving to an array of the callback results.
  */
 declare function fillArray<ItemType$1>(callback: (index: number) => Promise<ItemType$1>, length?: number): Promise<ItemType$1[]>;
@@ -23,9 +26,12 @@ declare function fillArray<ItemType$1>(callback: (index: number) => Promise<Item
  *
  * The callback will be invoked once for each index from `0` to `length - 1`.
  * If no length is provided, a single-element array will be produced.
+ *
  * @template ItemType
+ *
  * @param callback - A synchronous function invoked with the current index.
- * @param [length] - The desired length of the resulting array.
+ * @param length - The desired length of the resulting array.
+ *
  * @returns An array of the callback results.
  */
 declare function fillArray<ItemType$1>(callback: (index: number) => ItemType$1, length?: number): ItemType$1[];
@@ -37,18 +43,45 @@ type ParallelTuple<A, B> = [A, B | undefined];
  *
  * If `secondArray` is shorter than `firstArray`, the second position in the tuple
  * will be `undefined`. Iteration always uses the length of the first array.
+ *
  * @template FirstArrayItem
  * @template SecondArrayItem
+ *
  * @param firstArray - The first array. Each item in this will take up the first tuple spot.
  * @param secondArray - The second array. Each item in this will take up the second tuple spot.
+ *
  * @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>[];
 //#endregion
 //#region src/functions/arrayHelpers/randomiseArray.d.ts
-declare function randomiseArray<T>(array: T[]): T[];
+/**
+ * Randomises the order of a given array and returns the result in a new array without mutating the original.
+ *
+ * @template ItemType - The type of the array items.
+ *
+ * @param array - The array to randomise.
+ *
+ * @returns A new array with the items randomised.
+ */
+declare function randomiseArray<ItemType$1>(array: ItemType$1[]): ItemType$1[];
 //#endregion
 //#region src/functions/arrayHelpers/range.d.ts
+/**
+ * Creates an array of numbers within a given range.
+ *
+ * The range is inclusive of `start` and exclusive of `stop`.
+ * The sign of `step` must match the direction of the range.
+ *
+ * @param start - The number to start at (inclusive).
+ * @param stop - The number to stop at (exclusive).
+ * @param step - The step size between numbers, defaulting to 1.
+ *
+ * @throws {Error} If `step` is `0`.
+ * @throws {Error} If `step` direction does not match the order of `start` and `stop`.
+ *
+ * @returns An array of numbers satisfying the range provided.
+ */
 declare function range(start: number, stop: number, step?: number): number[];
 //#endregion
 //#region src/functions/camelToKebab.d.ts
@@ -143,21 +176,73 @@ declare function createFormData<T extends Record<RecordKey, unknown>>(data: T, o
 declare function createTemplateStringsArray(strings: readonly string[]): TemplateStringsArray;
 //#endregion
 //#region src/functions/date/addDaysToDate.d.ts
+/**
+ * Adds a given number of days to the provided date, returning the result as a new instance of Date.
+ *
+ * @param currentDate - The starting date (defaults to today).
+ * @param dayIncrement - The amount of days you want to add (defaults to 1)
+ *
+ * @returns A new Date instance with the number of days added to the initially provided date.
+ */
 declare function addDaysToDate(currentDate?: Date, dayIncrement?: number): Date;
 //#endregion
 //#region src/functions/date/formatDateAndTime.d.ts
+/**
+ * Creates a human-readable string with information about the input date.
+ *
+ * @param inputDate - The date to base the string on.
+ *
+ * @returns A new string with information about the given date.
+ *
+ * - If the date given is today, the output will be something like `Today at HH:MM`
+ * - If the date given happened yesterday, the output will be something like `Yesterday at HH:MM`
+ * - For any other date, the output will be something like `DD/MM/YYYY, HH:MM`
+ */
 declare function formatDateAndTime(inputDate: Date): string;
 //#endregion
 //#region src/functions/date/isAnniversary.d.ts
+/**
+ * Checks if the provided dates are exactly a whole number of years apart.
+ *
+ * @param firstDate - The first date to compare.
+ * @param secondDate - The second date to compare.
+ *
+ * @returns True if the provided dates are exactly a whole number of years apart, and false otherwise.
+ */
 declare function isAnniversary(firstDate: Date, secondDate: Date): boolean;
 //#endregion
 //#region src/functions/date/isLeapYear.d.ts
+/**
+ * Checks if the provided year is a leap year.
+ *
+ * @param year - The year to check as a number.
+ *
+ * @throws {TypeError} If the year provided is not an integer.
+ *
+ * @returns True if the year is a leap year, and false otherwise.
+ */
 declare function isLeapYear(year: number): boolean;
 //#endregion
 //#region src/functions/date/isMonthlyMultiple.d.ts
+/**
+ * Checks if the provided dates are exactly a whole number of months apart.
+ *
+ * @param firstDate - The first date to compare.
+ * @param secondDate - The second date to compare.
+ *
+ * @returns True if the provided dates are exactly a whole number of months apart, and false otherwise.
+ */
 declare function isMonthlyMultiple(firstDate: Date, secondDate: Date): boolean;
 //#endregion
 //#region src/functions/date/isSameDate.d.ts
+/**
+ * Checks if the provided dates happen on the exact same day, month, and year.
+ *
+ * @param firstDate - The first date to compare.
+ * @param secondDate - The second date to compare.
+ *
+ * @returns True if the provided dates occur on exactly the same day, month, and year, and returns false otherwise.
+ */
 declare function isSameDate(firstDate: Date, secondDate: Date): boolean;
 //#endregion
 //#region src/functions/deepCopy.d.ts

package/dist/index.d.ts

@@ -12,9 +12,12 @@ declare function appendSemicolon(stringToAppendTo: string): string;
  *
  * The callback will be invoked once for each index from `0` to `length - 1`.
  * If no length is provided, a single-element array will be produced.
+ *
  * @template ItemType
+ *
  * @param callback - An asynchronous function invoked with the current index.
- * @param [length] - The desired length of the resulting array.
+ * @param length - The desired length of the resulting array.
+ *
  * @returns A Promise resolving to an array of the callback results.
  */
 declare function fillArray<ItemType$1>(callback: (index: number) => Promise<ItemType$1>, length?: number): Promise<ItemType$1[]>;
@@ -23,9 +26,12 @@ declare function fillArray<ItemType$1>(callback: (index: number) => Promise<Item
  *
  * The callback will be invoked once for each index from `0` to `length - 1`.
  * If no length is provided, a single-element array will be produced.
+ *
  * @template ItemType
+ *
  * @param callback - A synchronous function invoked with the current index.
- * @param [length] - The desired length of the resulting array.
+ * @param length - The desired length of the resulting array.
+ *
  * @returns An array of the callback results.
  */
 declare function fillArray<ItemType$1>(callback: (index: number) => ItemType$1, length?: number): ItemType$1[];
@@ -37,18 +43,45 @@ type ParallelTuple<A, B> = [A, B | undefined];
  *
  * If `secondArray` is shorter than `firstArray`, the second position in the tuple
  * will be `undefined`. Iteration always uses the length of the first array.
+ *
  * @template FirstArrayItem
  * @template SecondArrayItem
+ *
  * @param firstArray - The first array. Each item in this will take up the first tuple spot.
  * @param secondArray - The second array. Each item in this will take up the second tuple spot.
+ *
  * @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>[];
 //#endregion
 //#region src/functions/arrayHelpers/randomiseArray.d.ts
-declare function randomiseArray<T>(array: T[]): T[];
+/**
+ * Randomises the order of a given array and returns the result in a new array without mutating the original.
+ *
+ * @template ItemType - The type of the array items.
+ *
+ * @param array - The array to randomise.
+ *
+ * @returns A new array with the items randomised.
+ */
+declare function randomiseArray<ItemType$1>(array: ItemType$1[]): ItemType$1[];
 //#endregion
 //#region src/functions/arrayHelpers/range.d.ts
+/**
+ * Creates an array of numbers within a given range.
+ *
+ * The range is inclusive of `start` and exclusive of `stop`.
+ * The sign of `step` must match the direction of the range.
+ *
+ * @param start - The number to start at (inclusive).
+ * @param stop - The number to stop at (exclusive).
+ * @param step - The step size between numbers, defaulting to 1.
+ *
+ * @throws {Error} If `step` is `0`.
+ * @throws {Error} If `step` direction does not match the order of `start` and `stop`.
+ *
+ * @returns An array of numbers satisfying the range provided.
+ */
 declare function range(start: number, stop: number, step?: number): number[];
 //#endregion
 //#region src/functions/camelToKebab.d.ts
@@ -143,21 +176,73 @@ declare function createFormData<T extends Record<RecordKey, unknown>>(data: T, o
 declare function createTemplateStringsArray(strings: readonly string[]): TemplateStringsArray;
 //#endregion
 //#region src/functions/date/addDaysToDate.d.ts
+/**
+ * Adds a given number of days to the provided date, returning the result as a new instance of Date.
+ *
+ * @param currentDate - The starting date (defaults to today).
+ * @param dayIncrement - The amount of days you want to add (defaults to 1)
+ *
+ * @returns A new Date instance with the number of days added to the initially provided date.
+ */
 declare function addDaysToDate(currentDate?: Date, dayIncrement?: number): Date;
 //#endregion
 //#region src/functions/date/formatDateAndTime.d.ts
+/**
+ * Creates a human-readable string with information about the input date.
+ *
+ * @param inputDate - The date to base the string on.
+ *
+ * @returns A new string with information about the given date.
+ *
+ * - If the date given is today, the output will be something like `Today at HH:MM`
+ * - If the date given happened yesterday, the output will be something like `Yesterday at HH:MM`
+ * - For any other date, the output will be something like `DD/MM/YYYY, HH:MM`
+ */
 declare function formatDateAndTime(inputDate: Date): string;
 //#endregion
 //#region src/functions/date/isAnniversary.d.ts
+/**
+ * Checks if the provided dates are exactly a whole number of years apart.
+ *
+ * @param firstDate - The first date to compare.
+ * @param secondDate - The second date to compare.
+ *
+ * @returns True if the provided dates are exactly a whole number of years apart, and false otherwise.
+ */
 declare function isAnniversary(firstDate: Date, secondDate: Date): boolean;
 //#endregion
 //#region src/functions/date/isLeapYear.d.ts
+/**
+ * Checks if the provided year is a leap year.
+ *
+ * @param year - The year to check as a number.
+ *
+ * @throws {TypeError} If the year provided is not an integer.
+ *
+ * @returns True if the year is a leap year, and false otherwise.
+ */
 declare function isLeapYear(year: number): boolean;
 //#endregion
 //#region src/functions/date/isMonthlyMultiple.d.ts
+/**
+ * Checks if the provided dates are exactly a whole number of months apart.
+ *
+ * @param firstDate - The first date to compare.
+ * @param secondDate - The second date to compare.
+ *
+ * @returns True if the provided dates are exactly a whole number of months apart, and false otherwise.
+ */
 declare function isMonthlyMultiple(firstDate: Date, secondDate: Date): boolean;
 //#endregion
 //#region src/functions/date/isSameDate.d.ts
+/**
+ * Checks if the provided dates happen on the exact same day, month, and year.
+ *
+ * @param firstDate - The first date to compare.
+ * @param secondDate - The second date to compare.
+ *
+ * @returns True if the provided dates occur on exactly the same day, month, and year, and returns false otherwise.
+ */
 declare function isSameDate(firstDate: Date, secondDate: Date): boolean;
 //#endregion
 //#region src/functions/deepCopy.d.ts

package/dist/index.js

@@ -22,9 +22,12 @@ var appendSemicolon_default = appendSemicolon;
 *
 * If the callback returns at least one Promise, the entire result will be wrapped
 * in a `Promise` and resolved with `Promise.all`. Otherwise, a plain array is returned.
+*
 * @template ItemType
+*
 * @param callback - A function invoked with the current index. May return a value or a Promise.
-* @param [length] - The desired length of the resulting array.
+* @param length - The desired length of the resulting array.
+*
 * @returns An array of the callback results, or a Promise resolving to one if the callback is async.
 */
 function fillArray(callback, length = 1) {
@@ -45,10 +48,13 @@ var fillArray_default = fillArray;
 *
 * If `secondArray` is shorter than `firstArray`, the second position in the tuple
 * will be `undefined`. Iteration always uses the length of the first array.
+*
 * @template FirstArrayItem
 * @template SecondArrayItem
+*
 * @param firstArray - The first array. Each item in this will take up the first tuple spot.
 * @param secondArray - The second array. Each item in this will take up the second tuple spot.
+*
 * @returns An array of `[firstItem, secondItem]` tuples for each index in `firstArray`.
 */
 function paralleliseArrays(firstArray, secondArray) {
@@ -84,6 +90,15 @@ var getRandomNumber_default = getRandomNumber;
 
 //#endregion
 //#region src/functions/arrayHelpers/randomiseArray.ts
+/**
+* Randomises the order of a given array and returns the result in a new array without mutating the original.
+*
+* @template ItemType - The type of the array items.
+*
+* @param array - The array to randomise.
+*
+* @returns A new array with the items randomised.
+*/
 function randomiseArray(array) {
 	const mutableArray = [...array];
 	const outputArray = [];
@@ -97,6 +112,21 @@ var randomiseArray_default = randomiseArray;
 
 //#endregion
 //#region src/functions/arrayHelpers/range.ts
+/**
+* Creates an array of numbers within a given range.
+*
+* The range is inclusive of `start` and exclusive of `stop`.
+* The sign of `step` must match the direction of the range.
+*
+* @param start - The number to start at (inclusive).
+* @param stop - The number to stop at (exclusive).
+* @param step - The step size between numbers, defaulting to 1.
+*
+* @throws {Error} If `step` is `0`.
+* @throws {Error} If `step` direction does not match the order of `start` and `stop`.
+*
+* @returns An array of numbers satisfying the range provided.
+*/
 function range(start, stop, step = 1) {
 	const numbers = [];
 	if (step === 0) throw new Error("ZERO_STEP_SIZE_NOT_ALLOWED");
@@ -205,8 +235,16 @@ var createTemplateStringsArray_default = createTemplateStringsArray;
 
 //#endregion
 //#region src/functions/date/addDaysToDate.ts
+/**
+* Adds a given number of days to the provided date, returning the result as a new instance of Date.
+*
+* @param currentDate - The starting date (defaults to today).
+* @param dayIncrement - The amount of days you want to add (defaults to 1)
+*
+* @returns A new Date instance with the number of days added to the initially provided date.
+*/
 function addDaysToDate(currentDate = /* @__PURE__ */ new Date(), dayIncrement = 1) {
-	const newDate = currentDate;
+	const newDate = new Date(currentDate);
 	newDate.setDate(newDate.getDate() + dayIncrement);
 	return newDate;
 }
@@ -214,6 +252,14 @@ var addDaysToDate_default = addDaysToDate;
 
 //#endregion
 //#region src/functions/date/isSameDate.ts
+/**
+* Checks if the provided dates happen on the exact same day, month, and year.
+*
+* @param firstDate - The first date to compare.
+* @param secondDate - The second date to compare.
+*
+* @returns True if the provided dates occur on exactly the same day, month, and year, and returns false otherwise.
+*/
 function isSameDate(firstDate, secondDate) {
 	return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth() && firstDate.getFullYear() === secondDate.getFullYear();
 }
@@ -221,6 +267,17 @@ var isSameDate_default = isSameDate;
 
 //#endregion
 //#region src/functions/date/formatDateAndTime.ts
+/**
+* Creates a human-readable string with information about the input date.
+*
+* @param inputDate - The date to base the string on.
+*
+* @returns A new string with information about the given date.
+*
+* - If the date given is today, the output will be something like `Today at HH:MM`
+* - If the date given happened yesterday, the output will be something like `Yesterday at HH:MM`
+* - 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 today = /* @__PURE__ */ new Date();
@@ -233,6 +290,15 @@ var formatDateAndTime_default = formatDateAndTime;
 
 //#endregion
 //#region src/functions/date/isLeapYear.ts
+/**
+* Checks if the provided year is a leap year.
+*
+* @param year - The year to check as a number.
+*
+* @throws {TypeError} If the year provided is not an integer.
+*
+* @returns True if the year is a leap year, and false otherwise.
+*/
 function isLeapYear(year) {
 	const parsedYear = parseIntStrict_default(`${year}`);
 	return parsedYear % 4 === 0 && parsedYear % 100 !== 0 || parsedYear % 400 === 0;
@@ -245,6 +311,14 @@ function checkLeapYear(firstDate, secondDate) {
 	if (isLeapYear_default(firstDate.getFullYear()) && firstDate.getMonth() === 1 && secondDate.getMonth() === 1) return firstDate.getDate() === 29 && secondDate.getDate() === 28;
 	return false;
 }
+/**
+* Checks if the provided dates are exactly a whole number of years apart.
+*
+* @param firstDate - The first date to compare.
+* @param secondDate - The second date to compare.
+*
+* @returns True if the provided dates are exactly a whole number of years apart, and false otherwise.
+*/
 function isAnniversary(firstDate, secondDate) {
 	if (checkLeapYear(firstDate, secondDate) || checkLeapYear(secondDate, firstDate)) return true;
 	return firstDate.getDate() === secondDate.getDate() && firstDate.getMonth() === secondDate.getMonth();
@@ -283,6 +357,14 @@ function leapYearFebruaryChecks(firstDate, secondDate) {
 	}
 	return false;
 }
+/**
+* Checks if the provided dates are exactly a whole number of months apart.
+*
+* @param firstDate - The first date to compare.
+* @param secondDate - The second date to compare.
+*
+* @returns True if the provided dates are exactly a whole number of months apart, and false otherwise.
+*/
 function isMonthlyMultiple(firstDate, secondDate) {
 	if (endOfMonthChecksButNotFebruary(firstDate, secondDate) || endOfMonthChecksButNotFebruary(secondDate, firstDate)) return true;
 	if (nonLeapYearFebruaryChecks(firstDate, secondDate) || nonLeapYearFebruaryChecks(secondDate, firstDate)) return true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alextheman/utility",
-  "version": "3.5.8",
+  "version": "3.5.10",
   "description": "Helpful utility functions",
   "repository": {
     "type": "git",
@@ -19,7 +19,7 @@
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@alextheman/eslint-plugin": "^4.5.1",
+    "@alextheman/eslint-plugin": "^4.8.0",
     "@types/node": "^25.0.1",
     "dotenv-cli": "^11.0.0",
     "eslint": "^9.39.1",