"""
GLAMWalk -- Volume 4: Libraries & Archives
12_faded_page_import.py

The Faded Page import pattern: a human-provided exact URL only, with a loud, always-visible Canadian-PD-is-not-US-PD warning stamped into the book record.

Source: Volume Four, Chapter 5 -- Faded Page
Targets Python 3.11.4 -- see Volume One, Chapter 1.5/1.6.
"""

CANADIAN_PD_WARNING = (
    "⚠ Sourced from Faded Page (Canadian public domain). "
    "Canadian PD status does NOT guarantee US public domain status — "
    "verify independently before publishing in US-focused markets."
)

def import_faded_page_book(url, title, author):
    return {
        "title": title,
        "author": author,
        "source_url": url,
        "description": f"{CANADIAN_PD_WARNING}\n\n[normal book description follows]",
        "notes": CANADIAN_PD_WARNING,
        "status": "draft",   # human review required before this ever publishes
    }