import type { DateDurationUnit } from "../../types/index.js";
/**
 * Return the largest DateDurationUnit from the provided array.
 *
 * - Returns the largest unit based on Temporal's unit order: years > months > weeks > days.
 * - Defaults to "days" if no valid unit is found in the array.
 *
 * @param units array of DateDurationUnits to evaluate
 * @returns the largest DateDurationUnit found in the array, or "days" if none are valid
 *
 * @example getLargestDateDurationUnit(["months", "days"]) // "months"
 * @example getLargestDateDurationUnit(["weeks", "days"]) // "weeks"
 * @example getLargestDateDurationUnit(["days"]) // "days"
 * @example getLargestDateDurationUnit([]) // "days"
 */
export declare function getLargestDateDurationUnit(units: DateDurationUnit[]): DateDurationUnit;