@andrilla/mado-ui 1.0.2 → 1.0.4

package/dist/utils/index.js

@@ -0,0 +1,664 @@
+import { extendTailwindMerge } from "tailwind-merge";
+
+//#region src/utils/class-management.ts
+/**
+* ### Has Class
+* - Returns a boolean based on whether the specified element has the specified class
+* @param {HTMLElement} element Any HTML Element
+* @param {string} className A string of any class to check for
+* @returns {boolean} true if the specified element has the specified class, else false
+*/
+function hasClass(element, className) {
+	return element.classList.contains(className);
+}
+/**
+* ### Add Class
+* - Adds the specified classes to the specified elements
+* @param {Element|HTMLElement|HTMLElement[]|NodeList|string|undefined} elements An HTML Element, an array of HTML Elements, a Node List, a string (as a selector for a querySelector)
+* @param {string|string[]} classList A string or an array of classes to add to each element
+*/
+function addClass(elements, classList) {
+	const elementsType = elements.constructor.name, elementsIsString = typeof elements === "string", classListType = classList.constructor.name, classListIsString = typeof classList === "string";
+	let elementList, classListGroup;
+	switch (elementsType) {
+		case "String":
+			if (elementsIsString) elementList = Array.from(document.querySelectorAll(elements));
+			break;
+		case "NodeList":
+			if (!elementsIsString) elementList = Array.from(elements);
+			break;
+		case "Array":
+			if (!elementsIsString) elementList = elements;
+			break;
+		default: if (elementsType.startsWith("HTML") && !elementsIsString) elementList = [elements];
+	}
+	switch (classListType) {
+		case "String":
+			if (classListIsString) if (classList.split(" ").length >= 2) classListGroup = classList.split(" ");
+			else classListGroup = [classList];
+			break;
+		case "Array":
+			if (!classListIsString) classListGroup = classList;
+			break;
+	}
+	if (!elementList || elementList.length < 1) throw new Error(`Elements are invalid or undefined. elements: ${elements} → elementList: ${elementList}`);
+	if (!classListGroup || classListGroup.length < 1) throw new Error(`Class List is invalid or undefined. classList: ${classList} → classListGroup: ${classListGroup}`);
+	elementList.forEach((element) => classListGroup.forEach((classItem) => {
+		if (hasClass(element, classItem)) return;
+		element.classList.add(classItem);
+	}));
+}
+/**
+* ### Remove Class
+* - Removes the specified classes from the specified elements
+* @param {HTMLElement|HTMLElement[]|NodeList|string|undefined} elements An HTML Element, an array of HTML Elements, a Node List, a string (as a selector for a querySelector)
+* @param {string|string[]} classList A string or an array of classes to remove from each element
+*/
+function removeClass(elements, classList) {
+	const elementsType = elements.constructor.name, elementsIsString = typeof elements === "string", classListType = classList.constructor.name, classListIsString = typeof classList === "string";
+	let elementList, classListGroup;
+	switch (elementsType) {
+		case "String":
+			if (elementsIsString) elementList = Array.from(document.querySelectorAll(elements));
+			break;
+		case "NodeList":
+			if (!elementsIsString) elementList = Array.from(elements);
+			break;
+		case "Array":
+			if (!elementsIsString) elementList = elements;
+			break;
+		default: if (elementsType.startsWith("HTML") && !elementsIsString) elementList = [elements];
+	}
+	switch (classListType) {
+		case "String":
+			if (classListIsString) if (classList.split(" ").length >= 2) classListGroup = classList.split(" ");
+			else classListGroup = [classList];
+			break;
+		case "Array":
+			if (!classListIsString) classListGroup = classList;
+			break;
+	}
+	if (!elementList || elementList.length < 1) throw new Error(`Elements are invalid or undefined. elements: ${elements} → elementList: ${elementList}`);
+	if (!classListGroup || classListGroup.length < 1) throw new Error(`Class List is invalid or undefined. classList: ${classList} → classListGroup: ${classListGroup}`);
+	elementList.forEach((element) => classListGroup.forEach((classItem) => {
+		if (!hasClass(element, classItem)) return;
+		element.classList.remove(classItem);
+	}));
+}
+/**
+* ### Toggle Class
+* - Toggles the specified classes on the specified elements
+* @param {HTMLElement|HTMLElement[]|NodeList|string|undefined} elements An HTML Element, an array of HTML Elements, a Node List, a string (as a selector for a querySelector)
+* @param {string|string[]} classList A string or an array of classes to toggle on each element
+*/
+function toggleClass(elements, classList) {
+	const elementsType = elements.constructor.name, elementsIsString = typeof elements === "string", classListType = classList.constructor.name, classListIsString = typeof classList === "string";
+	let elementList, classListGroup;
+	switch (elementsType) {
+		case "String":
+			if (elementsIsString) elementList = Array.from(document.querySelectorAll(elements));
+			break;
+		case "NodeList":
+			if (!elementsIsString) elementList = Array.from(elements);
+			break;
+		case "Array":
+			if (!elementsIsString) elementList = elements;
+			break;
+		default: if (elementsType.startsWith("HTML") && !elementsIsString) elementList = [elements];
+	}
+	switch (classListType) {
+		case "String":
+			if (classListIsString) if (classList.split(" ").length >= 2) classListGroup = classList.split(" ");
+			else classListGroup = [classList];
+			break;
+		case "Array":
+			if (!classListIsString) classListGroup = classList;
+			break;
+	}
+	if (!elementList || elementList.length < 1) throw new Error(`Elements are invalid or undefined. elements: ${elements} → elementList: ${elementList}`);
+	if (!classListGroup || classListGroup.length < 1) throw new Error(`Class List is invalid or undefined. classList: ${classList} → classListGroup: ${classListGroup}`);
+	elementList.forEach((element) => classListGroup.forEach((classItem) => {
+		element.classList.toggle(classItem);
+	}));
+}
+
+//#endregion
+//#region src/utils/custom-tailwind-merge.ts
+const integerList = Array.from({ length: 100 }, (_, i) => `${i + 1}`);
+const twMerge = extendTailwindMerge({ extend: { classGroups: {
+	animate: [{ animate: [
+		"bounce",
+		"double-spin",
+		"drop-in",
+		"flip",
+		"flip-again",
+		"grid-rows",
+		"heartbeat",
+		"ping",
+		"pulse",
+		"slide-up",
+		"spin",
+		"wave"
+	] }],
+	"animation-direction": [{ "animation-direction": [
+		"normal",
+		"reverse",
+		"alternate",
+		"alternate-reverse"
+	] }],
+	"animation-fill": [{ "animation-fill": [
+		"none",
+		"forwards",
+		"backwards",
+		"both"
+	] }],
+	"animation-iteration": [{ "animation-iteration": [...integerList, "infinite"] }],
+	"animation-state": [{ "animation-state": ["running", "paused"] }],
+	"grid-cols": [{ "grid-cols": ["0fr", "1fr"] }],
+	"grid-rows": [{ "grid-rows": ["0fr", "1fr"] }],
+	transition: ["transition-rows"]
+} } });
+function extendMadoTailwindMerge(configExtension) {
+	const extend = configExtension.extend || {};
+	const theme = extend.theme || {};
+	const color = "color" in theme ? theme.color : [];
+	const classGroups = extend.classGroups || {};
+	const themeRest = { ...theme };
+	if ("color" in themeRest) delete themeRest.color;
+	const extendRest = { ...extend };
+	delete extendRest.theme;
+	delete extendRest.classGroups;
+	return extendTailwindMerge({
+		extend: {
+			theme: {
+				color: [{ ui: [
+					"red",
+					"orange",
+					"yellow",
+					"green",
+					"sky-blue",
+					"blue",
+					"violet",
+					"magenta",
+					"purple",
+					"brown",
+					"grey",
+					"pink"
+				] }, ...color],
+				...themeRest
+			},
+			classGroups: {
+				animate: [{ animate: [
+					"bounce",
+					"double-spin",
+					"drop-in",
+					"flip",
+					"flip-again",
+					"grid-rows",
+					"heartbeat",
+					"ping",
+					"pulse",
+					"slide-up",
+					"spin",
+					"wave"
+				] }],
+				"animation-direction": [{ "animation-direction": [
+					"normal",
+					"reverse",
+					"alternate",
+					"alternate-reverse"
+				] }],
+				"animation-fill": [{ "animation-fill": [
+					"none",
+					"forwards",
+					"backwards",
+					"both"
+				] }],
+				"animation-iteration": [{ "animation-iteration": [...integerList, "infinite"] }],
+				"animation-state": [{ "animation-state": ["running", "paused"] }],
+				"grid-cols": [{ "grid-cols": ["0fr", "1fr"] }],
+				"grid-rows": [{ "grid-rows": ["0fr", "1fr"] }],
+				transition: ["transition-rows"],
+				...classGroups
+			},
+			...extendRest
+		},
+		...configExtension
+	});
+}
+
+//#endregion
+//#region src/utils/get-date.ts
+/** The current date as a Date object */
+const d = /* @__PURE__ */ new Date();
+/** The current minute of the current hour */
+const minutes = d.getMinutes();
+/** The current year */
+const year = d.getFullYear();
+/** An array of the names of month in order */
+const monthNamesList = [
+	"January",
+	"February",
+	"March",
+	"April",
+	"May",
+	"June",
+	"July",
+	"August",
+	"September",
+	"October",
+	"November",
+	"December"
+];
+/** An array of the names of the days of the week in order */
+const weekdayNamesList = [
+	"Sunday",
+	"Monday",
+	"Tuesday",
+	"Wednesday",
+	"Thursday",
+	"Friday",
+	"Saturday"
+];
+/** The name of the current month */
+const currentMonthName = getMonthName();
+/** The name of the current day of the week */
+const currentWeekdayName = getWeekdayName();
+/**
+* ### Days In Month
+* - Returns the number of days in the specified month.
+* @param {Date} date A Date object representing the month to get the number of days for. (Preset to the current date)
+* @returns {number} The number of days in the specified month.
+*/
+function daysInMonth(date = d) {
+	const selectedYear = date.getFullYear(), selectedMonth = date.getMonth() + 1;
+	return new Date(selectedYear, selectedMonth, 0).getDate();
+}
+/**
+* ### First of Month
+* - Returns the first day of the specified month.
+* @param {Date} date A Date object representing the month to get the first day for. (Preset to current date)
+* @returns {Date} A Date object of the given month, with the first day.
+*/
+function firstOfMonth(date = d) {
+	return new Date(date.getFullYear(), date.getMonth(), 1);
+}
+/**
+* ### Get Date
+* - Returns the date with two digits
+* @param {number|Date} date The date to get date
+* @returns {string} The date with two digits
+*/
+function getDate(date = d) {
+	if (typeof date !== "number") date = date.getDate();
+	let formattedDate = date.toString();
+	if (formattedDate.length === 1) formattedDate = `0${formattedDate}`;
+	return formattedDate;
+}
+/**
+* ### Get Hours
+* - Returns the hours with two digits
+* @param {number|Date} hours The date to get hours
+* @returns {string} The hours with two digits
+*/
+function getHours(hours = d) {
+	if (typeof hours !== "number") hours = hours.getHours();
+	let formattedHours = hours.toString();
+	if (formattedHours.length === 1) formattedHours = `0${formattedHours}`;
+	return formattedHours;
+}
+/**
+* ### Get Hours in 12
+* - Returns the hour based on the specified 24 hour value in a 12 hour format
+* @param {number|Date} hour The hour to be converted to 12 hour format
+* @returns {number} The hour in a 12 hour format
+*/
+function getHoursIn12(hour = d) {
+	if (typeof hour !== "number") hour = hour.getHours();
+	if (hour > 12) return hour - 12;
+	return hour;
+}
+/**
+* ### Get Meridian from Hour
+* - Returns either 'pm' or 'am' based on the specified 24 hour value
+* @param {number|Date} hour The hour to get the meridian from
+* @returns {'am'|'pm'} The meridian for the given hour
+*/
+function getMeridianFromHour(hour = d) {
+	if (typeof hour !== "number") hour = hour.getHours();
+	if (hour >= 12) return "pm";
+	return "am";
+}
+/**
+* ### Get Milliseconds
+* - Returns the milliseconds with two digits
+* @param {number|Date} milliseconds The date to get milliseconds
+* @returns {string} The milliseconds with two digits
+*/
+function getMilliseconds(milliseconds = d) {
+	if (typeof milliseconds !== "number") milliseconds = milliseconds.getMilliseconds();
+	let formattedMilliseconds = minutes.toString();
+	if (formattedMilliseconds.length === 1) formattedMilliseconds = `0${formattedMilliseconds}`;
+	return formattedMilliseconds;
+}
+/**
+* ### Get Minutes
+* - Returns the minutes with two digits
+* @param {number|Date} minutes The date to get minutes
+* @returns {string} The minutes with two digits
+*/
+function getMinutes(minutes = d) {
+	if (typeof minutes !== "number") minutes = minutes.getMinutes();
+	let formattedMinutes = minutes.toString();
+	if (formattedMinutes.length === 1) formattedMinutes = `0${formattedMinutes}`;
+	return formattedMinutes;
+}
+/**
+* ### Get Month
+* - Returns the month with two digits
+* @param {number|Date} month The date to get month
+* @returns {string} The month with two digits
+*/
+function getMonth(month = d) {
+	if (typeof month !== "number") month = month.getMonth() + 1;
+	let formattedMonth = month.toString();
+	if (formattedMonth.length === 1) formattedMonth = `0${formattedMonth}`;
+	return formattedMonth;
+}
+function getMonthIndexFromName(name) {
+	return monthNamesList.findIndex((monthName) => monthName === name);
+}
+/**
+* ### Get Month Name
+* - Returns the name of the specified month
+* @param {Date} date A Date object representing the month to get the name of the month from. (Preset to the current date)
+* @returns {MonthName} The name of the specified month
+*/
+function getMonthName(date = d) {
+	if (typeof date === "number") return monthNamesList[date];
+	return monthNamesList[date.getMonth()];
+}
+/**
+* ### Get Next Month
+* - Returns the number of the following month from the specified month
+* @param {Date} date The Date object representing the month to get the following month from (Preset to current date)
+* @returns {number} The indexed month of the following month
+*/
+function getNextMonth(date = d) {
+	const givenMonth = date.getMonth();
+	return givenMonth === 11 ? 0 : givenMonth + 1;
+}
+/**
+* ### Get Previous Month
+* - Returns the number of the previous month from the specified month
+* @param {Date} date The Date object representing the month to get the previous month from (Preset to current date)
+* @returns {number} The indexed month of the previous month
+*/
+function getPreviousMonth(date = d) {
+	const givenMonth = date.getMonth();
+	return givenMonth === 0 ? 11 : givenMonth - 1;
+}
+/**
+* ### Get Seconds
+* - Returns the seconds with two digits
+* @param {number|Date} seconds The date to get seconds
+* @returns {string} The seconds with two digits
+*/
+function getSeconds(seconds = d) {
+	if (typeof seconds !== "number") seconds = seconds.getSeconds();
+	let formattedSeconds = seconds.toString();
+	if (formattedSeconds.length === 1) formattedSeconds = `0${formattedSeconds}`;
+	return formattedSeconds;
+}
+/**
+* ### Get User Readable Date
+* - Returns a string of the current date in a user-friendly way
+* - Includes `'Yesterday'`, '`Today'`, and `'Tomorrow'`
+* @param date (default: `new Date()`)
+* @returns {'Today'|'Tomorrow'|'Yesterday'|string} `'weekday, month day, year'` | `'Yesterday'` | `'Today'` | `'Tomorrow'`
+*/
+function getUserReadableDate(date = d) {
+	const dateTime = date.getTime();
+	const today = /* @__PURE__ */ new Date();
+	if (dateTime === today.getTime()) return "Today";
+	if (dateTime === (/* @__PURE__ */ new Date(today.getDate() - 1)).getTime()) return "Yesterday";
+	if (dateTime === new Date(today.getDate() + 1).getTime()) return "Tomorrow";
+	const thisYear = today.getFullYear();
+	return toFullDateString(date, {
+		weekday: "code",
+		year: !(date.getFullYear() === thisYear)
+	});
+}
+/**
+* ### Get Weekday Name
+* - Returns the weekday name of the specified day
+* @param {number | Date} weekday A Date object or number representing the day to get the weekday name from. (Preset to the current date)
+* @returns {WeekdayName} The name of the specified weekday
+*/
+function getWeekdayName(weekday = d) {
+	if (typeof weekday === "number") return weekdayNamesList[weekday];
+	return weekdayNamesList[weekday.getDay()];
+}
+/**
+* ### Get Years in Range
+* - Returns an array of years in between the specified minimum and maximum years
+* @param {number} minYear The minimum year
+* @param {number} maxYear The maximum year
+* @returns {number[]} Array of years
+*/
+function getYearsInRange(minYear = 0, maxYear = year) {
+	const yearList = [];
+	for (let selectedYear = minYear; selectedYear <= maxYear; selectedYear++) yearList.push(selectedYear);
+	return yearList;
+}
+/**
+* ### To Full Date String
+* - Returns a formatted string to display the date
+* @param {Date} date (default: `new Date()`)
+* @param {ToFullDateStringOptionsProps} options Change how to display the weekday, month name, day of the month, and year.
+* @returns {string} '`weekday`, `month` `day`, `year`'
+*/
+function toFullDateString(date = d, options) {
+	let weekdayName = getWeekdayName(date), monthName = getMonthName(date), dayOfMonth = date.getDate(), year = date.getFullYear().toString();
+	if (options) {
+		const includesWeekday = options.weekday !== false, includesDay = options.day !== false, includesMonth = options.month !== false, includesYear = options.year !== false;
+		if (includesWeekday) {
+			if (options.weekday === "code") weekdayName = weekdayName.slice(0, 3);
+			if (includesMonth || includesDay || includesYear) weekdayName += ", ";
+		} else weekdayName = "";
+		if (includesMonth) {
+			if (options.month === "code") monthName = monthName.slice(0, 3);
+			if (includesDay) monthName += " ";
+		} else monthName = "";
+		if (!includesDay) dayOfMonth = "";
+		if (includesYear) {
+			if (options.year === "code") year = year.slice(-2);
+			if (includesMonth || includesDay) year = ", " + year;
+		} else year = "";
+	}
+	return weekdayName + monthName + dayOfMonth + year;
+}
+/**
+* ### Get User Readable Date From Timestampz
+* - Returns a string of the current date in a user-friendly way
+* - Includes `'Yesterday'`, '`Today'`, and `'Tomorrow'`
+* @param string
+* @returns {'Today'|'Tomorrow'|'Yesterday'|string} `'weekday, month day, year'` | `'Yesterday'` | `'Today'` | `'Tomorrow'`
+*/
+function getUserReadableDateFromTimestampz(timestampz) {
+	const [date, time] = timestampz.split("T") || [];
+	const [year, month, day] = date?.split("-").map((string) => Number(string)) || [];
+	const [hms, _timezone] = time?.includes("+") ? time?.split("+") : time?.split("-") || [];
+	const [hours, minutes, seconds] = hms?.split(":").map((string) => Number(string)) || [];
+	return getUserReadableDate(new Date(year, month - 1, day, hours, minutes, seconds));
+}
+function getLocalTime(time) {
+	const date = /* @__PURE__ */ new Date(), [hours, minutes] = typeof time === "string" ? time.split(":") : time;
+	const timezone = getTimezone();
+	console.log(timezone);
+	date.setUTCHours(Number(hours));
+	date.setMinutes(Number(minutes));
+	return date.toLocaleTimeString([], {
+		hour: "numeric",
+		minute: "2-digit",
+		hour12: true
+	});
+}
+function getTimezone() {
+	const date = /* @__PURE__ */ new Date();
+	const timezonePart = Intl.DateTimeFormat("en-US", { timeZoneName: "short" }).formatToParts(date).find((part) => part.type === "timeZoneName");
+	return timezonePart ? timezonePart.value : "";
+}
+
+//#endregion
+//#region src/utils/math.ts
+function easeOutExpo(time, start, end, duration) {
+	return time == duration ? start + end : end * (-Math.pow(2, -10 * time / duration) + 1) + start;
+}
+
+//#endregion
+//#region src/utils/regex.ts
+const emailRegex = /^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/;
+/**
+* # Is Email
+* Checks whether the specified string is in email format
+*/
+function isEmail(email) {
+	return emailRegex.test(email);
+}
+const telRegex = /(?:\+1\s|1\s|)?\d{3}\.\d{3}\.\d{4}|(?:\+1\s|1\s|)?\d{3}-\d{3}-\d{4}|(?:\+1\s|1\s|)?\(\d{3}\) \d{3}-\d{4}|(?:\+1\s|1\s|\+1|1|)?\d{10}/;
+/**
+* # Is Phone Number
+* Checks whether the specified string is in phone number format
+*/
+function isPhoneNumber(tel) {
+	return telRegex.test(tel);
+}
+
+//#endregion
+//#region src/utils/string-manipulation.ts
+/**
+* # Format Phone Number
+* Converts any string containing at least 10 numbers to a formatted phone number
+* @param {string} phoneNumber
+* @param options
+* @property {string} `countryCode`
+* @property {'continuous' | 'dot' | 'hyphenated' | 'none' | 'space' | 'standard'} `format`
+*
+* Input: a555b555c5555d
+*
+* @example
+* format: 'continuous'
+* countryCode: '1'
+* returns: +1 5555555555
+*
+* @example
+* format: 'dot'
+* returns: 555.555.5555
+*
+* @example
+* format: 'hyphenated'
+* returns: 555-555-5555
+*
+* @example
+* format: 'none'
+* countryCode: '1'
+* returns: +1 a555b555c5555d
+*
+* @example
+* format: 'space'
+* returns: 555 555 5555
+*
+* @example
+* format: 'standard' (default)
+* returns: (555) 555-5555
+*
+* @returns {string} string formatted
+*/
+function formatPhoneNumber(phoneNumber, options) {
+	const format = options?.format || "standard";
+	if (format !== "none") phoneNumber = phoneNumber.replace(/\D/g, "").slice(-10);
+	switch (format) {
+		case "dot":
+			phoneNumber = phoneNumber.split("").map((char, index) => {
+				if (index === 2) return `${char}.`;
+				if (index === 5) return `${char}.`;
+				return char;
+			}).join("");
+			break;
+		case "hyphenated":
+			phoneNumber = phoneNumber.split("").map((char, index) => {
+				if (index === 2) return `${char}-`;
+				if (index === 5) return `${char}-`;
+				return char;
+			}).join("");
+			break;
+		case "space":
+			phoneNumber = phoneNumber.split("").map((char, index) => {
+				if (index === 2) return `${char} `;
+				if (index === 5) return `${char} `;
+				return char;
+			}).join("");
+			break;
+		case "standard": phoneNumber = phoneNumber.split("").map((char, index) => {
+			if (index === 0) return `(${char}`;
+			if (index === 2) return `${char}) `;
+			if (index === 5) return `${char}-`;
+			return char;
+		}).join("");
+	}
+	return `${options?.countryCode ? `+${options?.countryCode} ` : ""}` + phoneNumber;
+}
+/**
+* ### Split Camel Case
+* - Separates a camel case string with a joiner (default: ' ')
+* @param {string} string
+* @returns {string} string
+*/
+function splitCamelCase(string, joiner = " ") {
+	if (string[0].match(/[A-Z0-9]/) || string.includes(" ")) return string;
+	let lastChar = "";
+	return string.split("").map((char) => {
+		let returnedString = char;
+		if (char.match(/[A-Z0-9]/)) returnedString = ` ${char}`;
+		if (lastChar.match(/[0-9]/) && char.match(/[0-9]/)) returnedString = char;
+		lastChar = char;
+		return returnedString;
+	}).join(joiner);
+}
+/**
+* ### To Camel Case
+* - Converts any string to camel case based on spaces
+* - Eliminates no letter-number characters
+* @param {string} string
+* @returns {string} string
+*/
+function toCamelCase(string, delimiter = " ") {
+	if (typeof string !== "string") return string;
+	return string.toLowerCase().replace(/[^a-z0-9]/gi, delimiter).split(delimiter).map((str, index) => index === 0 ? str : str.substring(0, 1).toUpperCase() + str.substring(1, str.length).toLowerCase()).join("");
+}
+/**
+* # To Lower Case
+* Converts a string to lowercase, and offers easy string replacements for creating snake case, kebab case, or your own.
+* @param str - The string to convert to lowercase.
+* @param options - Configuration options.
+* @param options[0] - The delimiter to split the string. Defaults to space.
+* @param options[1] - The string to join the parts back together. Defaults to space.
+* @returns The lowercase version of the input string, with the replacements, if provided.
+*/
+function toLowerCase(str, [delimiter, joiner]) {
+	return str.toLowerCase().replaceAll(delimiter || " ", joiner || " ");
+}
+/**
+* ### To Title Case
+* - Converts any string to title case based on spaces
+* @param {string} string
+* @returns {string} string
+*/
+function toTitleCase(string, delimiter = " ") {
+	if (typeof string !== "string") return string;
+	return string.toLowerCase().split(delimiter).map((str) => str.substring(0, 1).toUpperCase() + str.substring(1, str.length).toLowerCase()).join(" ");
+}
+
+//#endregion
+export { addClass, currentMonthName, currentWeekdayName, daysInMonth, easeOutExpo, emailRegex, extendMadoTailwindMerge, firstOfMonth, formatPhoneNumber, getDate, getHours, getHoursIn12, getLocalTime, getMeridianFromHour, getMilliseconds, getMinutes, getMonth, getMonthIndexFromName, getMonthName, getNextMonth, getPreviousMonth, getSeconds, getTimezone, getUserReadableDate, getUserReadableDateFromTimestampz, getWeekdayName, getYearsInRange, hasClass, isEmail, isPhoneNumber, monthNamesList, removeClass, splitCamelCase, telRegex, toCamelCase, toFullDateString, toLowerCase, toTitleCase, toggleClass, twMerge, weekdayNamesList };