import type Accessor from "../../core/Accessor.js";
import type { Area, Length, RotationType, Volume } from "../../core/quantity.js";
import type { AngleUnit } from "../../core/units.js";

/** @internal */
export interface QuantityFormatterProperties {}

/**
 * The format to use for the quantity.
 *
 * @internal
 */
export type FormattingStyle = "singular" | "plural" | "abbr";

/**
 * Class which has methods to format quantities like lengths and areas. To be used in components until we have a public
 * API for unit conversion and formatting.
 *
 * @internal
 */
export default class QuantityFormatter extends Accessor {
  constructor(properties?: QuantityFormatterProperties);
  /**
   * Formats an angle quantity to degrees. Absolute angles are always formatted in the domain [0, 360).
   *
   * @param angle - Angle to be formatted.
   * @param unit - Unit of the original angle.
   * @param rotationType - The rotation type of the original angle.
   * @param preferredType - The preferred type of the resulting formatted angle.
   * @param precision - Precision to be used when formatting values.
   * @returns The formatted angle.
   */
  formatAngleDegrees(angle: number, unit: AngleUnit, rotationType: RotationType, preferredType: RotationType, precision?: number | null | undefined): string;
  /**
   * Formats an area quantity to a string.
   *
   * @param quantity - The quantity to format.
   * @param precision - The number of decimal places to include in the formatted string.
   * @param format - The format to use for the quantity.
   * @returns The formatted quantity.
   */
  formatArea(quantity: Area, precision?: number, format?: FormattingStyle): string;
  /**
   * Formats any quantity to a string.
   *
   * @param quantity - The quantity to format.
   * @param precision - The number of decimal places to include in the formatted string.
   * @param format - The format to use for the quantity.
   * @returns The formatted quantity.
   */
  formatDecimal(quantity: Length | Area, precision?: number, format?: FormattingStyle): string;
  /**
   * Formats a length quantity to a string.
   *
   * @param quantity - The quantity to format.
   * @param precision - The number of decimal places to include in the formatted string.
   * @param format - The format to use for the quantity.
   * @returns The formatted length quantity.
   */
  formatLength(quantity: Length, precision?: number, format?: FormattingStyle): string;
  /**
   * Formats a vertical length quantity (e.g. elevation) to a string.
   *
   * @param quantity - The quantity to format.
   * @param precision - The number of decimal places to include in the formatted string.
   * @param format - The format to use for the quantity.
   * @returns The formatted quantity.
   */
  formatVerticalLength(quantity: Length, precision?: number, format?: FormattingStyle): string;
  /**
   * Formats a volume quantity to a string.
   *
   * @param quantity - The quantity to format.
   * @param precision - The number of decimal places to include in the formatted string.
   * @param format - The format to use for the quantity.
   * @returns The formatted quantity.
   */
  formatVolume(quantity: Volume, precision?: number, format?: FormattingStyle): string;
  /**
   * Returns a promise that resolves when the messages are loaded.
   *
   * @returns A promise that resolves when the messages are loaded.
   */
  when(): Promise<void>;
}