toolbox-x 2.0.0 → 2.0.10

package/dist/date.cjs

@@ -16,12 +16,49 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primitives = require('./primitives-CBGICrDR.cjs');
+const require_constants = require('./constants-CgFaV72Z.cjs');
 const require_timezone = require('./timezone-CSz7R0L6.cjs');
 const require_specials = require('./specials-dkYP1Nh2.cjs');
 const require_utilities = require('./utilities-CWV1GPGY.cjs');
-const require_guards = require('./guards-Bsh6Bfdq.cjs');
-const require_parse = require('./parse-DT7jbWx7.cjs');
+const require_parse = require('./parse-CbVVRoFY.cjs');
+const require_basics = require('./basics-Bb5ovcvz.cjs');
 
+//#region src/date/calculation.ts
+/**
+* * A function that takes a date and adds units to it.
+*
+* @param date Can be a Date object, timestamp, or date string.
+* @param units Units to add to the date.
+* @returns Valid Date object with the added units.
+*
+* @throws - {@link TypeError} If the provided date is invalid or units/values are invalid.
+*
+* @remarks
+* - This function creates a {@link Date new Date} object and does not modify the original {@link Date} object if provided one.
+* - If `date` is `undefined`, it will use the current date and time.
+*
+* @example
+* ```ts
+* import { addDate } from 'toolbox-x/date';
+*
+* const final = addDate('2026-06-15T01:39:59.288Z', { day: 1, hour: '7' });
+*
+* console.log(final); // new Date('2026-06-16T08:39:59.288Z')
+* ```
+*/
+function addDate(date, units) {
+	const $date = require_parse._dateArgsToDate(date);
+	if (Number.isNaN($date.getTime())) throw new TypeError("Provided date is invalid!");
+	const expected = new Date($date);
+	for (const [unit, value] of Object.entries(units)) {
+		const val = require_utilities.normalizeNumber(value);
+		if (!require_specials.isObjectWithKeys(require_constants.DATE_UNIT_SETTERS, [unit]) || !require_primitives.isNumber(val)) throw new TypeError(`Provided unit or value is invalid!`);
+		require_constants.DATE_UNIT_SETTERS[unit](expected, val);
+	}
+	return expected;
+}
+
+//#endregion
 //#region src/date/utils.ts
 /**
 * * Extracts the hour and minute from a time string in `HH:MM` or `-HH:MM` format.
@@ -143,7 +180,7 @@ const TZ_MAP = /* @__PURE__ */ new Map();
 * @returns An array of matching IANA time-zone identifiers, or an empty array if the offset is invalid.
 */
 function getTimeZoneIds(offset) {
-	if (!require_guards.isValidUTCOffset(offset)) return [];
+	if (!require_basics.isValidUTCOffset(offset)) return [];
 	if (TZ_MAP.has(offset)) return TZ_MAP.get(offset) ?? [];
 	for (const zone of require_timezone.NATIVE_TZ_IDS) {
 		const off = require_parse._gmtToUtcOffset(require_parse._resolveNativeTzName(zone, "longOffset"));
@@ -240,6 +277,43 @@ function formatDateRelative(date, format) {
 		format: format || "mmm D, yyyy hh:mm a"
 	});
 }
+/**
+* * Formats a date as a relative time string using {@link Intl.RelativeTimeFormat} native method.
+*
+* @param toDate - The date to format, which can be a `Date` object, a date string, or a timestamp number.
+* @param options - Optional configuration for relative date formatting.
+* @returns A relative time string.
+*
+* @remarks
+* - If `toDate` is provided but `undefined`, current date and time will be used.
+* - If `fromDate` is provided but `undefined`, current date and time will be used.
+* - If any of the provided date value (`toDate` or `fromDate`) is invalid, the function will return `'Invalid Date!'`.
+*
+* @example
+* formatRelativeDateNative(Date.now() - 5 * 60000); // "5m ago"
+* formatRelativeDateNative(Date.now() + 2 * 3600000); // "in 2 hours"
+*/
+function formatRelativeDateNative(toDate, options) {
+	const { fromDate = /* @__PURE__ */ new Date(), locale = "en", localeMatcher, numeric = "always", style } = options ?? {};
+	const to = require_parse._dateArgsToDate(toDate).getTime();
+	const from = require_parse._dateArgsToDate(fromDate).getTime();
+	if (Number.isNaN(to) || Number.isNaN(from)) return "Invalid Date!";
+	let duration = (to - from) / 1e3;
+	const RELATIVE_DATE_FORMATTER = new Intl.RelativeTimeFormat(locale, {
+		localeMatcher,
+		numeric,
+		style
+	});
+	let formatted = "Just now";
+	for (const division of require_constants.RELATIVE_TIME_DIVISIONS) {
+		if (Math.abs(duration) < division.amount) {
+			formatted = RELATIVE_DATE_FORMATTER.format(Math.round(duration), division.name);
+			break;
+		}
+		duration /= division.amount;
+	}
+	return formatted;
+}
 /** Get timestamp in ISO 8601 format. */
 function getTimestamp(args, format) {
 	let $value;
@@ -277,7 +351,7 @@ function getGreeting(configs) {
 	const { morningEnds = "11:59", noonEnds = "12:59", afternoonEnds = "17:59", eveningEnds = "23:59", midnightEnds = "02:59", currentTime, appendToMsg = "", prependToMsg = "", morningMessage = "Good Morning!", noonMessage = "Good Noon!", afternoonMessage = "Good Afternoon!", eveningMessage = "Good Evening!", midnightMessage = "Hello, Night Owl!", defaultMessage = "Greetings!" } = configs || {};
 	let hour;
 	let minute;
-	if (currentTime && require_guards.isValidTime(currentTime)) [hour, minute] = extractHourMinute(currentTime);
+	if (currentTime && require_basics.isValidTime(currentTime)) [hour, minute] = extractHourMinute(currentTime);
 	else {
 		hour = getCurrentDateTime().getHours();
 		minute = getCurrentDateTime().getMinutes();
@@ -296,6 +370,7 @@ function getGreeting(configs) {
 }
 
 //#endregion
+exports.addDate = addDate;
 exports.convertMinutesToHourMinutes = convertMinutesToTime;
 exports.convertMinutesToTime = convertMinutesToTime;
 exports.convertMinutesToUTCOffset = formatUTCOffset;
@@ -306,9 +381,12 @@ exports.extractTimeStringFromUTC = extractTimeFromUTC;
 exports.extractTotalMinutesFromTime = getTotalMinutes;
 exports.formatDate = formatDate;
 exports.formatDateRelative = formatDateRelative;
+exports.formatDateRelativeNative = formatRelativeDateNative;
 exports.formatDateTime = formatDate;
 exports.formatRelativeDate = formatDateRelative;
+exports.formatRelativeDateNative = formatRelativeDateNative;
 exports.formatRelativeTime = formatDateRelative;
+exports.formatRelativeTimeNative = formatRelativeDateNative;
 exports.formatTimePart = formatTimePart;
 exports.formatUTCOffset = formatUTCOffset;
 exports.generateGreeting = getGreeting;

package/dist/date.d.cts

@@ -14,8 +14,33 @@
  * limitations under the License.
  */
 
-import { En as UTCOffset, Gt as GreetingConfigs, Jt as ISODateFormat, Kt as HourMinutes, Mt as DateArgs, Nt as DateFormatOptions, Yt as ISODateTimeString, bn as TimeZoneIdNative, ct as Numeric, fn as TimeOnlyFormat, gn as TimeWithUnit, jt as ClockTime, ln as SafeFormat, nt as Maybe, vn as TimeZoneDetails, wn as TimestampOptions, wt as $TimeZoneIdentifier } from "./object-X5fSMx-I.cjs";
+import { Dn as UTCOffset, Gt as GreetingConfigs, Jt as ISODateFormat, Kt as HourMinutes, Mt as DateArgs, Nt as DateFormatOptions, On as UnitWithValue, Tn as TimestampOptions, Yt as ISODateTimeString, _n as TimeWithUnit, ct as Numeric, jt as ClockTime, ln as RelativeDateFormatOptions, nt as Maybe, pn as TimeOnlyFormat, un as SafeFormat, wt as $TimeZoneIdentifier, xn as TimeZoneIdNative, yn as TimeZoneDetails } from "./object-ahxpI5tD.cjs";
 
+//#region src/date/calculation.d.ts
+/**
+ * * A function that takes a date and adds units to it.
+ *
+ * @param date Can be a Date object, timestamp, or date string.
+ * @param units Units to add to the date.
+ * @returns Valid Date object with the added units.
+ *
+ * @throws - {@link TypeError} If the provided date is invalid or units/values are invalid.
+ *
+ * @remarks
+ * - This function creates a {@link Date new Date} object and does not modify the original {@link Date} object if provided one.
+ * - If `date` is `undefined`, it will use the current date and time.
+ *
+ * @example
+ * ```ts
+ * import { addDate } from 'toolbox-x/date';
+ *
+ * const final = addDate('2026-06-15T01:39:59.288Z', { day: 1, hour: '7' });
+ *
+ * console.log(final); // new Date('2026-06-16T08:39:59.288Z')
+ * ```
+ */
+declare function addDate(date: Maybe<DateArgs>, units: UnitWithValue): Date;
+//#endregion
 //#region src/date/greet.d.ts
 /**
  * * Returns a greeting message based on the provided time or current time.
@@ -175,6 +200,23 @@ declare function formatTimePart(time: string, format?: TimeOnlyFormat): string;
  * formatDateRelative(Date.now() - 10 * 86400000); // "Apr 6, 2026 04:11 PM" (formatted date string)
  */
 declare function formatDateRelative(date: Maybe<DateArgs>, format?: SafeFormat): string;
+/**
+ * * Formats a date as a relative time string using {@link Intl.RelativeTimeFormat} native method.
+ *
+ * @param toDate - The date to format, which can be a `Date` object, a date string, or a timestamp number.
+ * @param options - Optional configuration for relative date formatting.
+ * @returns A relative time string.
+ *
+ * @remarks
+ * - If `toDate` is provided but `undefined`, current date and time will be used.
+ * - If `fromDate` is provided but `undefined`, current date and time will be used.
+ * - If any of the provided date value (`toDate` or `fromDate`) is invalid, the function will return `'Invalid Date!'`.
+ *
+ * @example
+ * formatRelativeDateNative(Date.now() - 5 * 60000); // "5m ago"
+ * formatRelativeDateNative(Date.now() + 2 * 3600000); // "in 2 hours"
+ */
+declare function formatRelativeDateNative(toDate: DateArgs, options?: RelativeDateFormatOptions): string;
 /**
  * * Get timestamp in ISO 8601 format for the current date and time.
  *
@@ -210,4 +252,4 @@ declare function getTimestamp<F extends ISODateFormat>(value: DateArgs, format?:
  */
 declare function getTimestamp<F extends ISODateFormat>(options: TimestampOptions<F>): ISODateTimeString<F>;
 //#endregion
-export { convertMinutesToTime as convertMinutesToHourMinutes, convertMinutesToTime, convertMinutesToTime as getHourMinutesFromMinutes, convertMinutesToTime as getTimeFromMinutes, formatUTCOffset as convertMinutesToUTCOffset, formatUTCOffset, formatUTCOffset as minutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractMinutesFromUTC as getMinutesFromUTC, extractMinutesFromUTC as getTotalMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, formatDate, formatDate as formatDateTime, formatDateRelative, formatDateRelative as formatRelativeDate, formatDateRelative as formatRelativeTime, formatTimePart, getGreeting as generateGreeting, getGreeting, getGreeting as greet, getCurrentDateTime, getCurrentDateTime as getCurrentTime, getNativeTimeZoneId, getTimeZoneDetails, getTimeZoneIds, getTimestamp, parseMSec, parseMSec as parseMs };
+export { addDate, convertMinutesToTime as convertMinutesToHourMinutes, convertMinutesToTime, convertMinutesToTime as getHourMinutesFromMinutes, convertMinutesToTime as getTimeFromMinutes, formatUTCOffset as convertMinutesToUTCOffset, formatUTCOffset, formatUTCOffset as minutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractMinutesFromUTC as getMinutesFromUTC, extractMinutesFromUTC as getTotalMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, formatDate, formatDate as formatDateTime, formatDateRelative, formatDateRelative as formatRelativeDate, formatDateRelative as formatRelativeTime, formatRelativeDateNative as formatDateRelativeNative, formatRelativeDateNative, formatRelativeDateNative as formatRelativeTimeNative, formatTimePart, getGreeting as generateGreeting, getGreeting, getGreeting as greet, getCurrentDateTime, getCurrentDateTime as getCurrentTime, getNativeTimeZoneId, getTimeZoneDetails, getTimeZoneIds, getTimestamp, parseMSec, parseMSec as parseMs };

package/dist/date.d.mts

@@ -14,8 +14,33 @@
  * limitations under the License.
  */
 
-import { En as UTCOffset, Gt as GreetingConfigs, Jt as ISODateFormat, Kt as HourMinutes, Mt as DateArgs, Nt as DateFormatOptions, Yt as ISODateTimeString, bn as TimeZoneIdNative, ct as Numeric, fn as TimeOnlyFormat, gn as TimeWithUnit, jt as ClockTime, ln as SafeFormat, nt as Maybe, vn as TimeZoneDetails, wn as TimestampOptions, wt as $TimeZoneIdentifier } from "./object-X5fSMx-I.mjs";
+import { Dn as UTCOffset, Gt as GreetingConfigs, Jt as ISODateFormat, Kt as HourMinutes, Mt as DateArgs, Nt as DateFormatOptions, On as UnitWithValue, Tn as TimestampOptions, Yt as ISODateTimeString, _n as TimeWithUnit, ct as Numeric, jt as ClockTime, ln as RelativeDateFormatOptions, nt as Maybe, pn as TimeOnlyFormat, un as SafeFormat, wt as $TimeZoneIdentifier, xn as TimeZoneIdNative, yn as TimeZoneDetails } from "./object-ahxpI5tD.mjs";
 
+//#region src/date/calculation.d.ts
+/**
+ * * A function that takes a date and adds units to it.
+ *
+ * @param date Can be a Date object, timestamp, or date string.
+ * @param units Units to add to the date.
+ * @returns Valid Date object with the added units.
+ *
+ * @throws - {@link TypeError} If the provided date is invalid or units/values are invalid.
+ *
+ * @remarks
+ * - This function creates a {@link Date new Date} object and does not modify the original {@link Date} object if provided one.
+ * - If `date` is `undefined`, it will use the current date and time.
+ *
+ * @example
+ * ```ts
+ * import { addDate } from 'toolbox-x/date';
+ *
+ * const final = addDate('2026-06-15T01:39:59.288Z', { day: 1, hour: '7' });
+ *
+ * console.log(final); // new Date('2026-06-16T08:39:59.288Z')
+ * ```
+ */
+declare function addDate(date: Maybe<DateArgs>, units: UnitWithValue): Date;
+//#endregion
 //#region src/date/greet.d.ts
 /**
  * * Returns a greeting message based on the provided time or current time.
@@ -175,6 +200,23 @@ declare function formatTimePart(time: string, format?: TimeOnlyFormat): string;
  * formatDateRelative(Date.now() - 10 * 86400000); // "Apr 6, 2026 04:11 PM" (formatted date string)
  */
 declare function formatDateRelative(date: Maybe<DateArgs>, format?: SafeFormat): string;
+/**
+ * * Formats a date as a relative time string using {@link Intl.RelativeTimeFormat} native method.
+ *
+ * @param toDate - The date to format, which can be a `Date` object, a date string, or a timestamp number.
+ * @param options - Optional configuration for relative date formatting.
+ * @returns A relative time string.
+ *
+ * @remarks
+ * - If `toDate` is provided but `undefined`, current date and time will be used.
+ * - If `fromDate` is provided but `undefined`, current date and time will be used.
+ * - If any of the provided date value (`toDate` or `fromDate`) is invalid, the function will return `'Invalid Date!'`.
+ *
+ * @example
+ * formatRelativeDateNative(Date.now() - 5 * 60000); // "5m ago"
+ * formatRelativeDateNative(Date.now() + 2 * 3600000); // "in 2 hours"
+ */
+declare function formatRelativeDateNative(toDate: DateArgs, options?: RelativeDateFormatOptions): string;
 /**
  * * Get timestamp in ISO 8601 format for the current date and time.
  *
@@ -210,4 +252,4 @@ declare function getTimestamp<F extends ISODateFormat>(value: DateArgs, format?:
  */
 declare function getTimestamp<F extends ISODateFormat>(options: TimestampOptions<F>): ISODateTimeString<F>;
 //#endregion
-export { convertMinutesToTime as convertMinutesToHourMinutes, convertMinutesToTime, convertMinutesToTime as getHourMinutesFromMinutes, convertMinutesToTime as getTimeFromMinutes, formatUTCOffset as convertMinutesToUTCOffset, formatUTCOffset, formatUTCOffset as minutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractMinutesFromUTC as getMinutesFromUTC, extractMinutesFromUTC as getTotalMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, formatDate, formatDate as formatDateTime, formatDateRelative, formatDateRelative as formatRelativeDate, formatDateRelative as formatRelativeTime, formatTimePart, getGreeting as generateGreeting, getGreeting, getGreeting as greet, getCurrentDateTime, getCurrentDateTime as getCurrentTime, getNativeTimeZoneId, getTimeZoneDetails, getTimeZoneIds, getTimestamp, parseMSec, parseMSec as parseMs };
+export { addDate, convertMinutesToTime as convertMinutesToHourMinutes, convertMinutesToTime, convertMinutesToTime as getHourMinutesFromMinutes, convertMinutesToTime as getTimeFromMinutes, formatUTCOffset as convertMinutesToUTCOffset, formatUTCOffset, formatUTCOffset as minutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractMinutesFromUTC as getMinutesFromUTC, extractMinutesFromUTC as getTotalMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, formatDate, formatDate as formatDateTime, formatDateRelative, formatDateRelative as formatRelativeDate, formatDateRelative as formatRelativeTime, formatRelativeDateNative as formatDateRelativeNative, formatRelativeDateNative, formatRelativeDateNative as formatRelativeTimeNative, formatTimePart, getGreeting as generateGreeting, getGreeting, getGreeting as greet, getCurrentDateTime, getCurrentDateTime as getCurrentTime, getNativeTimeZoneId, getTimeZoneDetails, getTimeZoneIds, getTimestamp, parseMSec, parseMSec as parseMs };

package/dist/date.mjs

@@ -14,13 +14,50 @@
  * limitations under the License.
  */
 
-import { m as isUndefined } from "./primitives-Djsevc69.mjs";
+import { c as isNumber, m as isUndefined } from "./primitives-Djsevc69.mjs";
+import { a as RELATIVE_TIME_DIVISIONS, t as DATE_UNIT_SETTERS } from "./constants-GZL_CT1W.mjs";
 import { n as NATIVE_TZ_IDS } from "./timezone-avZ4TvDx.mjs";
-import { T as isObject } from "./specials-Hq5Ncd6y.mjs";
+import { E as isObjectWithKeys, T as isObject } from "./specials-Hq5Ncd6y.mjs";
 import { a as normalizeNumber } from "./utilities-DPscNbS1.mjs";
-import { a as isValidTime, s as isValidUTCOffset } from "./guards-BK1QuvFZ.mjs";
-import { a as _normalizeOffset, i as _gmtToUtcOffset, n as _dateArgsToDate, o as _resolveNativeTzName, r as _formatDate, t as parseMSec } from "./parse-erxBG2hd.mjs";
+import { a as _normalizeOffset, i as _gmtToUtcOffset, n as _dateArgsToDate, o as _resolveNativeTzName, r as _formatDate, t as parseMSec } from "./parse-DUJ0YThn.mjs";
+import { Q as isValidTime, et as isValidUTCOffset } from "./basics-Dald7J6c.mjs";
 
+//#region src/date/calculation.ts
+/**
+* * A function that takes a date and adds units to it.
+*
+* @param date Can be a Date object, timestamp, or date string.
+* @param units Units to add to the date.
+* @returns Valid Date object with the added units.
+*
+* @throws - {@link TypeError} If the provided date is invalid or units/values are invalid.
+*
+* @remarks
+* - This function creates a {@link Date new Date} object and does not modify the original {@link Date} object if provided one.
+* - If `date` is `undefined`, it will use the current date and time.
+*
+* @example
+* ```ts
+* import { addDate } from 'toolbox-x/date';
+*
+* const final = addDate('2026-06-15T01:39:59.288Z', { day: 1, hour: '7' });
+*
+* console.log(final); // new Date('2026-06-16T08:39:59.288Z')
+* ```
+*/
+function addDate(date, units) {
+	const $date = _dateArgsToDate(date);
+	if (Number.isNaN($date.getTime())) throw new TypeError("Provided date is invalid!");
+	const expected = new Date($date);
+	for (const [unit, value] of Object.entries(units)) {
+		const val = normalizeNumber(value);
+		if (!isObjectWithKeys(DATE_UNIT_SETTERS, [unit]) || !isNumber(val)) throw new TypeError(`Provided unit or value is invalid!`);
+		DATE_UNIT_SETTERS[unit](expected, val);
+	}
+	return expected;
+}
+
+//#endregion
 //#region src/date/utils.ts
 /**
 * * Extracts the hour and minute from a time string in `HH:MM` or `-HH:MM` format.
@@ -239,6 +276,43 @@ function formatDateRelative(date, format) {
 		format: format || "mmm D, yyyy hh:mm a"
 	});
 }
+/**
+* * Formats a date as a relative time string using {@link Intl.RelativeTimeFormat} native method.
+*
+* @param toDate - The date to format, which can be a `Date` object, a date string, or a timestamp number.
+* @param options - Optional configuration for relative date formatting.
+* @returns A relative time string.
+*
+* @remarks
+* - If `toDate` is provided but `undefined`, current date and time will be used.
+* - If `fromDate` is provided but `undefined`, current date and time will be used.
+* - If any of the provided date value (`toDate` or `fromDate`) is invalid, the function will return `'Invalid Date!'`.
+*
+* @example
+* formatRelativeDateNative(Date.now() - 5 * 60000); // "5m ago"
+* formatRelativeDateNative(Date.now() + 2 * 3600000); // "in 2 hours"
+*/
+function formatRelativeDateNative(toDate, options) {
+	const { fromDate = /* @__PURE__ */ new Date(), locale = "en", localeMatcher, numeric = "always", style } = options ?? {};
+	const to = _dateArgsToDate(toDate).getTime();
+	const from = _dateArgsToDate(fromDate).getTime();
+	if (Number.isNaN(to) || Number.isNaN(from)) return "Invalid Date!";
+	let duration = (to - from) / 1e3;
+	const RELATIVE_DATE_FORMATTER = new Intl.RelativeTimeFormat(locale, {
+		localeMatcher,
+		numeric,
+		style
+	});
+	let formatted = "Just now";
+	for (const division of RELATIVE_TIME_DIVISIONS) {
+		if (Math.abs(duration) < division.amount) {
+			formatted = RELATIVE_DATE_FORMATTER.format(Math.round(duration), division.name);
+			break;
+		}
+		duration /= division.amount;
+	}
+	return formatted;
+}
 /** Get timestamp in ISO 8601 format. */
 function getTimestamp(args, format) {
 	let $value;
@@ -295,4 +369,4 @@ function getGreeting(configs) {
 }
 
 //#endregion
-export { convertMinutesToTime as convertMinutesToHourMinutes, convertMinutesToTime, convertMinutesToTime as getHourMinutesFromMinutes, convertMinutesToTime as getTimeFromMinutes, formatUTCOffset as convertMinutesToUTCOffset, formatUTCOffset, formatUTCOffset as minutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractMinutesFromUTC as getMinutesFromUTC, extractMinutesFromUTC as getTotalMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, formatDate, formatDate as formatDateTime, formatDateRelative, formatDateRelative as formatRelativeDate, formatDateRelative as formatRelativeTime, formatTimePart, getGreeting as generateGreeting, getGreeting, getGreeting as greet, getCurrentDateTime, getCurrentDateTime as getCurrentTime, getNativeTimeZoneId, getTimeZoneDetails, getTimeZoneIds, getTimestamp, parseMSec, parseMSec as parseMs };
+export { addDate, convertMinutesToTime as convertMinutesToHourMinutes, convertMinutesToTime, convertMinutesToTime as getHourMinutesFromMinutes, convertMinutesToTime as getTimeFromMinutes, formatUTCOffset as convertMinutesToUTCOffset, formatUTCOffset, formatUTCOffset as minutesToUTCOffset, extractHourMinute, extractMinutesFromUTC, extractMinutesFromUTC as getMinutesFromUTC, extractMinutesFromUTC as getTotalMinutesFromUTC, extractTimeFromUTC, extractTimeFromUTC as extractTimeStringFromUTC, extractTimeFromUTC as getTimeStringFromUTC, getTotalMinutes as extractTotalMinutesFromTime, getTotalMinutes, getTotalMinutes as getTotalMinutesFromTime, formatDate, formatDate as formatDateTime, formatDateRelative, formatDateRelative as formatRelativeDate, formatDateRelative as formatRelativeTime, formatRelativeDateNative as formatDateRelativeNative, formatRelativeDateNative, formatRelativeDateNative as formatRelativeTimeNative, formatTimePart, getGreeting as generateGreeting, getGreeting, getGreeting as greet, getCurrentDateTime, getCurrentDateTime as getCurrentTime, getNativeTimeZoneId, getTimeZoneDetails, getTimeZoneIds, getTimestamp, parseMSec, parseMSec as parseMs };

package/dist/dom.cjs

@@ -17,9 +17,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primitives = require('./primitives-CBGICrDR.cjs');
 const require_specials = require('./specials-dkYP1Nh2.cjs');
-const require_guards = require('./guards-Bsh6Bfdq.cjs');
-const require_basics = require('./basics-CJmdhXoo.cjs');
-const require_objectify = require('./objectify-xQvZS3UI.cjs');
+const require_basics = require('./basics-Bb5ovcvz.cjs');
+const require_objectify = require('./objectify--6hPlQ7r.cjs');
 
 //#region src/dom/query.ts
 /**
@@ -315,8 +314,8 @@ const createFormData = (data, configs) => {
 			const transformedKey = _transformKey(key);
 			const fullKey = parentKey ? `${parentKey}.${transformedKey}` : transformedKey;
 			if (_compareKeyPaths(fullKey, ignoreKeys)) return acc;
-			if (value != null && value !== "" || _isRequiredKey(fullKey) || require_primitives.isNonEmptyString(value) || require_specials.isValidArray(value) || require_specials.isNotEmptyObject(value)) if (require_guards.isDateLike(value)) acc[transformedKey] = value;
-			else if (require_specials.isNotEmptyObject(value)) if (require_guards.isDateLike(value)) acc[transformedKey] = value;
+			if (value != null && value !== "" || _isRequiredKey(fullKey) || require_primitives.isNonEmptyString(value) || require_specials.isValidArray(value) || require_specials.isNotEmptyObject(value)) if (require_basics.isDateLike(value)) acc[transformedKey] = value;
+			else if (require_specials.isNotEmptyObject(value)) if (require_basics.isDateLike(value)) acc[transformedKey] = value;
 			else {
 				const cleaned = _cleanObject(value, fullKey);
 				if (_isRequiredKey(fullKey) || require_specials.isNotEmptyObject(cleaned)) acc[transformedKey] = cleaned;
@@ -358,7 +357,7 @@ const createFormData = (data, configs) => {
 			});
 			else formData.append(transformedKey, JSON.stringify(value));
 			else if (_isRequiredKey(key)) formData.append(transformedKey, JSON.stringify(value));
-		} else if (require_guards.isDateLike(value)) formData.append(transformedKey, _parseDateLike(value));
+		} else if (require_basics.isDateLike(value)) formData.append(transformedKey, _parseDateLike(value));
 		else if (require_specials.isNotEmptyObject(value)) if (_shouldStringify(key) && !_shouldDotNotate(key)) {
 			const cleanedValue = _cleanObject(value, key);
 			if (require_specials.isNotEmptyObject(cleanedValue) || _isRequiredKey(key)) formData.append(transformedKey, JSON.stringify(cleanedValue));
@@ -380,10 +379,10 @@ const createFormData = (data, configs) => {
 			if (_compareKeyPaths(fullKey, ignoreKeys)) return;
 			if (configs?.trimStrings && require_primitives.isNonEmptyString(value)) value = require_basics.trimString(value);
 			if (_shouldDotNotate(fullKey)) _addToFormData(fullKey, value);
-			else if (require_specials.isNotEmptyObject(value) && !_shouldStringify(fullKey)) if (require_guards.isDateLike(value)) _addToFormData(key, _parseDateLike(value));
+			else if (require_specials.isNotEmptyObject(value) && !_shouldStringify(fullKey)) if (require_basics.isDateLike(value)) _addToFormData(key, _parseDateLike(value));
 			else _processObject(value, key);
 			else if (require_objectify.isFileOrBlob(value)) _addToFormData(key, value);
-			else if (require_guards.isDateLike(value)) _addToFormData(key, _parseDateLike(value));
+			else if (require_basics.isDateLike(value)) _addToFormData(key, _parseDateLike(value));
 			else if (require_specials.isEmptyObject(value)) {
 				if (_isRequiredKey(fullKey)) _addToFormData(key, JSON.stringify(value));
 			} else _addToFormData(key, value);

package/dist/dom.d.cts

@@ -14,9 +14,9 @@
  * limitations under the License.
  */
 
-import { J as Deserializer, M as ParsedQueryGeneric, N as QueryObject, ft as Serializer, j as ParsedQuery, y as GenericObject } from "./object-X5fSMx-I.cjs";
-import { F as QueryString } from "./string-CO7HP50i.cjs";
-import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-Cp1OyCRI.cjs";
+import { J as Deserializer, M as ParsedQueryGeneric, N as QueryObject, ft as Serializer, j as ParsedQuery, y as GenericObject } from "./object-ahxpI5tD.cjs";
+import { F as QueryString } from "./string-DENMnjFc.cjs";
+import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-B91Vb6IK.cjs";
 
 //#region src/dom/query.d.ts
 /**

package/dist/dom.d.mts

@@ -14,9 +14,9 @@
  * limitations under the License.
  */
 
-import { J as Deserializer, M as ParsedQueryGeneric, N as QueryObject, ft as Serializer, j as ParsedQuery, y as GenericObject } from "./object-X5fSMx-I.mjs";
-import { F as QueryString } from "./string-C51m7T6d.mjs";
-import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-DPdS2AhM.mjs";
+import { J as Deserializer, M as ParsedQueryGeneric, N as QueryObject, ft as Serializer, j as ParsedQuery, y as GenericObject } from "./object-ahxpI5tD.mjs";
+import { F as QueryString } from "./string-C3g9oBeS.mjs";
+import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-DaIT0NMx.mjs";
 
 //#region src/dom/query.d.ts
 /**

package/dist/dom.mjs

@@ -16,9 +16,8 @@
 
 import { a as isNonEmptyString, d as isString } from "./primitives-Djsevc69.mjs";
 import { j as isValidArray, v as isEmptyObject, w as isNotEmptyObject } from "./specials-Hq5Ncd6y.mjs";
-import { t as isDateLike } from "./guards-BK1QuvFZ.mjs";
-import { I as deepParsePrimitives, n as trimString } from "./basics-CebgkY-n.mjs";
-import { _ as isOriginFileObj, a as flattenObjectKeyValue, d as isCustomFile, f as isCustomFileArray, g as isFileUpload, h as isFileOrBlob, l as parseObjectValues, m as isFileList, p as isFileArray, v as isValidFormData } from "./objectify-CQa8gQib.mjs";
+import { I as deepParsePrimitives, J as isDateLike, n as trimString } from "./basics-Dald7J6c.mjs";
+import { _ as isOriginFileObj, a as flattenObjectKeyValue, d as isCustomFile, f as isCustomFileArray, g as isFileUpload, h as isFileOrBlob, l as parseObjectValues, m as isFileList, p as isFileArray, v as isValidFormData } from "./objectify-BoIZEKOL.mjs";
 
 //#region src/dom/query.ts
 /**

package/dist/{form-Cp1OyCRI.d.cts → form-B91Vb6IK.d.cts}

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { S as KeyForObject, T as NestedKeyString, ri as RequireExactly, u as DotNotationKey, x as KeyForArray } from "./object-X5fSMx-I.cjs";
-import { F as QueryString } from "./string-CO7HP50i.cjs";
+import { S as KeyForObject, T as NestedKeyString, ai as RequireExactly, u as DotNotationKey, x as KeyForArray } from "./object-ahxpI5tD.cjs";
+import { F as QueryString } from "./string-DENMnjFc.cjs";
 
 //#region src/types/form.d.ts
 /** - Configuration options to control FormData generation behavior. */

package/dist/{form-DPdS2AhM.d.mts → form-DaIT0NMx.d.mts}

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { S as KeyForObject, T as NestedKeyString, ri as RequireExactly, u as DotNotationKey, x as KeyForArray } from "./object-X5fSMx-I.mjs";
-import { F as QueryString } from "./string-C51m7T6d.mjs";
+import { S as KeyForObject, T as NestedKeyString, ai as RequireExactly, u as DotNotationKey, x as KeyForArray } from "./object-ahxpI5tD.mjs";
+import { F as QueryString } from "./string-C3g9oBeS.mjs";
 
 //#region src/types/form.d.ts
 /** - Configuration options to control FormData generation behavior. */

package/dist/{guards-B2s2wlVN.mjs → guards-D1et4U32.mjs}

@@ -17,7 +17,7 @@
 import { d as isString, m as isUndefined } from "./primitives-Djsevc69.mjs";
 import { b as isFunction, w as isNotEmptyObject } from "./specials-Hq5Ncd6y.mjs";
 import { a as normalizeNumber } from "./utilities-DPscNbS1.mjs";
-import { G as stableStringify, n as trimString } from "./basics-CebgkY-n.mjs";
+import { G as stableStringify, n as trimString } from "./basics-Dald7J6c.mjs";
 
 //#region src/object/basics.ts
 /**

package/dist/{guards-DMJcjPDt.cjs → guards-D8Iz6EEy.cjs}

@@ -17,7 +17,7 @@
 const require_primitives = require('./primitives-CBGICrDR.cjs');
 const require_specials = require('./specials-dkYP1Nh2.cjs');
 const require_utilities = require('./utilities-CWV1GPGY.cjs');
-const require_basics = require('./basics-CJmdhXoo.cjs');
+const require_basics = require('./basics-Bb5ovcvz.cjs');
 
 //#region src/object/basics.ts
 /**

package/dist/guards.cjs

@@ -18,12 +18,11 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primitives = require('./primitives-CBGICrDR.cjs');
 const require_guards = require('./guards-DGN95D2h.cjs');
 const require_specials = require('./specials-dkYP1Nh2.cjs');
-const require_guards$1 = require('./guards-Bsh6Bfdq.cjs');
-const require_basics = require('./basics-CJmdhXoo.cjs');
-const require_guards$2 = require('./guards-DMJcjPDt.cjs');
+const require_basics = require('./basics-Bb5ovcvz.cjs');
+const require_guards$1 = require('./guards-D8Iz6EEy.cjs');
 
-exports.areInvalidNumbers = require_guards$2.areInvalidNumbers;
-exports.areNumbersInvalid = require_guards$2.areInvalidNumbers;
+exports.areInvalidNumbers = require_guards$1.areInvalidNumbers;
+exports.areNumbersInvalid = require_guards$1.areInvalidNumbers;
 exports.doesReturnPromise = require_specials.isReturningPromise;
 exports.isArray = require_specials.isArray;
 exports.isArrayOfType = require_specials.isArrayOfType;
@@ -34,22 +33,22 @@ exports.isBinaryString = require_specials.isBinaryString;
 exports.isBoolean = require_primitives.isBoolean;
 exports.isBrowser = require_specials.isBrowser;
 exports.isCSSColor = require_guards.isCSSColor;
-exports.isCamelCase = require_guards$2.isCamelCase;
+exports.isCamelCase = require_guards$1.isCamelCase;
 exports.isDate = require_specials.isDate;
-exports.isDateLike = require_guards$1.isDateLike;
+exports.isDateLike = require_basics.isDateLike;
 exports.isDateString = require_specials.isDateString;
 exports.isDeepEqual = require_basics.isDeepEqual;
 exports.isEmail = require_specials.isEmail;
 exports.isEmailArray = require_specials.isEmailArray;
-exports.isEmojiOnly = require_guards$2.isEmojiOnly;
+exports.isEmojiOnly = require_guards$1.isEmojiOnly;
 exports.isEmptyObject = require_specials.isEmptyObject;
 exports.isEnvironment = require_specials.isEnvironment;
 exports.isError = require_specials.isError;
-exports.isEven = require_guards$2.isEven;
-exports.isEvenNumber = require_guards$2.isEven;
+exports.isEven = require_guards$1.isEven;
+exports.isEvenNumber = require_guards$1.isEven;
 exports.isExpectedNodeENV = require_specials.isEnvironment;
 exports.isFalsy = require_primitives.isFalsy;
-exports.isFibonacci = require_guards$2.isFibonacci;
+exports.isFibonacci = require_guards$1.isFibonacci;
 exports.isFunction = require_specials.isFunction;
 exports.isHSL = require_guards.isHSL;
 exports.isHSLA = require_guards.isHSLA;
@@ -58,17 +57,17 @@ exports.isHex8 = require_guards.isHex8;
 exports.isHexString = require_specials.isHexString;
 exports.isIPAddress = require_specials.isIPAddress;
 exports.isInteger = require_primitives.isInteger;
-exports.isInvalidNumber = require_guards$2.areInvalidNumbers;
-exports.isInvalidOrEmptyArray = require_guards$2.isInvalidOrEmptyArray;
+exports.isInvalidNumber = require_guards$1.areInvalidNumbers;
+exports.isInvalidOrEmptyArray = require_guards$1.isInvalidOrEmptyArray;
 exports.isJSON = require_specials.isJSON;
-exports.isKebabCase = require_guards$2.isKebabCase;
-exports.isLeapYear = require_guards$1.isLeapYear;
+exports.isKebabCase = require_guards$1.isKebabCase;
+exports.isLeapYear = require_basics.isLeapYear;
 exports.isMap = require_specials.isMap;
 exports.isMethod = require_specials.isMethodDescriptor;
 exports.isMethodDescriptor = require_specials.isMethodDescriptor;
-exports.isMultiple = require_guards$2.isMultiple;
-exports.isMultipleOf = require_guards$2.isMultiple;
-exports.isNativeTimeZoneId = require_guards$1.isNativeTimeZoneId;
+exports.isMultiple = require_guards$1.isMultiple;
+exports.isMultipleOf = require_guards$1.isMultiple;
+exports.isNativeTimeZoneId = require_basics.isNativeTimeZoneId;
 exports.isNode = require_specials.isNode;
 exports.isNodeENV = require_specials.isEnvironment;
 exports.isNodeEnvironment = require_specials.isEnvironment;
@@ -77,22 +76,22 @@ exports.isNormalPrimitive = require_primitives.isNormalPrimitive;
 exports.isNotEmptyObject = require_specials.isNotEmptyObject;
 exports.isNull = require_primitives.isNull;
 exports.isNumber = require_primitives.isNumber;
-exports.isNumberInvalid = require_guards$2.areInvalidNumbers;
+exports.isNumberInvalid = require_guards$1.areInvalidNumbers;
 exports.isNumericString = require_specials.isNumericString;
 exports.isObject = require_specials.isObject;
 exports.isObjectEmpty = require_specials.isEmptyObject;
 exports.isObjectWithKeys = require_specials.isObjectWithKeys;
-exports.isOdd = require_guards$2.isOdd;
-exports.isOddNumber = require_guards$2.isOdd;
-exports.isPalindrome = require_guards$2.isPalindrome;
-exports.isPartOfFibonacci = require_guards$2.isFibonacci;
-exports.isPartOfFibonacciSeries = require_guards$2.isFibonacci;
-exports.isPascalCase = require_guards$2.isPascalCase;
-exports.isPerfectSquare = require_guards$2.isPerfectSquare;
+exports.isOdd = require_guards$1.isOdd;
+exports.isOddNumber = require_guards$1.isOdd;
+exports.isPalindrome = require_guards$1.isPalindrome;
+exports.isPartOfFibonacci = require_guards$1.isFibonacci;
+exports.isPartOfFibonacciSeries = require_guards$1.isFibonacci;
+exports.isPascalCase = require_guards$1.isPascalCase;
+exports.isPerfectSquare = require_guards$1.isPerfectSquare;
 exports.isPhoneNumber = require_specials.isPhoneNumber;
 exports.isPositiveInteger = require_primitives.isPositiveInteger;
-exports.isPrime = require_guards$2.isPrime;
-exports.isPrimeNumber = require_guards$2.isPrime;
+exports.isPrime = require_guards$1.isPrime;
+exports.isPrimeNumber = require_guards$1.isPrime;
 exports.isPrimitive = require_primitives.isPrimitive;
 exports.isPromise = require_specials.isPromise;
 exports.isRGB = require_guards.isRGB;
@@ -101,10 +100,10 @@ exports.isRegExp = require_specials.isRegExp;
 exports.isRegularExpression = require_specials.isRegExp;
 exports.isReturningPromise = require_specials.isReturningPromise;
 exports.isSet = require_specials.isSet;
-exports.isSnakeCase = require_guards$2.isSnakeCase;
+exports.isSnakeCase = require_guards$1.isSnakeCase;
 exports.isString = require_primitives.isString;
 exports.isSymbol = require_primitives.isSymbol;
-exports.isTimeWithUnit = require_guards$1.isTimeWithUnit;
+exports.isTimeWithUnit = require_basics.isTimeWithUnit;
 exports.isTruthy = require_primitives.isTruthy;
 exports.isURL = require_specials.isURL;
 exports.isUUID = require_specials.isUUID;
@@ -121,9 +120,9 @@ exports.isValidArray = require_specials.isValidArray;
 exports.isValidEmail = require_specials.isEmail;
 exports.isValidJSON = require_specials.isJSON;
 exports.isValidObject = require_specials.isNotEmptyObject;
-exports.isValidTime = require_guards$1.isValidTime;
-exports.isValidTimeString = require_guards$1.isValidTime;
-exports.isValidTimeZoneId = require_guards$1.isValidTimeZoneId;
+exports.isValidTime = require_basics.isValidTime;
+exports.isValidTimeString = require_basics.isValidTime;
+exports.isValidTimeZoneId = require_basics.isValidTimeZoneId;
 exports.isValidURL = require_specials.isURL;
-exports.isValidUTC = require_guards$1.isValidUTCOffset;
-exports.isValidUTCOffset = require_guards$1.isValidUTCOffset;
+exports.isValidUTC = require_basics.isValidUTCOffset;
+exports.isValidUTCOffset = require_basics.isValidUTCOffset;