import type { FetchResult, MediaSource, SmartVideoOptions, YoutubeEmbedOptions, YoutubeThumbnailQuality } from "../../types/index.js";
/**
 * Extracts a YouTube video id from a watch / shorts / live / embed /
 * `youtu.be` URL or a bare 11-char id. Returns `null` when not matched.
 *
 * @param input - URL or bare video id.
 * @returns The 11-char video id or `null`.
 *
 * @example
 * ```ts
 * useGetYoutubeVideoId("https://www.youtube.com/watch?v=dQw4w9WgXcQ"); // "dQw4w9WgXcQ"
 * useGetYoutubeVideoId("https://youtu.be/dQw4w9WgXcQ"); // "dQw4w9WgXcQ"
 * useGetYoutubeVideoId("dQw4w9WgXcQ"); // "dQw4w9WgXcQ"
 * ```
 */
export declare function useGetYoutubeVideoId(input: string): string | null;
/**
 * Extracts a Vimeo video id from a URL or bare numeric id.
 *
 * @param input - URL or bare numeric id.
 * @returns The numeric id or `null`.
 */
export declare function useGetVimeoVideoId(input: string): string | null;
/**
 * Normalizes any supported input into a {@link MediaSource}.
 * Pure and SSR-safe: no DOM, no fetch.
 *
 * @param input - YouTube/Vimeo URL or id, or direct video file URL.
 * @returns Normalized `{ provider, id, raw }`.
 *
 * @example
 * ```ts
 * useParseMediaSource("https://youtu.be/dQw4w9WgXcQ");
 * // { provider: "youtube", id: "dQw4w9WgXcQ", raw: "…" }
 * ```
 */
export declare function useParseMediaSource(input: string): MediaSource;
/**
 * Builds the privacy-enhanced YouTube embed URL (`youtube-nocookie`).
 *
 * @param videoId - 11-char YouTube video id.
 * @param options - Player options (start/end/autoplay/extra params).
 * @returns Embed URL ready for `<iframe src>`.
 */
export declare function useBuildYoutubeEmbedUrl(videoId: string, options?: YoutubeEmbedOptions): string;
/**
 * Builds the Vimeo player embed URL with privacy defaults.
 *
 * @param videoId - Numeric Vimeo video id.
 * @returns Player URL ready for `<iframe src>`.
 */
export declare function useBuildVimeoEmbedUrl(videoId: string): string;
/**
 * Builds the public YouTube thumbnail URL (no API key needed).
 *
 * @param videoId - 11-char YouTube video id.
 * @param quality - Thumbnail quality (defaults to `hqdefault`).
 * @returns Thumbnail image URL.
 */
export declare function useBuildYoutubeThumbnail(videoId: string, quality?: YoutubeThumbnailQuality): string;
/**
 * Validates unknown input (parsed JSON, frontmatter, CMS payloads) against
 * the `SmartVideoOptions` schema. Returns a Safe Result instead of throwing.
 *
 * @param input - Unknown value to validate.
 * @returns `FetchResult<SmartVideoOptions>` with typed options or a `Validation Error`.
 *
 * @example
 * ```ts
 * const result = useParseSmartVideoOptions(JSON.parse(raw));
 * if (result.ok) useBuildVideoEmbed(result.data);
 * ```
 */
export declare function useParseSmartVideoOptions(input: unknown): FetchResult<SmartVideoOptions>;
/**
 * Builds the semantically correct embed HTML for any supported source.
 *
 * - Direct files (`.mp4`/`.webm`) → `<figure><video controls …>` (native).
 * - YouTube / Vimeo → `<figure><iframe …>` (embedded context), or a
 *   click-to-play facade (`<button>` + thumbnail) when `facade: true`
 *   so `.md/.mdx` posts never pay the iframe cost on load.
 *
 * Pure string builder: SSR-safe, no DOM access. Escape is applied to
 * all interpolated attributes.
 *
 * @param options - Source + a11y + presentation options.
 * @returns `{ provider, id, html }` with the ready-to-inject markup.
 *
 * @example
 * ```ts
 * const { html } = useBuildVideoEmbed({ src: "https://youtu.be/…", title: "My talk" });
 * ```
 */
export declare function useBuildVideoEmbed(options: SmartVideoOptions): MediaSource & {
    html: string;
};
//# sourceMappingURL=media.service.d.ts.map