toolbox-x 1.2.1 → 2.0.1

package/dist/{case-BQwn5N-k.mjs → case-DBC4Rj0h.mjs}

@@ -132,11 +132,11 @@ function convertStringCase(value, format, options) {
 			return start.concat(body, end);
 		}
 		case "snake_case": {
-			const body = tokens.map((token) => lowerCase(token)).join("_");
+			const body = tokens.map(lowerCase).join("_");
 			return start.concat(body, end);
 		}
 		case "kebab-case": {
-			const body = tokens.map((token) => lowerCase(token)).join("-");
+			const body = tokens.map(lowerCase).join("-");
 			return start.concat(body, end);
 		}
 		case "Title Case": {
@@ -195,7 +195,7 @@ function _getDelimiterRegex(delims) {
 /** Normalizes delimiters + splits the string */
 function _normalizeDelimiters(str, delims) {
 	const delRegExp = _getDelimiterRegex(delims);
-	return str.replace(/(\p{Ll}?\d+|(?<=\p{Lu}))(\p{Lu})/gu, "$1 $2").replace(delRegExp, " ").replace(/\s+/g, " ").trim().split(" ").filter(Boolean);
+	return str.replace(/(\p{Ll}?\d+|(?<=\p{Lu}|\p{Ll}))(\p{Lu})/gu, "$1 $2").replace(delRegExp, " ").replace(/\s+/g, " ").trim().split(" ").filter(Boolean);
 }
 /** Capitalize a string (first letter capital, rest lowercase) */
 function _capitalize(str) {

package/dist/{case--Vjea9DS.d.cts → case-DFD3Ml1p.d.cts}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { B as TitleCase, I as SentenceCase, L as SnakeCase, M as PascalSnakeCase, N as PathCase, T as DotCase, V as TrainCase, f as CamelCase, g as ConstantCase, j as PascalCase, k as KebabCase, m as CaseFormat, p as CapitalizeOptions, z as StringCaseOptions } from "./string-Dq2b8rcN.cjs";
+import { A as KebabCase, B as StringCaseOptions, E as DotCase, H as TrainCase, L as SentenceCase, M as PascalCase, N as PascalSnakeCase, P as PathCase, R as SnakeCase, V as TitleCase, _ as ConstantCase, h as CaseFormat, m as CapitalizeOptions, p as CamelCase, u as $WidenEmpty } from "./string-BDwBuik3.cjs";
 
 //#region src/string/case.d.ts
 /**
@@ -124,7 +124,7 @@ declare function capitalizeString(string: string, options?: CapitalizeOptions):
  * @param del Additional delimiter characters to recognize.
  * @returns The `camelCase` formatted string.
  */
-declare function toCamelCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): CamelCase<Str, Del>;
+declare function toCamelCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<CamelCase<Str, Del>>;
 /**
  * * Converts a string into `PascalCase`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -145,7 +145,7 @@ declare function toCamelCase<Str extends string, Del extends string = ''>(str: S
  * @param del Additional delimiter characters to recognize.
  * @returns The `PascalCase` formatted string.
  */
-declare function toPascalCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): PascalCase<Str, Del>;
+declare function toPascalCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<PascalCase<Str, Del>>;
 /**
  * * Converts a string into `snake_case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -165,7 +165,7 @@ declare function toPascalCase<Str extends string, Del extends string = ''>(str:
  * @param del Additional delimiter characters to recognize.
  * @returns The `snake_case` formatted string.
  */
-declare function toSnakeCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): SnakeCase<Str, Del>;
+declare function toSnakeCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<SnakeCase<Str, Del>>;
 /**
  * * Converts a string into `kebab-case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -185,7 +185,7 @@ declare function toSnakeCase<Str extends string, Del extends string = ''>(str: S
  * @param del Additional delimiter characters to recognize.
  * @returns The `kebab-case` formatted string.
  */
-declare function toKebabCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): KebabCase<Str, Del>;
+declare function toKebabCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<KebabCase<Str, Del>>;
 /**
  * * Converts a string into `Train-Case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -204,7 +204,7 @@ declare function toKebabCase<Str extends string, Del extends string = ''>(str: S
  * @param del Additional delimiter characters to recognize.
  * @returns The `Train-Case` formatted string.
  */
-declare function toTrainCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): TrainCase<Str, Del>;
+declare function toTrainCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<TrainCase<Str, Del>>;
 /**
  * * Converts a string into `dot.case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -223,7 +223,7 @@ declare function toTrainCase<Str extends string, Del extends string = ''>(str: S
  * @param del Additional delimiter characters to recognize.
  * @returns The `dot.case` formatted string.
  */
-declare function toDotCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): DotCase<Str, Del>;
+declare function toDotCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<DotCase<Str, Del>>;
 /**
  * * Converts a string into `path/case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -242,7 +242,7 @@ declare function toDotCase<Str extends string, Del extends string = ''>(str: Str
  * @param del Additional delimiter characters to recognize.
  * @returns The `path/case` formatted string.
  */
-declare function toPathCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): PathCase<Str, Del>;
+declare function toPathCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<PathCase<Str, Del>>;
 /**
  * * Converts a string into `CONSTANT_CASE`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -261,7 +261,7 @@ declare function toPathCase<Str extends string, Del extends string = ''>(str: St
  * @param del Additional delimiter characters to recognize.
  * @returns The `CONSTANT_CASE` formatted string.
  */
-declare function toConstantCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): ConstantCase<Str, Del>;
+declare function toConstantCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<ConstantCase<Str, Del>>;
 /**
  * * Converts a string into `Pascal_Snake_Case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -280,7 +280,7 @@ declare function toConstantCase<Str extends string, Del extends string = ''>(str
  * @param del Additional delimiter characters to recognize.
  * @returns The `Pascal_Snake_Case` formatted string.
  */
-declare function toPascalSnakeCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): PascalSnakeCase<Str, Del>;
+declare function toPascalSnakeCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<PascalSnakeCase<Str, Del>>;
 /**
  * * Converts a string into `Title Case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -301,7 +301,7 @@ declare function toPascalSnakeCase<Str extends string, Del extends string = ''>(
  * @param del Additional delimiter characters to recognize.
  * @returns The `Title Case` formatted string.
  */
-declare function toTitleCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): TitleCase<Str, Del>;
+declare function toTitleCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<TitleCase<Str, Del>>;
 /**
  * * Converts a string into `Sentence case`, using the optional custom delimiters in addition to the default delimiters.
  *
@@ -322,6 +322,6 @@ declare function toTitleCase<Str extends string, Del extends string = ''>(str: S
  * @param del Additional delimiter characters to recognize.
  * @returns The `Sentence case` formatted string.
  */
-declare function toSentenceCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): SentenceCase<Str, Del>;
+declare function toSentenceCase<Str extends string, Del extends string = ''>(str: Str, ...del: Del[]): $WidenEmpty<SentenceCase<Str, Del>>;
 //#endregion
 export { toDotCase as a, toPascalSnakeCase as c, toSnakeCase as d, toTitleCase as f, toConstantCase as i, toPathCase as l, convertStringCase as n, toKebabCase as o, toTrainCase as p, toCamelCase as r, toPascalCase as s, capitalizeString as t, toSentenceCase as u };

package/dist/change-case.cjs

@@ -15,7 +15,7 @@
  */
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_case = require('./case-uKFzt5TY.cjs');
+const require_case = require('./case-Bd7QLHYw.cjs');
 
 exports.capitalizeString = require_case.capitalizeString;
 exports.convertStringCase = require_case.convertStringCase;

package/dist/change-case.d.cts

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 
-import { a as toDotCase, c as toPascalSnakeCase, d as toSnakeCase, f as toTitleCase, i as toConstantCase, l as toPathCase, n as convertStringCase, o as toKebabCase, p as toTrainCase, r as toCamelCase, s as toPascalCase, t as capitalizeString, u as toSentenceCase } from "./case--Vjea9DS.cjs";
+import { a as toDotCase, c as toPascalSnakeCase, d as toSnakeCase, f as toTitleCase, i as toConstantCase, l as toPathCase, n as convertStringCase, o as toKebabCase, p as toTrainCase, r as toCamelCase, s as toPascalCase, t as capitalizeString, u as toSentenceCase } from "./case-DFD3Ml1p.cjs";
 export { capitalizeString, convertStringCase, toCamelCase, toConstantCase, toDotCase, toKebabCase, toPascalCase, toPascalSnakeCase, toPathCase, toSentenceCase, toSnakeCase, toTitleCase, toTrainCase };

package/dist/change-case.d.mts

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 
-import { a as toDotCase, c as toPascalSnakeCase, d as toSnakeCase, f as toTitleCase, i as toConstantCase, l as toPathCase, n as convertStringCase, o as toKebabCase, p as toTrainCase, r as toCamelCase, s as toPascalCase, t as capitalizeString, u as toSentenceCase } from "./case-KdrBKjjK.mjs";
+import { a as toDotCase, c as toPascalSnakeCase, d as toSnakeCase, f as toTitleCase, i as toConstantCase, l as toPathCase, n as convertStringCase, o as toKebabCase, p as toTrainCase, r as toCamelCase, s as toPascalCase, t as capitalizeString, u as toSentenceCase } from "./case-Bkkm6Mqi.mjs";
 export { capitalizeString, convertStringCase, toCamelCase, toConstantCase, toDotCase, toKebabCase, toPascalCase, toPascalSnakeCase, toPathCase, toSentenceCase, toSnakeCase, toTitleCase, toTrainCase };

package/dist/change-case.mjs

@@ -14,6 +14,6 @@
  * limitations under the License.
  */
 
-import { a as toDotCase, c as toPascalSnakeCase, d as toSnakeCase, f as toTitleCase, i as toConstantCase, l as toPathCase, n as convertStringCase, o as toKebabCase, p as toTrainCase, r as toCamelCase, s as toPascalCase, t as capitalizeString, u as toSentenceCase } from "./case-BQwn5N-k.mjs";
+import { a as toDotCase, c as toPascalSnakeCase, d as toSnakeCase, f as toTitleCase, i as toConstantCase, l as toPathCase, n as convertStringCase, o as toKebabCase, p as toTrainCase, r as toCamelCase, s as toPascalCase, t as capitalizeString, u as toSentenceCase } from "./case-DBC4Rj0h.mjs";
 
 export { capitalizeString, convertStringCase, toCamelCase, toConstantCase, toDotCase, toKebabCase, toPascalCase, toPascalSnakeCase, toPathCase, toSentenceCase, toSnakeCase, toTitleCase, toTrainCase };

package/dist/colors.d.cts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { Jn as Percent } from "./object-ChFVh95z.cjs";
-import { C as RandomColorOptions, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, g as HSLA, h as HSL, l as ColorInputArray, n as $ColorType, t as Color, v as Hex6, x as RGBA, y as Hex8 } from "./Color-Dsut0Bex.cjs";
+import { $n as Percent } from "./object-Mglyg4AW.cjs";
+import { C as RandomColorOptions, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, g as HSLA, h as HSL, l as ColorInputArray, n as $ColorType, t as Color, v as Hex6, x as RGBA, y as Hex8 } from "./Color-BCsnSEmt.cjs";
 
 //#region src/colors/convert.d.ts
 /**

package/dist/colors.d.mts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { Jn as Percent } from "./object-ChFVh95z.mjs";
-import { C as RandomColorOptions, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, g as HSLA, h as HSL, l as ColorInputArray, n as $ColorType, t as Color, v as Hex6, x as RGBA, y as Hex8 } from "./Color-DCfoQk_-.mjs";
+import { $n as Percent } from "./object-Mglyg4AW.mjs";
+import { C as RandomColorOptions, S as RandomColor, T as SolidValues, _ as Hex, a as AlphaValues, b as RGB, g as HSLA, h as HSL, l as ColorInputArray, n as $ColorType, t as Color, v as Hex6, x as RGBA, y as Hex8 } from "./Color-CKmhtXdG.mjs";
 
 //#region src/colors/convert.d.ts
 /**

package/dist/{constants-C4RW7Lei.cjs → constants-Dz5vxNQ9.cjs}

@@ -167,6 +167,37 @@ const MS_MAP = /* @__PURE__ */ Object.freeze((() => {
 		milliseconds: 1
 	};
 })());
+/** Array of relative time divisions */
+const RELATIVE_TIME_DIVISIONS = [
+	{
+		amount: 60,
+		name: "seconds"
+	},
+	{
+		amount: 60,
+		name: "minutes"
+	},
+	{
+		amount: 24,
+		name: "hours"
+	},
+	{
+		amount: 7,
+		name: "days"
+	},
+	{
+		amount: 4.34524,
+		name: "weeks"
+	},
+	{
+		amount: 12,
+		name: "months"
+	},
+	{
+		amount: Number.POSITIVE_INFINITY,
+		name: "years"
+	}
+];
 
 //#endregion
 Object.defineProperty(exports, 'DAYS', {
@@ -187,6 +218,12 @@ Object.defineProperty(exports, 'MS_MAP', {
     return MS_MAP;
   }
 });
+Object.defineProperty(exports, 'RELATIVE_TIME_DIVISIONS', {
+  enumerable: true,
+  get: function () {
+    return RELATIVE_TIME_DIVISIONS;
+  }
+});
 Object.defineProperty(exports, 'SORTED_TIME_FORMATS', {
   enumerable: true,
   get: function () {

package/dist/{constants-rNhoy4DH.mjs → constants-j-iXjwDl.mjs}

@@ -166,6 +166,37 @@ const MS_MAP = /* @__PURE__ */ Object.freeze((() => {
 		milliseconds: 1
 	};
 })());
+/** Array of relative time divisions */
+const RELATIVE_TIME_DIVISIONS = [
+	{
+		amount: 60,
+		name: "seconds"
+	},
+	{
+		amount: 60,
+		name: "minutes"
+	},
+	{
+		amount: 24,
+		name: "hours"
+	},
+	{
+		amount: 7,
+		name: "days"
+	},
+	{
+		amount: 4.34524,
+		name: "weeks"
+	},
+	{
+		amount: 12,
+		name: "months"
+	},
+	{
+		amount: Number.POSITIVE_INFINITY,
+		name: "years"
+	}
+];
 
 //#endregion
-export { VEDIC_ZODIAC_SIGNS as a, SORTED_TIME_FORMATS as i, MONTHS as n, WESTERN_ZODIAC_SIGNS as o, MS_MAP as r, DAYS as t };
+export { SORTED_TIME_FORMATS as a, RELATIVE_TIME_DIVISIONS as i, MONTHS as n, VEDIC_ZODIAC_SIGNS as o, MS_MAP as r, WESTERN_ZODIAC_SIGNS as s, DAYS as t };

package/dist/constants.cjs

@@ -18,7 +18,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_constants = require('./constants-D_HkIg02.cjs');
 const require_css_colors = require('./css-colors-DC7oZ46Y.cjs');
 const require_constants$1 = require('./constants-BOs8tjzp.cjs');
-const require_constants$2 = require('./constants-C4RW7Lei.cjs');
+const require_constants$2 = require('./constants-Dz5vxNQ9.cjs');
 const require_timezone = require('./timezone-CSz7R0L6.cjs');
 const require_constants$3 = require('./constants-B3nc8psr.cjs');
 const require_constants$4 = require('./constants-DIBRCBIP.cjs');

package/dist/constants.d.cts

@@ -15,7 +15,7 @@
  */
 
 import { t as LOWERCASE } from "./constants-C7wERz5m.cjs";
-import { Ci as COUNTRIES, Si as WESTERN_ZODIAC_SIGNS, _i as TIME_ZONE_IDS, bi as MONTHS, ci as CURRENCY_CODES, di as LOCALE_CODES, fi as UNITS$1, gi as TIME_ZONES_NATIVE, hi as TIME_ZONES, li as CURRENCY_LOCALES, mi as NATIVE_TZ_IDS, pi as IANA_TZ_IDS, ui as FRANKFURTER_CURRENCIES, vi as TIME_ZONE_LABELS, xi as VEDIC_ZODIAC_SIGNS, yi as DAYS } from "./object-ChFVh95z.cjs";
+import { Ci as TIME_ZONE_LABELS, Di as WESTERN_ZODIAC_SIGNS, Ei as VEDIC_ZODIAC_SIGNS, Oi as COUNTRIES, Si as TIME_ZONE_IDS, Ti as MONTHS, _i as UNITS$1, bi as TIME_ZONES, gi as LOCALE_CODES, hi as FRANKFURTER_CURRENCIES, mi as CURRENCY_LOCALES, pi as CURRENCY_CODES, vi as IANA_TZ_IDS, wi as DAYS, xi as TIME_ZONES_NATIVE, yi as NATIVE_TZ_IDS } from "./object-Mglyg4AW.cjs";
 import { t as CSS_COLORS } from "./css-colors-Dqz6Bfnp.cjs";
 import { t as UNITS } from "./constants-D8RzBjsL.cjs";
 import { t as HTTP_STATUS_CODES } from "./constants-DNIXgBkz.cjs";

package/dist/constants.d.mts

@@ -15,7 +15,7 @@
  */
 
 import { t as LOWERCASE } from "./constants-C7wERz5m.mjs";
-import { Ci as COUNTRIES, Si as WESTERN_ZODIAC_SIGNS, _i as TIME_ZONE_IDS, bi as MONTHS, ci as CURRENCY_CODES, di as LOCALE_CODES, fi as UNITS$1, gi as TIME_ZONES_NATIVE, hi as TIME_ZONES, li as CURRENCY_LOCALES, mi as NATIVE_TZ_IDS, pi as IANA_TZ_IDS, ui as FRANKFURTER_CURRENCIES, vi as TIME_ZONE_LABELS, xi as VEDIC_ZODIAC_SIGNS, yi as DAYS } from "./object-ChFVh95z.mjs";
+import { Ci as TIME_ZONE_LABELS, Di as WESTERN_ZODIAC_SIGNS, Ei as VEDIC_ZODIAC_SIGNS, Oi as COUNTRIES, Si as TIME_ZONE_IDS, Ti as MONTHS, _i as UNITS$1, bi as TIME_ZONES, gi as LOCALE_CODES, hi as FRANKFURTER_CURRENCIES, mi as CURRENCY_LOCALES, pi as CURRENCY_CODES, vi as IANA_TZ_IDS, wi as DAYS, xi as TIME_ZONES_NATIVE, yi as NATIVE_TZ_IDS } from "./object-Mglyg4AW.mjs";
 import { t as CSS_COLORS } from "./css-colors-Dqz6Bfnp.mjs";
 import { t as UNITS } from "./constants-D8RzBjsL.mjs";
 import { t as HTTP_STATUS_CODES } from "./constants-DNIXgBkz.mjs";

package/dist/constants.mjs

@@ -17,7 +17,7 @@
 import { t as LOWERCASE } from "./constants-B0zJiNqH.mjs";
 import { t as CSS_COLORS } from "./css-colors-B-y4TmeC.mjs";
 import { n as NUMBER_COLOR_PALETTE, t as ALPHABET_COLOR_PALETTE } from "./constants-DCZL77t-.mjs";
-import { a as VEDIC_ZODIAC_SIGNS, n as MONTHS, o as WESTERN_ZODIAC_SIGNS, t as DAYS } from "./constants-rNhoy4DH.mjs";
+import { n as MONTHS, o as VEDIC_ZODIAC_SIGNS, s as WESTERN_ZODIAC_SIGNS, t as DAYS } from "./constants-j-iXjwDl.mjs";
 import { a as TIME_ZONE_IDS, i as TIME_ZONES_NATIVE, n as NATIVE_TZ_IDS, o as TIME_ZONE_LABELS, r as TIME_ZONES, t as IANA_TZ_IDS } from "./timezone-avZ4TvDx.mjs";
 import { a as LOCALE_CODES, i as FRANKFURTER_CURRENCIES, n as CURRENCY_CODES, p as UNITS$1, r as CURRENCY_LOCALES } from "./constants-ZyfpysiQ.mjs";
 import { r as UNITS } from "./constants-ByLTHWQm.mjs";

package/dist/converter.cjs

@@ -97,7 +97,7 @@ var $BaseConverter = class {
 	*
 	* @remarks
 	* - This method is automatically called when the instance is used in a string context.
-	* - For complex and versatile pluralization, please refer to {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/string/pluralizer pluralizer} or {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/Pluralizer Pluralizer Class} instead.
+	* - For complex and versatile pluralization, please refer to {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/string/pluralizer pluralizer} or {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/pluralizer Pluralizer Class} instead.
 	*/
 	toString() {
 		return this.$withPluralUnit();
@@ -177,7 +177,7 @@ var $BaseConverter = class {
 	* @param decimals Number of decimal places for fractional value.
 	* @returns Formatted string with proper unit pluralization.
 	*
-	* @remarks For complex and versatile pluralization, please refer to {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/string/pluralizer pluralizer} or {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/Pluralizer Pluralizer Class} instead.
+	* @remarks For complex and versatile pluralization, please refer to {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/string/pluralizer pluralizer} or {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/pluralizer Pluralizer Class} instead.
 	*/
 	format(decimals = 2) {
 		return this.$withPluralUnit(this.$round(this.value, decimals));

package/dist/converter.d.cts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { it as Numeric } from "./object-ChFVh95z.cjs";
-import { C as $Length, S as $Mass, b as $Time, c as $Unit, f as Converted, t as $Area, w as $Data, x as $Temperature, y as $Volume } from "./area-CcRQ6TfR.cjs";
+import { ct as Numeric } from "./object-Mglyg4AW.cjs";
+import { C as $Length, S as $Mass, b as $Time, c as $Unit, f as Converted, t as $Area, w as $Data, x as $Temperature, y as $Volume } from "./area-CHhwLR12.cjs";
 
 //#region src/converter/Converter.d.ts
 /**

package/dist/converter.d.mts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { it as Numeric } from "./object-ChFVh95z.mjs";
-import { C as $Length, S as $Mass, b as $Time, c as $Unit, f as Converted, t as $Area, w as $Data, x as $Temperature, y as $Volume } from "./area-CvSC96va.mjs";
+import { ct as Numeric } from "./object-Mglyg4AW.mjs";
+import { C as $Length, S as $Mass, b as $Time, c as $Unit, f as Converted, t as $Area, w as $Data, x as $Temperature, y as $Volume } from "./area-DOqFLNcr.mjs";
 
 //#region src/converter/Converter.d.ts
 /**

package/dist/converter.mjs

@@ -96,7 +96,7 @@ var $BaseConverter = class {
 	*
 	* @remarks
 	* - This method is automatically called when the instance is used in a string context.
-	* - For complex and versatile pluralization, please refer to {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/string/pluralizer pluralizer} or {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/Pluralizer Pluralizer Class} instead.
+	* - For complex and versatile pluralization, please refer to {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/string/pluralizer pluralizer} or {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/pluralizer Pluralizer Class} instead.
 	*/
 	toString() {
 		return this.$withPluralUnit();
@@ -176,7 +176,7 @@ var $BaseConverter = class {
 	* @param decimals Number of decimal places for fractional value.
 	* @returns Formatted string with proper unit pluralization.
 	*
-	* @remarks For complex and versatile pluralization, please refer to {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/string/pluralizer pluralizer} or {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/Pluralizer Pluralizer Class} instead.
+	* @remarks For complex and versatile pluralization, please refer to {@link https://toolbox-x.nazmul-nhb.dev/docs/utils/string/pluralizer pluralizer} or {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/pluralizer Pluralizer Class} instead.
 	*/
 	format(decimals = 2) {
 		return this.$withPluralUnit(this.$round(this.value, decimals));

package/dist/date.cjs

@@ -16,11 +16,12 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_primitives = require('./primitives-CBGICrDR.cjs');
+const require_constants = require('./constants-Dz5vxNQ9.cjs');
 const require_timezone = require('./timezone-CSz7R0L6.cjs');
-const require_specials = require('./specials-BM6cx43o.cjs');
-const require_utilities = require('./utilities-CzyXCRHM.cjs');
-const require_guards = require('./guards-ClGDJrQp.cjs');
-const require_parse = require('./parse-DovagZFA.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-BWu3UbOk.cjs');
 
 //#region src/date/utils.ts
 /**
@@ -162,15 +163,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 = require_parse._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}`]();
@@ -204,7 +205,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'`.
@@ -223,7 +224,7 @@ function formatTimePart(time, format) {
 */
 function formatDateRelative(date, format) {
 	const $date = require_parse._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);
@@ -240,6 +241,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;
@@ -255,7 +293,7 @@ function getTimestamp(args, format) {
 		$format = format || "utc";
 	}
 	let date = require_parse._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);
@@ -306,9 +344,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,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.cjs";
+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.cjs";
 
 //#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 };