Generators

from penquify.generators.pdf import generate_document_files, render_html, html_to_png, html_to_pdf

def render_html(doc: Document, template_name: str = "guia_despacho.html") -> str

async def html_to_png(html_content: str, output_path: str, width: int = 900, height: int = 1270) -> str

async def html_to_pdf(html_content: str, output_path: str) -> str

async def generate_document_files(
    doc: Document,
    output_dir: str,
    template_name: str = "guia_despacho.html",
) -> dict

from penquify.generators.photo import generate_photo, generate_dataset

async def generate_photo(
    reference_image_path: str,      # Path to clean document PNG/PDF
    variation: PhotoVariation,      # Variation config
    output_path: str,               # Where to save the photo
    api_key: Optional[str] = None,  # Gemini API key (or env GEMINI_API_KEY)
    doc_description: str = "",      # Key fields to preserve
) -> str                            # Returns output_path

async def generate_dataset(
    reference_image_path: str,
    variations: Optional[List[PhotoVariation]] = None,  # Custom variations
    output_dir: str = "output/photos",
    api_key: Optional[str] = None,
    doc_description: str = "",
    preset_names: Optional[List[str]] = None,  # Use named presets instead
) -> List[dict]                                # [{name, path, ok, error?}]

from penquify.generators.verify import generate_verified_photo, generate_verified_dataset

async def generate_verified_photo(
    reference_image_path: str,
    variation: PhotoVariation,
    output_path: str,
    schema: dict,                       # field_name -> expected_value
    max_retries: int = 3,
    api_key: Optional[str] = None,
    doc_description: str = "",
) -> dict

{
    "image_path": str,
    "verified": bool,
    "attempts": int,
    "ground_truth": dict,
    "verification": dict,
    "occlusion_manifest": dict,
}

async def generate_verified_dataset(
    reference_image_path: str,
    document: Document,
    variations: list[PhotoVariation] = None,
    output_dir: str = "output",
    api_key: Optional[str] = None,
    preset_names: list[str] = None,
    max_retries: int = 3,
) -> list[dict]

from penquify.generators.config import text_to_variation

async def text_to_variation(description: str, api_key: Optional[str] = None) -> dict