/**
 * Video addresses (#454): recognise YouTube and Vimeo links, and build the
 * page a reader is sent to (the QR code, the PDF link) and the player a
 * screen output embeds.
 */
import type { Resource, ResolvedVideoPlayerOptions, VideoSource } from '../types.js';
/** A YouTube or Vimeo video recognised from a link. */
export interface ParsedVideoUrl {
    source: Exclude<VideoSource, 'file'>;
    /** The video id: 11 characters on YouTube, digits on Vimeo. */
    id: string;
    /** Vimeo's privacy hash of an unlisted video (`vimeo.com/123/abc`,
     *  `player.vimeo.com/video/123?h=abc`). */
    hash?: string;
    /** Start time in whole seconds (`t=90`, `t=1m30s`, `#t=90s`). */
    start?: number;
}
/** Recognise a YouTube or Vimeo link: watch pages, short links, Shorts,
 *  embeds (youtube-nocookie too), Vimeo channel, group and showcase pages
 *  and unlisted links. A bare host-less id is not accepted. */
export declare function parseVideoUrl(input: string | undefined): ParsedVideoUrl | undefined;
/** The page of a YouTube or Vimeo video, the address printed in its QR code
 *  and linked from the PDF, starting at `start` seconds. */
export declare function videoWatchUrl(parsed: ParsedVideoUrl, start?: number): string;
/** The address a reader of a printed page is sent to for a video resource:
 *  the YouTube or Vimeo page, or the production address of a self-hosted
 *  file (`video.url`). `undefined` when there is none (a file not
 *  published yet, a link that is neither YouTube nor Vimeo is still
 *  returned as written when it is an http(s) address). */
export declare function resourceVideoLink(resource: Resource): string | undefined;
/** The `src` of the YouTube or Vimeo player for a video, with the player
 *  options the platform honours: controls, autoplay (muted, as browsers
 *  require), loop, start and end, privacy-enhanced mode (youtube-nocookie,
 *  Vimeo `dnt`) and, on Vimeo, the speed and picture-in-picture buttons.
 *  Download is never offered by the embedded players. */
export declare function videoEmbedUrl(parsed: ParsedVideoUrl, player: ResolvedVideoPlayerOptions, range?: {
    start?: number;
    end?: number;
}): string;
/** The `allow` attribute of a YouTube or Vimeo `<iframe>`: what the player
 *  may use. */
export declare function videoEmbedAllow(player: ResolvedVideoPlayerOptions): string;
/** The attributes of an HTML5 `<video>` element for the player options, in
 *  the order they are written: `controls`, `controlslist` (the buttons the
 *  browser hides: `nodownload`, `nofullscreen`, `noremoteplayback`,
 *  `noplaybackrate`), `disablepictureinpicture`, `disableremoteplayback`,
 *  `autoplay`, `muted`, `loop`, `playsinline`, `preload`, and
 *  `data-pt-alongside` for a video that is not `exclusive`. Each value is
 *  `true` for a boolean attribute. */
export declare function videoElementAttributes(player: ResolvedVideoPlayerOptions): Array<[string, string | true]>;
/** A media fragment (`#t=10,40`) that plays a self-hosted file from `start`
 *  to `end` seconds; empty when neither is set. */
export declare function mediaFragment(range: {
    start?: number;
    end?: number;
}): string;
/** The media type of an HLS playlist (`.m3u8`, format `hls`). */
export declare const HLS_MIME_TYPE = "application/vnd.apple.mpegurl";
/** The media type of a self-hosted video by its format (`mp4`, `webm`,
 *  `hls`…). */
export declare function videoMimeType(format: string | undefined): string;
/** The format of a video at a web address, by the extension of its path
 *  (`.m3u8` is an HLS stream, `hls`); undefined when the path does not
 *  tell (no extension, or one that is no video). */
export declare function videoFormatOfUrl(url: string | undefined): string | undefined;
/** The format a self-hosted video plays in: its `format`, else the one its
 *  address tells (`videoFormatOfUrl`), else `mp4`. */
export declare function resourceVideoFormat(video: {
    format?: string;
    url?: string;
} | undefined): string;
/** Whether a media type is an HLS playlist (`.m3u8`): Safari plays one in
 *  a `<video>` natively, other browsers through Media Source Extensions
 *  (hls.js). */
export declare function isHlsMimeType(mimeType: string | undefined): boolean;
/** YouTube's poster frames for a video, largest first: `maxresdefault`
 *  (1280×720, not every video has one), `sddefault` and `hqdefault` (4:3,
 *  letterboxed). Hosts fetch the first that exists. */
export declare function youtubePosterUrls(id: string): string[];
//# sourceMappingURL=url.d.ts.map