type LinkTarget = '_self' | '_blank'

/**
 * A link to a URL, used for navigation within components.
 *
 * @example
 * ```tsx
 * import type { Link } from '@wix/editor-react-types';
 *
 * interface MyComponentProps {
 *   link?: Link;
 * }
 * ```
 */
export type Link = {
    /**
     * The link URL. For partial links (see `pageRole`), this is the router prefix
     * (e.g. `https://www.my-site.com/prefix`) rather than a fully resolved URL.
     */
    href?: string
    /**
     * Where this link should open.
     * - `'_self'` — opens in the same page.
     * - `'_blank'` — opens in a new tab.
     */
    target?: LinkTarget
    /** The `rel` attribute of the link. Accepts LinkRel values separated by a space. */
    rel?: string
    /**
     * Page role identifier. Present only on partial links, where only the router prefix is
     * known and the full URL format is owned by the Router/App. Applications can use such
     * links in functions to resolve the complete URL at runtime (e.g. for binding links).
     * Resolved links will not have this field.
     */
    pageRole?: string
}