/**
 * @file Themed hyperlink utilities for terminal output. Provides colored
 *   hyperlinks using theme configuration.
 */
import type { LinkOptions } from './types';
/**
 * Create a themed hyperlink for terminal output. The link text is colored using
 * the theme's link color.
 *
 * Note: Most terminals support ANSI color codes but not clickable links. This
 * function colors the text but does not create clickable hyperlinks. For
 * clickable links, use a library like 'terminal-link' separately.
 *
 * @example
 *   ;```ts
 *   import { link } from '@socketsecurity/lib/links/link'
 *
 *   // Use current theme
 *   console.log(link('Documentation', 'https://socket.dev'))
 *
 *   // Override theme
 *   console.log(
 *     link('API Docs', 'https://api.socket.dev', {
 *       theme: 'coana',
 *     }),
 *   )
 *
 *   // Show URL as fallback
 *   console.log(
 *     link('GitHub', 'https://github.com', {
 *       fallback: true,
 *     }),
 *   )
 *   // Output: "GitHub (https://github.com)"
 *   ```
 *
 * @param text - Link text to display.
 * @param url - URL (included in fallback mode)
 * @param options - Link configuration options.
 *
 * @returns Colored link text
 */
export declare function link(text: string, url: string, options?: LinkOptions): string;
/**
 * Create multiple themed links from an array of link specifications.
 *
 * @example
 *   ;```ts
 *   import { links } from '@socketsecurity/lib/links/link'
 *
 *   const formatted = links([
 *     ['Documentation', 'https://socket.dev'],
 *     ['API Reference', 'https://api.socket.dev'],
 *     ['GitHub', 'https://github.com/SocketDev'],
 *   ])
 *
 *   formatted.forEach(link => console.log(link))
 *   ```
 *
 * @param links - Array of [text, url] pairs.
 * @param options - Link configuration options.
 *
 * @returns Array of colored link texts
 */
export declare function links(linkSpecs: Array<[text: string, url: string]>, options?: LinkOptions): string[];
