import { PackageJsonData } from "../config/package-json.mjs";
//#region src/core/cli/help-links.d.ts
/**
 * OSC 8 hyperlink targets for the root-help header.
 *
 * Set via `CLIBuilder.links()`; fields left `undefined` are derived from
 * package.json metadata when `.packageJson()` is active.
 */
interface HelpLinks {
  /** URL the program name links to (e.g. the repository or homepage). */
  readonly name: string | undefined;
  /** URL the version links to (e.g. the release tag). */
  readonly version: string | undefined;
}
/**
 * Fill `undefined` link fields from package.json metadata.
 *
 * Explicit URLs always win. The name falls back to the normalized
 * `repository` URL, then `homepage`; the version falls back to the forge
 * release-tag URL when both a repository and a version are known.
 * Idempotent — already-resolved fields pass through unchanged.
 *
 * @internal
 */
declare function deriveHelpLinks(links: HelpLinks | undefined, pkg: PackageJsonData | undefined, version: string | undefined): HelpLinks | undefined;
//#endregion
export { type HelpLinks, deriveHelpLinks };