toolbox-x 1.2.1 → 2.0.1

package/dist/date.d.mts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { $ as Maybe, Dt as ClockTime, Gt as ISODateTimeString, Ht as HourMinutes, Ot as DateArgs, Sn as UTCOffset, Vt as GreetingConfigs, Wt as ISODateFormat, an as SafeFormat, bn as TimestampOptions, bt as $TimeZoneIdentifier, cn as TimeOnlyFormat, fn as TimeWithUnit, gn as TimeZoneIdNative, it as Numeric, kt as DateFormatOptions, mn as TimeZoneDetails } from "./object-ChFVh95z.mjs";
+import { Dn as UTCOffset, Gt as GreetingConfigs, Jt as ISODateFormat, Kt as HourMinutes, Mt as DateArgs, Nt as DateFormatOptions, 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-Mglyg4AW.mjs";
 
 //#region src/date/greet.d.ts
 /**
@@ -129,8 +129,8 @@ declare function getTimeZoneIds(offset: UTCOffset): TimeZoneIdNative[];
  * - The default format is `'dd, mmm DD, YYYY HH:mm:ss'` (e.g., `'Sun, Apr 06, 2025 16:11:55'`).
  * - By default, local time is used; set `useUTC` to `true` to format in UTC.
  * - The format string supports various tokens for date and time components, as well as literal text enclosed in square brackets.
- * - See {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/date/formatDate#format-tokens format tokens} for details on supported tokens.
- * - For more complex date/time manipulations, consider using the {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/Chronos Chronos} class.
+ * - See {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/date-time/format-date#format-tokens format tokens} for details on supported tokens.
+ * - For more complex date/time manipulations, consider using the {@link https://chronos.nazmul-nhb.dev/docs/ chronos-date} library.
  *
  * @returns Date/time string in specified format.
  */
@@ -157,7 +157,7 @@ declare function formatDate(options?: DateFormatOptions): string;
  */
 declare function formatTimePart(time: string, format?: TimeOnlyFormat): string;
 /**
- * * Formats a date as a relative time string (e.g., "5m ago", "2h from now").
+ * * Formats a date as a relative time string (e.g., `"5m ago"`, `"2h from now"`).
  *
  * @param date - The date to format, which can be a `Date` object, a date string, or a timestamp number.
  * @param format - Optional format string for dates older than 7 days. Defaults to `'mmm D, yyyy hh:mm a'`.
@@ -175,6 +175,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 +227,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 { 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

@@ -15,11 +15,12 @@
  */
 
 import { m as isUndefined } from "./primitives-Djsevc69.mjs";
+import { i as RELATIVE_TIME_DIVISIONS } from "./constants-j-iXjwDl.mjs";
 import { n as NATIVE_TZ_IDS } from "./timezone-avZ4TvDx.mjs";
-import { T as isObject } from "./specials-Cye93-uo.mjs";
-import { a as normalizeNumber } from "./utilities-B9axOvOX.mjs";
-import { a as isValidTime, s as isValidUTCOffset } from "./guards-C0smSAKC.mjs";
-import { a as _normalizeOffset, i as _gmtToUtcOffset, n as _dateArgsToDate, o as _resolveNativeTzName, r as _formatDate, t as parseMSec } from "./parse-BhZ6-tKg.mjs";
+import { 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-CNDdS-sy.mjs";
 
 //#region src/date/utils.ts
 /**
@@ -161,15 +162,15 @@ function getTimeZoneIds(offset) {
 * - The default format is `'dd, mmm DD, YYYY HH:mm:ss'` (e.g., `'Sun, Apr 06, 2025 16:11:55'`).
 * - By default, local time is used; set `useUTC` to `true` to format in UTC.
 * - The format string supports various tokens for date and time components, as well as literal text enclosed in square brackets.
-* - See {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/date/formatDate#format-tokens format tokens} for details on supported tokens.
-* - For more complex date/time manipulations, consider using the {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/Chronos Chronos} class.
+* - See {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/date-time/format-date#format-tokens format tokens} for details on supported tokens.
+* - For more complex date/time manipulations, consider using the {@link https://chronos.nazmul-nhb.dev/docs/ chronos-date} library.
 *
 * @returns Date/time string in specified format.
 */
 function formatDate(options) {
 	const { date = /* @__PURE__ */ new Date(), format = "dd, mmm DD, YYYY HH:mm:ss", useUTC = false } = options ?? {};
 	const $date = _dateArgsToDate(date);
-	if (isNaN($date.getTime())) return "Invalid Date!";
+	if (Number.isNaN($date.getTime())) return "Invalid Date!";
 	/** Get unit value for {@link $date} for specific unit in local or UTC time */
 	const _getUnitValue = (suffix) => {
 		return useUTC ? $date[`getUTC${suffix}`]() : $date[`get${suffix}`]();
@@ -203,7 +204,7 @@ function formatTimePart(time, format) {
 	});
 }
 /**
-* * Formats a date as a relative time string (e.g., "5m ago", "2h from now").
+* * Formats a date as a relative time string (e.g., `"5m ago"`, `"2h from now"`).
 *
 * @param date - The date to format, which can be a `Date` object, a date string, or a timestamp number.
 * @param format - Optional format string for dates older than 7 days. Defaults to `'mmm D, yyyy hh:mm a'`.
@@ -222,7 +223,7 @@ function formatTimePart(time, format) {
 */
 function formatDateRelative(date, format) {
 	const $date = _dateArgsToDate(date);
-	if (isNaN($date.getTime())) return "Invalid Date!";
+	if (Number.isNaN($date.getTime())) return "Invalid Date!";
 	const now = Date.now();
 	const then = $date.getTime();
 	const diff = Math.abs(now - then);
@@ -239,6 +240,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;
@@ -254,7 +292,7 @@ function getTimestamp(args, format) {
 		$format = format || "utc";
 	}
 	let date = _dateArgsToDate($value);
-	if (isNaN(date.getTime())) date = /* @__PURE__ */ new Date();
+	if (Number.isNaN(date.getTime())) date = /* @__PURE__ */ new Date();
 	if ($format === "local") {
 		const offsetMins = date.getTimezoneOffset();
 		const localDate = /* @__PURE__ */ new Date(date.getTime() - offsetMins * 6e4);
@@ -295,4 +333,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 { 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

@@ -16,11 +16,10 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primitives = require('./primitives-CBGICrDR.cjs');
-const require_specials = require('./specials-BM6cx43o.cjs');
-const require_guards = require('./guards-ClGDJrQp.cjs');
-const require_basics = require('./basics-K8BDSYD6.cjs');
-const require_objectify = require('./objectify-DewBSJP_.cjs');
-const require_utils = require('./utils-BxguWSoa.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');
 
 //#region src/dom/query.ts
 /**
@@ -80,7 +79,7 @@ function parseQueryString(query, parsePrimitives = true) {
 	for (const [key, value] of params.entries()) if (key in entries) {
 		const current = entries[key];
 		const array = Array.isArray(current) ? [...current, value] : [current, value];
-		entries[key] = parsePrimitives ? require_utils.deepParsePrimitives(array) : array;
+		entries[key] = parsePrimitives ? require_basics.deepParsePrimitives(array) : array;
 	} else entries[key] = value;
 	return parsePrimitives ? require_objectify.parseObjectValues(entries) : entries;
 }

package/dist/dom.d.cts

@@ -14,9 +14,9 @@
  * limitations under the License.
  */
 
-import { A as ParsedQuery, G as Deserializer, M as QueryObject, ct as Serializer, j as ParsedQueryGeneric, y as GenericObject } from "./object-ChFVh95z.cjs";
-import { P as QueryString } from "./string-Dq2b8rcN.cjs";
-import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-mP-nl8EC.cjs";
+import { J as Deserializer, M as ParsedQueryGeneric, N as QueryObject, ft as Serializer, j as ParsedQuery, y as GenericObject } from "./object-Mglyg4AW.cjs";
+import { F as QueryString } from "./string-BDwBuik3.cjs";
+import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-CC9T9WnX.cjs";
 
 //#region src/dom/query.d.ts
 /**

package/dist/dom.d.mts

@@ -14,9 +14,9 @@
  * limitations under the License.
  */
 
-import { A as ParsedQuery, G as Deserializer, M as QueryObject, ct as Serializer, j as ParsedQueryGeneric, y as GenericObject } from "./object-ChFVh95z.mjs";
-import { P as QueryString } from "./string-CkwTVFeL.mjs";
-import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-DoQGMTOc.mjs";
+import { J as Deserializer, M as ParsedQueryGeneric, N as QueryObject, ft as Serializer, j as ParsedQuery, y as GenericObject } from "./object-Mglyg4AW.mjs";
+import { F as QueryString } from "./string-_1ImwUJT.mjs";
+import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "./form-CheKmgjj.mjs";
 
 //#region src/dom/query.d.ts
 /**

package/dist/dom.mjs

@@ -15,11 +15,10 @@
  */
 
 import { a as isNonEmptyString, d as isString } from "./primitives-Djsevc69.mjs";
-import { j as isValidArray, v as isEmptyObject, w as isNotEmptyObject } from "./specials-Cye93-uo.mjs";
-import { t as isDateLike } from "./guards-C0smSAKC.mjs";
-import { n as trimString } from "./basics-1_M7UvCn.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-DEnFpPt1.mjs";
-import { a as deepParsePrimitives } from "./utils-DXovsTKs.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";
 
 //#region src/dom/query.ts
 /**

package/dist/{form-DoQGMTOc.d.mts → form-CC9T9WnX.d.cts}

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { $r as RequireExactly, S as KeyForObject, T as NestedKeyString, u as DotNotationKey, x as KeyForArray } from "./object-ChFVh95z.mjs";
-import { P as QueryString } from "./string-CkwTVFeL.mjs";
+import { S as KeyForObject, T as NestedKeyString, ii as RequireExactly, u as DotNotationKey, x as KeyForArray } from "./object-Mglyg4AW.cjs";
+import { F as QueryString } from "./string-BDwBuik3.cjs";
 
 //#region src/types/form.d.ts
 /** - Configuration options to control FormData generation behavior. */

package/dist/{form-mP-nl8EC.d.cts → form-CheKmgjj.d.mts}

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { $r as RequireExactly, S as KeyForObject, T as NestedKeyString, u as DotNotationKey, x as KeyForArray } from "./object-ChFVh95z.cjs";
-import { P as QueryString } from "./string-Dq2b8rcN.cjs";
+import { S as KeyForObject, T as NestedKeyString, ii as RequireExactly, u as DotNotationKey, x as KeyForArray } from "./object-Mglyg4AW.mjs";
+import { F as QueryString } from "./string-_1ImwUJT.mjs";
 
 //#region src/types/form.d.ts
 /** - Configuration options to control FormData generation behavior. */