/**
 * Package version and metadata detection utilities.
 *
 * Provides functions to locate and read `package.json` files by walking up the
 * directory tree, extracting version strings, and gathering package metadata
 * (homepage, repository URLs) for automatic epilog generation in help output.
 *
 * @packageDocumentation
 */
/**
 * Package info extracted from `package.json` for epilog generation.
 */
interface PackageInfo {
    homepage?: string;
    repository?: string;
}
/**
 * Detect version: use provided version or read from nearest package.json.
 * Starts from the entry script's real location (resolving symlinks) by
 * default.
 *
 * @function
 */
export declare const detectVersion: (providedVersion?: string, startDir?: string) => Promise<string | undefined>;
/**
 * Detect version synchronously: use provided version or read from nearest
 * package.json. Starts from the entry script's real location (resolving
 * symlinks) by default.
 *
 * @function
 */
export declare const detectVersionSync: (providedVersion?: string, startDir?: string) => string | undefined;
/**
 * Read package info (homepage, repository) from package.json synchronously.
 * Returns only HTTPS URLs; other URL schemes are omitted.
 *
 * @function
 */
export declare const readPackageInfoSync: (startDir?: string) => PackageInfo;
export {};
//# sourceMappingURL=version.d.ts.map