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