toolbox-x 1.0.1-rc.4 → 1.1.0

package/README.md

@@ -1,4 +1,4 @@
-# Toolbox-X
+# [Toolbox-X](https://toolbox-x.nazmul-nhb.dev)
 
 > “I solve problems you face daily”
 
@@ -96,7 +96,7 @@ See [Changelog](CHANGELOG.md) for recent updates.
 
 ---
 
-## Signature Utilities
+## Examples
 
 ### 🎨 Professional Color Manipulation
 
@@ -192,17 +192,22 @@ getColorForInitial('Banana', 50); // '#00376E80' (50% opacity)
 ```typescript
 import { createFormData } from 'toolbox-x/dom';
 
-const formData = createFormData({
+const file1 = new File(['file1'], 'file1.txt', { type: 'application/text' });
+const file2 = new File(['file2'], 'file2.txt', { type: 'application/text' });
+
+const user = {
   user: {
     name: ' John Doe ',
     age: 30,
     preferences: { theme: 'dark' }
   },
   files: [file1, file2]
-}, {
+};
+
+const formData = createFormData(user, {
   trimStrings: true,
   lowerCaseValues: ['user.name'],
-  dotNotateNested: ['user.preferences'],
+  dotNotateNested: ['user'],
   breakArray: ['files']
 });
 
@@ -230,10 +235,10 @@ const user = {
  tags: [],
 };
 
-sanitizeData(user, { ignoreNullish: true, ignoreEmpty: true });
+sanitizeData(user, { ignoreFalsy: true, ignoreEmpty: true });
 // Returns { name: "John Doe", address: { city: "NYC" } } with exact input type which may cause issue when accessing missing properties
 
-sanitizeData(user, { ignoreNullish: true, ignoreEmpty: true }, 'partial');
+sanitizeData(user, { ignoreFalsy: true, ignoreEmpty: true }, 'partial');
 // Return type: $DeepPartial<typeof user> safe property access by making all the properties (nested objects/arrays) optional 
 // Returns { name: "John Doe", address: { city: "NYC" } }
 ```

package/dist/{converter-N_3G5KF5.d.cts → area-Cav_1uPb.d.cts}

@@ -17,157 +17,6 @@
 import { Ar as LooseLiteral, Nr as Mutable, i as $Record, it as Numeric } from "./object-D70hzkoY.cjs";
 import { t as UNITS } from "./constants-D8RzBjsL.cjs";
 
-//#region src/converter/base.d.ts
-/**
- * @description Base class providing common mathematical and formatting utilities
- * for all unit converters (time, length, data, temperature, etc.).
- */
-declare class $BaseConverter<Unit extends $Unit> {
-  protected readonly value: number;
-  protected readonly unit: Unit;
-  /**
-   * Convert value to other units
-   * @param value Number or numeric string value to convert.
-   * @param unit Optional base unit for the provided value.
-   */
-  constructor(value: Numeric, unit?: Unit);
-  /** @protected Returns a grammatically correct unit string, prefixed with the number value. */
-  protected $withPluralUnit(value?: number, unit?: $Unit): string;
-  /** @protected Rounds a numeric value to given decimal places. */
-  protected $round(value: number, decimals?: number): number;
-  /**
-   * @protected Shared formatter for all converters.
-   * @param value Converted value (already computed via `.to(target)`).
-   * @param target Target unit name.
-   * @param shortLabels Record of compact unit labels.
-   * @param options Formatting options.
-   * @returns Formatted string according to style (compact, plural, scientific).
-   */
-  protected $formatTo(value: number, target: Unit, shortLabels: Record<Unit, string>, options: FormatToOptions | undefined): string;
-  /**
-   * @instance Returns the numeric value.
-   * @returns The raw numeric value without unit.
-   */
-  valueOf(): number;
-  /**
-   * @instance Returns the numeric value.
-   * @returns The raw numeric value without unit.
-   */
-  getValue(): number;
-  /**
-   * @instance Returns the unit name.
-   * @returns The current unit.
-   */
-  getUnit(): Unit;
-  /**
-   * @instance Returns the original value with formatted pluralized unit.
-   * @returns A string like `"3 hours"` or `"1 minute"` or `"3"` if no unit is provided.
-   *
-   * @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.
-   */
-  toString(): string;
-  /**
-   * @instance Returns a plain object representation.
-   * @returns An object with value and unit.
-   */
-  toObject(): {
-    value: number;
-    unit: Unit;
-  };
-  /**
-   * @instance Converts to JSON representation.
-   * @returns JSON string of `{ value, unit }`.
-   */
-  toJSON(): string;
-  /** @instance Returns a new instance with the absolute value. */
-  abs(): this;
-  /**
-   * @instance Adds a numeric value (same unit assumed).
-   * @returns A new instance with updated value.
-   */
-  add(n: Numeric): this;
-  /**
-   * @instance Subtracts a numeric value (same unit assumed).
-   * @returns A new instance with updated value.
-   */
-  subtract(n: Numeric): this;
-  /**
-   * @instance Multiplies the value.
-   * @returns A new instance with updated value.
-   */
-  multiply(n: Numeric): this;
-  /**
-   * @instance Divides the value.
-   * @returns A new instance with updated value.
-   */
-  divide(n: Numeric): this;
-  /**
-   * @instance Rounds to given decimal places.
-   * @param decimals Number of decimal places to round. Default is `0`.
-   * @returns A new instance with rounded value.
-   */
-  round(decimals?: number): this;
-  /** @instance Returns whether this value is greater than another numeric value. */
-  gt(n: Numeric): boolean;
-  /** @instance Returns whether this value is less than another numeric value. */
-  lt(n: Numeric): boolean;
-  /** @instance Returns whether this value equals another numeric value. */
-  eq(n: Numeric): boolean;
-  /**
-   * @instance Returns a human-friendly formatted string with fixed decimals (if the value is fraction).
-   * @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.
-   */
-  format(decimals?: number): string;
-  /**
-   * @instance Returns all supported units.
-   * @returns Array of supported unit strings.
-   */
-  supportedUnits(): Units;
-  /**
-   * @instance Returns all supported units for a specific category.
-   * @param category Category to filter units by.
-   * @returns Tuple of supported units for the specified category.
-   */
-  supportedUnits<Cat extends Category>(category: Cat): UnitsTuple<Cat>;
-}
-//#endregion
-//#region src/converter/area.d.ts
-/**
- * @class AreaConverter
- * @description Handles conversions with smart `.to()`, `.toAll()`, and `.formatTo()`.
- */
-declare class $Area extends $BaseConverter<$AreaUnit> {
-  #private;
-  /**
-   * Convert area value to other area units
-   * @param value Number or numeric string value to convert.
-   * @param unit Base area unit for the provided value.
-   */
-  constructor(value: Numeric, unit: $AreaUnit);
-  /**
-   * @instance Converts to target area unit.
-   * @param target Target area unit.
-   */
-  to(target: $AreaUnit): number;
-  /**
-   * @instance Converts to all area units.
-   * @returns Object with all unit conversions.
-   */
-  toAll(): $Record<$AreaUnit, number>;
-  /**
-   * @instance Formats the converted value and unit.
-   * @param target Target unit to format to.
-   * @param options Formatting options.
-   * @returns Formatted string like "5km²", "5.02 square-miles", or "5e+3 meter".
-   */
-  formatTo(target: $AreaUnit, options?: FormatToOptions): string;
-}
-//#endregion
 //#region src/converter/data.d.ts
 /**
  * @class DataConverter
@@ -399,4 +248,155 @@ type $TimeUnit = UnitMap['time'];
 /** Union type for all the volume units */
 type $VolumeUnit = UnitMap['volume'];
 //#endregion
-export { $Data as C, $Length as S, UnitsTuple as _, $TempUnit as a, $Temperature as b, $VolumeUnit as c, Converted as d, FormatToOptions as f, UnitsRecord as g, Units as h, $MassUnit as i, Category as l, UnitMap as m, $DataUnit as n, $TimeUnit as o, InferCategory as p, $LengthUnit as r, $Unit as s, $AreaUnit as t, CategoryUnits as u, $Volume as v, $Area as w, $Mass as x, $Time as y };
+//#region src/converter/base.d.ts
+/**
+ * @description Base class providing common mathematical and formatting utilities
+ * for all unit converters (time, length, data, temperature, etc.).
+ */
+declare class $BaseConverter<Unit extends $Unit> {
+  protected readonly value: number;
+  protected readonly unit: Unit;
+  /**
+   * Convert value to other units
+   * @param value Number or numeric string value to convert.
+   * @param unit Optional base unit for the provided value.
+   */
+  constructor(value: Numeric, unit?: Unit);
+  /** @protected Returns a grammatically correct unit string, prefixed with the number value. */
+  protected $withPluralUnit(value?: number, unit?: $Unit): string;
+  /** @protected Rounds a numeric value to given decimal places. */
+  protected $round(value: number, decimals?: number): number;
+  /**
+   * @protected Shared formatter for all converters.
+   * @param value Converted value (already computed via `.to(target)`).
+   * @param target Target unit name.
+   * @param shortLabels Record of compact unit labels.
+   * @param options Formatting options.
+   * @returns Formatted string according to style (compact, plural, scientific).
+   */
+  protected $formatTo(value: number, target: Unit, shortLabels: Record<Unit, string>, options: FormatToOptions | undefined): string;
+  /**
+   * @instance Returns the numeric value.
+   * @returns The raw numeric value without unit.
+   */
+  valueOf(): number;
+  /**
+   * @instance Returns the numeric value.
+   * @returns The raw numeric value without unit.
+   */
+  getValue(): number;
+  /**
+   * @instance Returns the unit name.
+   * @returns The current unit.
+   */
+  getUnit(): Unit;
+  /**
+   * @instance Returns the original value with formatted pluralized unit.
+   * @returns A string like `"3 hours"` or `"1 minute"` or `"3"` if no unit is provided.
+   *
+   * @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.
+   */
+  toString(): string;
+  /**
+   * @instance Returns a plain object representation.
+   * @returns An object with value and unit.
+   */
+  toObject(): {
+    value: number;
+    unit: Unit;
+  };
+  /**
+   * @instance Converts to JSON representation.
+   * @returns JSON string of `{ value, unit }`.
+   */
+  toJSON(): string;
+  /** @instance Returns a new instance with the absolute value. */
+  abs(): this;
+  /**
+   * @instance Adds a numeric value (same unit assumed).
+   * @returns A new instance with updated value.
+   */
+  add(n: Numeric): this;
+  /**
+   * @instance Subtracts a numeric value (same unit assumed).
+   * @returns A new instance with updated value.
+   */
+  subtract(n: Numeric): this;
+  /**
+   * @instance Multiplies the value.
+   * @returns A new instance with updated value.
+   */
+  multiply(n: Numeric): this;
+  /**
+   * @instance Divides the value.
+   * @returns A new instance with updated value.
+   */
+  divide(n: Numeric): this;
+  /**
+   * @instance Rounds to given decimal places.
+   * @param decimals Number of decimal places to round. Default is `0`.
+   * @returns A new instance with rounded value.
+   */
+  round(decimals?: number): this;
+  /** @instance Returns whether this value is greater than another numeric value. */
+  gt(n: Numeric): boolean;
+  /** @instance Returns whether this value is less than another numeric value. */
+  lt(n: Numeric): boolean;
+  /** @instance Returns whether this value equals another numeric value. */
+  eq(n: Numeric): boolean;
+  /**
+   * @instance Returns a human-friendly formatted string with fixed decimals (if the value is fraction).
+   * @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.
+   */
+  format(decimals?: number): string;
+  /**
+   * @instance Returns all supported units.
+   * @returns Array of supported unit strings.
+   */
+  supportedUnits(): Units;
+  /**
+   * @instance Returns all supported units for a specific category.
+   * @param category Category to filter units by.
+   * @returns Tuple of supported units for the specified category.
+   */
+  supportedUnits<Cat extends Category>(category: Cat): UnitsTuple<Cat>;
+}
+//#endregion
+//#region src/converter/area.d.ts
+/**
+ * @class AreaConverter
+ * @description Handles conversions with smart `.to()`, `.toAll()`, and `.formatTo()`.
+ */
+declare class $Area extends $BaseConverter<$AreaUnit> {
+  #private;
+  /**
+   * Convert area value to other area units
+   * @param value Number or numeric string value to convert.
+   * @param unit Base area unit for the provided value.
+   */
+  constructor(value: Numeric, unit: $AreaUnit);
+  /**
+   * @instance Converts to target area unit.
+   * @param target Target area unit.
+   */
+  to(target: $AreaUnit): number;
+  /**
+   * @instance Converts to all area units.
+   * @returns Object with all unit conversions.
+   */
+  toAll(): $Record<$AreaUnit, number>;
+  /**
+   * @instance Formats the converted value and unit.
+   * @param target Target unit to format to.
+   * @param options Formatting options.
+   * @returns Formatted string like "5km²", "5.02 square-miles", or "5e+3 meter".
+   */
+  formatTo(target: $AreaUnit, options?: FormatToOptions): string;
+}
+//#endregion
+export { $Length as C, $Mass as S, UnitsRecord as _, $MassUnit as a, $Time as b, $Unit as c, CategoryUnits as d, Converted as f, Units as g, UnitMap as h, $LengthUnit as i, $VolumeUnit as l, InferCategory as m, $AreaUnit as n, $TempUnit as o, FormatToOptions as p, $DataUnit as r, $TimeUnit as s, $Area as t, Category as u, UnitsTuple as v, $Data as w, $Temperature as x, $Volume as y };

package/dist/{converter-Bj3qKbKV.d.mts → area-DTOvByQG.d.mts}

@@ -17,157 +17,6 @@
 import { Ar as LooseLiteral, Nr as Mutable, i as $Record, it as Numeric } from "./object-D70hzkoY.mjs";
 import { t as UNITS } from "./constants-D8RzBjsL.mjs";
 
-//#region src/converter/base.d.ts
-/**
- * @description Base class providing common mathematical and formatting utilities
- * for all unit converters (time, length, data, temperature, etc.).
- */
-declare class $BaseConverter<Unit extends $Unit> {
-  protected readonly value: number;
-  protected readonly unit: Unit;
-  /**
-   * Convert value to other units
-   * @param value Number or numeric string value to convert.
-   * @param unit Optional base unit for the provided value.
-   */
-  constructor(value: Numeric, unit?: Unit);
-  /** @protected Returns a grammatically correct unit string, prefixed with the number value. */
-  protected $withPluralUnit(value?: number, unit?: $Unit): string;
-  /** @protected Rounds a numeric value to given decimal places. */
-  protected $round(value: number, decimals?: number): number;
-  /**
-   * @protected Shared formatter for all converters.
-   * @param value Converted value (already computed via `.to(target)`).
-   * @param target Target unit name.
-   * @param shortLabels Record of compact unit labels.
-   * @param options Formatting options.
-   * @returns Formatted string according to style (compact, plural, scientific).
-   */
-  protected $formatTo(value: number, target: Unit, shortLabels: Record<Unit, string>, options: FormatToOptions | undefined): string;
-  /**
-   * @instance Returns the numeric value.
-   * @returns The raw numeric value without unit.
-   */
-  valueOf(): number;
-  /**
-   * @instance Returns the numeric value.
-   * @returns The raw numeric value without unit.
-   */
-  getValue(): number;
-  /**
-   * @instance Returns the unit name.
-   * @returns The current unit.
-   */
-  getUnit(): Unit;
-  /**
-   * @instance Returns the original value with formatted pluralized unit.
-   * @returns A string like `"3 hours"` or `"1 minute"` or `"3"` if no unit is provided.
-   *
-   * @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.
-   */
-  toString(): string;
-  /**
-   * @instance Returns a plain object representation.
-   * @returns An object with value and unit.
-   */
-  toObject(): {
-    value: number;
-    unit: Unit;
-  };
-  /**
-   * @instance Converts to JSON representation.
-   * @returns JSON string of `{ value, unit }`.
-   */
-  toJSON(): string;
-  /** @instance Returns a new instance with the absolute value. */
-  abs(): this;
-  /**
-   * @instance Adds a numeric value (same unit assumed).
-   * @returns A new instance with updated value.
-   */
-  add(n: Numeric): this;
-  /**
-   * @instance Subtracts a numeric value (same unit assumed).
-   * @returns A new instance with updated value.
-   */
-  subtract(n: Numeric): this;
-  /**
-   * @instance Multiplies the value.
-   * @returns A new instance with updated value.
-   */
-  multiply(n: Numeric): this;
-  /**
-   * @instance Divides the value.
-   * @returns A new instance with updated value.
-   */
-  divide(n: Numeric): this;
-  /**
-   * @instance Rounds to given decimal places.
-   * @param decimals Number of decimal places to round. Default is `0`.
-   * @returns A new instance with rounded value.
-   */
-  round(decimals?: number): this;
-  /** @instance Returns whether this value is greater than another numeric value. */
-  gt(n: Numeric): boolean;
-  /** @instance Returns whether this value is less than another numeric value. */
-  lt(n: Numeric): boolean;
-  /** @instance Returns whether this value equals another numeric value. */
-  eq(n: Numeric): boolean;
-  /**
-   * @instance Returns a human-friendly formatted string with fixed decimals (if the value is fraction).
-   * @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.
-   */
-  format(decimals?: number): string;
-  /**
-   * @instance Returns all supported units.
-   * @returns Array of supported unit strings.
-   */
-  supportedUnits(): Units;
-  /**
-   * @instance Returns all supported units for a specific category.
-   * @param category Category to filter units by.
-   * @returns Tuple of supported units for the specified category.
-   */
-  supportedUnits<Cat extends Category>(category: Cat): UnitsTuple<Cat>;
-}
-//#endregion
-//#region src/converter/area.d.ts
-/**
- * @class AreaConverter
- * @description Handles conversions with smart `.to()`, `.toAll()`, and `.formatTo()`.
- */
-declare class $Area extends $BaseConverter<$AreaUnit> {
-  #private;
-  /**
-   * Convert area value to other area units
-   * @param value Number or numeric string value to convert.
-   * @param unit Base area unit for the provided value.
-   */
-  constructor(value: Numeric, unit: $AreaUnit);
-  /**
-   * @instance Converts to target area unit.
-   * @param target Target area unit.
-   */
-  to(target: $AreaUnit): number;
-  /**
-   * @instance Converts to all area units.
-   * @returns Object with all unit conversions.
-   */
-  toAll(): $Record<$AreaUnit, number>;
-  /**
-   * @instance Formats the converted value and unit.
-   * @param target Target unit to format to.
-   * @param options Formatting options.
-   * @returns Formatted string like "5km²", "5.02 square-miles", or "5e+3 meter".
-   */
-  formatTo(target: $AreaUnit, options?: FormatToOptions): string;
-}
-//#endregion
 //#region src/converter/data.d.ts
 /**
  * @class DataConverter
@@ -399,4 +248,155 @@ type $TimeUnit = UnitMap['time'];
 /** Union type for all the volume units */
 type $VolumeUnit = UnitMap['volume'];
 //#endregion
-export { $Data as C, $Length as S, UnitsTuple as _, $TempUnit as a, $Temperature as b, $VolumeUnit as c, Converted as d, FormatToOptions as f, UnitsRecord as g, Units as h, $MassUnit as i, Category as l, UnitMap as m, $DataUnit as n, $TimeUnit as o, InferCategory as p, $LengthUnit as r, $Unit as s, $AreaUnit as t, CategoryUnits as u, $Volume as v, $Area as w, $Mass as x, $Time as y };
+//#region src/converter/base.d.ts
+/**
+ * @description Base class providing common mathematical and formatting utilities
+ * for all unit converters (time, length, data, temperature, etc.).
+ */
+declare class $BaseConverter<Unit extends $Unit> {
+  protected readonly value: number;
+  protected readonly unit: Unit;
+  /**
+   * Convert value to other units
+   * @param value Number or numeric string value to convert.
+   * @param unit Optional base unit for the provided value.
+   */
+  constructor(value: Numeric, unit?: Unit);
+  /** @protected Returns a grammatically correct unit string, prefixed with the number value. */
+  protected $withPluralUnit(value?: number, unit?: $Unit): string;
+  /** @protected Rounds a numeric value to given decimal places. */
+  protected $round(value: number, decimals?: number): number;
+  /**
+   * @protected Shared formatter for all converters.
+   * @param value Converted value (already computed via `.to(target)`).
+   * @param target Target unit name.
+   * @param shortLabels Record of compact unit labels.
+   * @param options Formatting options.
+   * @returns Formatted string according to style (compact, plural, scientific).
+   */
+  protected $formatTo(value: number, target: Unit, shortLabels: Record<Unit, string>, options: FormatToOptions | undefined): string;
+  /**
+   * @instance Returns the numeric value.
+   * @returns The raw numeric value without unit.
+   */
+  valueOf(): number;
+  /**
+   * @instance Returns the numeric value.
+   * @returns The raw numeric value without unit.
+   */
+  getValue(): number;
+  /**
+   * @instance Returns the unit name.
+   * @returns The current unit.
+   */
+  getUnit(): Unit;
+  /**
+   * @instance Returns the original value with formatted pluralized unit.
+   * @returns A string like `"3 hours"` or `"1 minute"` or `"3"` if no unit is provided.
+   *
+   * @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.
+   */
+  toString(): string;
+  /**
+   * @instance Returns a plain object representation.
+   * @returns An object with value and unit.
+   */
+  toObject(): {
+    value: number;
+    unit: Unit;
+  };
+  /**
+   * @instance Converts to JSON representation.
+   * @returns JSON string of `{ value, unit }`.
+   */
+  toJSON(): string;
+  /** @instance Returns a new instance with the absolute value. */
+  abs(): this;
+  /**
+   * @instance Adds a numeric value (same unit assumed).
+   * @returns A new instance with updated value.
+   */
+  add(n: Numeric): this;
+  /**
+   * @instance Subtracts a numeric value (same unit assumed).
+   * @returns A new instance with updated value.
+   */
+  subtract(n: Numeric): this;
+  /**
+   * @instance Multiplies the value.
+   * @returns A new instance with updated value.
+   */
+  multiply(n: Numeric): this;
+  /**
+   * @instance Divides the value.
+   * @returns A new instance with updated value.
+   */
+  divide(n: Numeric): this;
+  /**
+   * @instance Rounds to given decimal places.
+   * @param decimals Number of decimal places to round. Default is `0`.
+   * @returns A new instance with rounded value.
+   */
+  round(decimals?: number): this;
+  /** @instance Returns whether this value is greater than another numeric value. */
+  gt(n: Numeric): boolean;
+  /** @instance Returns whether this value is less than another numeric value. */
+  lt(n: Numeric): boolean;
+  /** @instance Returns whether this value equals another numeric value. */
+  eq(n: Numeric): boolean;
+  /**
+   * @instance Returns a human-friendly formatted string with fixed decimals (if the value is fraction).
+   * @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.
+   */
+  format(decimals?: number): string;
+  /**
+   * @instance Returns all supported units.
+   * @returns Array of supported unit strings.
+   */
+  supportedUnits(): Units;
+  /**
+   * @instance Returns all supported units for a specific category.
+   * @param category Category to filter units by.
+   * @returns Tuple of supported units for the specified category.
+   */
+  supportedUnits<Cat extends Category>(category: Cat): UnitsTuple<Cat>;
+}
+//#endregion
+//#region src/converter/area.d.ts
+/**
+ * @class AreaConverter
+ * @description Handles conversions with smart `.to()`, `.toAll()`, and `.formatTo()`.
+ */
+declare class $Area extends $BaseConverter<$AreaUnit> {
+  #private;
+  /**
+   * Convert area value to other area units
+   * @param value Number or numeric string value to convert.
+   * @param unit Base area unit for the provided value.
+   */
+  constructor(value: Numeric, unit: $AreaUnit);
+  /**
+   * @instance Converts to target area unit.
+   * @param target Target area unit.
+   */
+  to(target: $AreaUnit): number;
+  /**
+   * @instance Converts to all area units.
+   * @returns Object with all unit conversions.
+   */
+  toAll(): $Record<$AreaUnit, number>;
+  /**
+   * @instance Formats the converted value and unit.
+   * @param target Target unit to format to.
+   * @param options Formatting options.
+   * @returns Formatted string like "5km²", "5.02 square-miles", or "5e+3 meter".
+   */
+  formatTo(target: $AreaUnit, options?: FormatToOptions): string;
+}
+//#endregion
+export { $Length as C, $Mass as S, UnitsRecord as _, $MassUnit as a, $Time as b, $Unit as c, CategoryUnits as d, Converted as f, Units as g, UnitMap as h, $LengthUnit as i, $VolumeUnit as l, InferCategory as m, $AreaUnit as n, $TempUnit as o, FormatToOptions as p, $DataUnit as r, $TimeUnit as s, $Area as t, Category as u, UnitsTuple as v, $Data as w, $Temperature as x, $Volume as y };