#!/usr/bin/env python3
"""Place the supplied PHI vector logo in a verified blank title-page rectangle.

Only the first page receives drawing commands. The operation preserves existing
page content, fonts, document metadata, page labels, links and embedded files.
It does not change or re-evaluate scientific results.
"""
from __future__ import annotations
import argparse, hashlib, json, math
from pathlib import Path
import fitz
import cairosvg
import numpy as np


def digest(p: Path) -> str:
    h=hashlib.sha256()
    with p.open('rb') as f:
        for b in iter(lambda: f.read(1024*1024),b''): h.update(b)
    return h.hexdigest()


def canonical(obj):
    if isinstance(obj, (fitz.Rect,fitz.Point,fitz.Matrix)): return list(obj)
    if isinstance(obj,dict): return {k:canonical(v) for k,v in obj.items()}
    if isinstance(obj,(tuple,list)): return [canonical(v) for v in obj]
    return obj


def attachment_hashes(d):
    return {n:hashlib.sha256(d.embfile_get(n)).hexdigest() for n in d.embfile_names()}


def rgb(p,scale=1):
    pm=p.get_pixmap(matrix=fitz.Matrix(scale,scale),colorspace=fitz.csRGB,alpha=False,annots=True)
    return np.frombuffer(pm.samples,dtype=np.uint8).reshape(pm.height,pm.width,3)


def stamp(src:Path,logo:Path,dst:Path,top:float,width:float=156):
    if src.resolve()==dst.resolve(): raise ValueError('Use a new output filename')
    d=fitz.open(src)
    if not d.is_pdf or d.needs_pass or len(d)==0: raise ValueError('An unencrypted readable PDF is required')
    if logo.suffix.lower()=='.svg':
        raw=cairosvg.svg2pdf(url=str(logo)); lg=fitz.open(stream=raw,filetype='pdf')
    else: lg=fitz.open(logo)
    h=width*lg[0].rect.height/lg[0].rect.width; x=(d[0].rect.width-width)/2
    rect=fitz.Rect(x,top,x+width,top+h)
    if not d[0].rect.contains(rect): raise ValueError('Logo lies outside page')
    for b in d[0].get_text('blocks'):
        if rect.intersects(fitz.Rect(b[:4])+(-12,-12,12,12)):
            raise ValueError('Logo would overlap or crowd an existing title-page block')
    # No raster cover replacement; the uploaded SVG path is embedded as vector drawing.
    d[0].show_pdf_page(rect,lg,0,overlay=True,keep_proportion=True)
    dst.parent.mkdir(parents=True,exist_ok=True)
    d.save(dst,garbage=0,deflate=True,encryption=fitz.PDF_ENCRYPT_KEEP)
    d.close(); lg.close()
    return list(rect)


def verify(src:Path,dst:Path,rect,mode,report:Path,preview:Path|None=None):
    a=fitz.open(src);b=fitz.open(dst); region=fitz.Rect(rect)
    errors=[]; n=min(len(a),len(b));same_text=0;same_body=0;same_fonts=0;same_geometry=0;same_links=0
    changed_cover_pixels=0;outside_cover_changes=0
    if len(a)!=len(b): errors.append('page_count')
    for i in range(n):
        p,q=a[i],b[i]
        if p.get_text()==q.get_text(): same_text+=1
        else: errors.append(f'text:{i+1}')
        if (p.mediabox,p.cropbox,p.rotation)==(q.mediabox,q.cropbox,q.rotation):same_geometry+=1
        else:errors.append(f'geometry:{i+1}')
        if canonical(p.get_fonts(full=True))==canonical(q.get_fonts(full=True)):same_fonts+=1
        else:errors.append(f'fonts:{i+1}')
        if canonical(p.get_links())==canonical(q.get_links()):same_links+=1
        else:errors.append(f'links:{i+1}')
        aa=rgb(p);bb=rgb(q)
        if aa.shape!=bb.shape:errors.append(f'render_shape:{i+1}');continue
        mask=np.any(aa!=bb,axis=2)
        if i==0:
            changed_cover_pixels=int(mask.sum())
            y0=max(0,math.floor(region.y0)-2);y1=min(mask.shape[0],math.ceil(region.y1)+2)
            x0=max(0,math.floor(region.x0)-2);x1=min(mask.shape[1],math.ceil(region.x1)+2)
            mask[y0:y1,x0:x1]=False;outside_cover_changes=int(mask.sum())
            if outside_cover_changes:errors.append('cover_outside_logo')
            if changed_cover_pixels==0:errors.append('invisible_logo')
        elif not mask.any():same_body+=1
        else:errors.append(f'body_pixels:{i+1}')
        if i%35==0:fitz.TOOLS.store_shrink(100)
    toc=canonical(a.get_toc(simple=False))==canonical(b.get_toc(simple=False))
    meta=a.metadata==b.metadata
    labels=a.get_page_labels()==b.get_page_labels()
    ah=attachment_hashes(a);bh=attachment_hashes(b)
    for key,ok in [('bookmarks',toc),('metadata',meta),('page_labels',labels),('attachments',ah==bh)]:
        if not ok:errors.append(key)
    if preview:
        preview.parent.mkdir(parents=True,exist_ok=True)
        b[0].get_pixmap(matrix=fitz.Matrix(1.5,1.5),alpha=False).save(preview)
    result={
      'filename':dst.name,'theme':mode,'pages':len(b),
      'source_sha256':digest(src),'output_sha256':digest(dst),'output_bytes':dst.stat().st_size,
      'logo_rectangle_pt':list(region),'logo_width_mm':round(region.width*25.4/72,3),
      'unchanged_page_texts':same_text,'unchanged_page_geometries':same_geometry,
      'unchanged_font_records':same_fonts,'unchanged_link_records':same_links,
      'identical_body_page_renders':same_body,'comparison_dpi':72,
      'cover_changed_pixels':changed_cover_pixels,'cover_changes_outside_logo_rectangle':outside_cover_changes,
      'bookmarks_identical':toc,'bookmark_count':len(a.get_toc()),'metadata_identical':meta,
      'page_labels_identical':labels,'embedded_attachments_identical':ah==bh,'embedded_attachments':bh,
      'new_rasterized_pages':0,'scientific_content_modified':False,
      'verification_programs_rerun':False,'new_proof_assistant_acceptances':0,
      'errors':errors,'passed':not errors}
    report.parent.mkdir(parents=True,exist_ok=True);report.write_text(json.dumps(result,indent=2))
    a.close();b.close();return result

if __name__=='__main__':
    ap=argparse.ArgumentParser(description=__doc__)
    ap.add_argument('input',type=Path);ap.add_argument('logo',type=Path);ap.add_argument('output',type=Path)
    ap.add_argument('--top',type=float,required=True);ap.add_argument('--width',type=float,default=156.)
    ap.add_argument('--theme',choices=['light','dark'],required=True);ap.add_argument('--report',type=Path,required=True)
    ap.add_argument('--preview',type=Path)
    ns=ap.parse_args();r=stamp(ns.input,ns.logo,ns.output,ns.top,ns.width)
    record=verify(ns.input,ns.output,r,ns.theme,ns.report,ns.preview)
    print(json.dumps(record,indent=2));raise SystemExit(0 if record['passed'] else 1)
