import * as react from 'react';
import { HTMLAttributes, ReactNode } from 'react';

interface PullQuoteProps extends Omit<HTMLAttributes<HTMLQuoteElement>, "cite"> {
    /** Who said it. Rendered in a `<cite>`. */
    attribution?: ReactNode;
    /** Where it is from — publication, page, role. Follows the attribution. */
    source?: ReactNode;
    /** URL the quote came from. Becomes the `<blockquote cite>` attribute. */
    citeUrl?: string;
    /** Rule-bracketed treatment: hairlines above and below. Default `false`. */
    rule?: boolean;
    children?: ReactNode;
}

/**
 * A pull quote — the oversized line lifted out of body copy, with optional
 * attribution and a rule-bracketed treatment.
 *
 * Twelve gallery styles build one. The reason this is a component rather than a
 * class is the same reason `<Kbd>` renders a real `<kbd>`: of the eight quote
 * elements in those styles, **one** was a `<blockquote>` — five were `<p>` and
 * two were `<div>` — and **none** used `<cite>` for the attribution. They all
 * look right and none of them says what it is.
 *
 * `citeUrl` maps to `<blockquote cite>`, which is the attribute's actual job
 * (the source URL) and is routinely confused with the visible `<cite>` element
 * (the work's title). Keeping them as separate props stops the two collapsing
 * into one another.
 */
declare const PullQuote: react.ForwardRefExoticComponent<PullQuoteProps & react.RefAttributes<HTMLQuoteElement>>;

export { PullQuote, type PullQuoteProps };