/**
 * Social Preview Generator
 * Generate beautiful social media preview images from any URL
 */
import { PreviewOptions, PreviewMetadataInput, ExtractedMetadata, GeneratedPreview, TemplateConfig } from './types';
export * from './exports';
/**
 * Generate a social preview image from a URL
 * @param url - The URL to generate preview for
 * @param options - Configuration options
 * @returns Buffer containing the generated image
 */
export declare function generatePreview(url: string, options?: PreviewOptions): Promise<Buffer>;
/**
 * Generate a social preview image from caller-provided metadata.
 * Use this for static/publish-time blog preview generation when metadata is already known.
 * @param metadata - Post/page metadata to render
 * @param options - Configuration options
 * @returns Buffer containing the generated image
 */
export declare function generatePreviewFromMetadata(metadata: PreviewMetadataInput, options?: PreviewOptions): Promise<Buffer>;
/**
 * Generate an image with a caller-provided template.
 * Metadata text and template numbers are bounded before rendering. The optional
 * overlayGenerator is trusted caller code, while its SVG return value must be a
 * string no larger than 1 MiB in UTF-8 bytes.
 */
export declare function generateImageWithTemplate(metadata: ExtractedMetadata, template: TemplateConfig, options: PreviewOptions): Promise<Buffer>;
/**
 * Generate preview with full result details
 */
export declare function generatePreviewWithDetails(url: string, options?: PreviewOptions): Promise<GeneratedPreview>;
/**
 * Generate a preview from caller-provided metadata with full result details.
 */
export declare function generatePreviewFromMetadataWithDetails(metadataInput: PreviewMetadataInput, options?: PreviewOptions): Promise<GeneratedPreview>;