export interface Hyperlink {
    /** Cell or range the hyperlink covers — "A1" or "A1:B5". */
    ref: string;
    /** External URL or relative target path. Mutually exclusive with `location`-only links. */
    target?: string;
    /** Anchor inside the workbook (e.g. `'Sheet 2'!A1`). */
    location?: string;
    /** Tooltip shown on hover. */
    tooltip?: string;
    /** Visible link text — typically falls back to the referenced cell value. */
    display?: string;
    /** Worksheet-rels rId. Populated on read; assigned by the writer when missing. */
    rId?: string;
}
export declare function makeHyperlink(opts: Partial<Hyperlink> & {
    ref: string;
}): Hyperlink;
import type { Worksheet } from './worksheet';
/**
 * Add an external URL hyperlink to a cell or range. The URL goes into the
 * worksheet rels as a hyperlink relationship; the writer generates an rId on
 * save.
 */
export declare const addUrlHyperlink: (ws: Worksheet, ref: string, url: string, opts?: {
    tooltip?: string;
    display?: string;
}) => Hyperlink;
/**
 * Add an in-workbook jump hyperlink (e.g. to `'Sheet2'!A1` or a defined-name).
 * No rels entry is written — the location is inline in the `<hyperlink
 * location="…"/>` attribute.
 */
export declare const addInternalHyperlink: (ws: Worksheet, ref: string, location: string, opts?: {
    tooltip?: string;
    display?: string;
}) => Hyperlink;
/** `mailto:` shortcut. */
export declare const addMailtoHyperlink: (ws: Worksheet, ref: string, email: string, opts?: {
    subject?: string;
    tooltip?: string;
    display?: string;
}) => Hyperlink;