import { SemVer, Comparator, Range } from '../models';

/**
 * Converts a SemVer to its canonical string representation.
 *
 * @param version - The version to format
 * @returns The version string (e.g., "1.2.3-alpha.1+build.123")
 *
 * @example Format a version to its canonical string
 * ```typescript
 * format(parseVersionStrict('1.2.3')) // => '1.2.3'
 * format(createSemVer({ major: 1, minor: 0, patch: 0, prerelease: ['beta', '1'] }))
 * // => '1.0.0-beta.1'
 * ```
 */
declare function format(version: SemVer): string;
/**
 * Converts a SemVer to a string without prerelease/build.
 *
 * @param version - The version to format
 * @returns The version string (e.g., "1.2.3")
 *
 * @example Format version without prerelease/build metadata
 * ```typescript
 * formatSimple(parseVersionStrict('1.2.3-beta.1+build')) // => '1.2.3'
 * ```
 */
declare function formatSimple(version: SemVer): string;
/**
 * Converts a Range to its string representation.
 *
 * @param range - The range to format
 * @returns The range string
 *
 * @example Format a range to its string representation
 * ```typescript
 * formatRange(parseRangeStrict('^1.0.0')) // => '^1.0.0'
 * formatRange(createAnyRange()) // => '*'
 * ```
 */
declare function formatRange(range: Range): string;
/**
 * Converts a Comparator to its string representation.
 *
 * @param comparator - The comparator to format
 * @returns The comparator string (e.g., ">=1.0.0")
 *
 * @example Format a comparator to its string representation
 * ```typescript
 * formatComparator(createComparator('>=', parseVersionStrict('1.0.0')))
 * // => '>=1.0.0'
 * ```
 */
declare function formatComparator(comparator: Comparator): string;

export { format, formatComparator, formatRange, formatSimple };