modules/knowledge.py

UX_CHECKLIST = [
    "Mobile-First: Ensure site is functional on a 375px screen width.",
    "Accessibility: Check for high contrast and ARIA labels.",
    "Speed: Aim for < 100ms for interactive elements.",
    "Visual Hierarchy: Use font sizes and weights to guide the eye.",
    "Call to Action: Ensure every page has exactly one primary goal."
]

SEO_BASICS = {
    "Metadata": "Each page needs a unique <title> and <meta description>.",
    "Headings": "Use only one H1 per page. Follow with H2, H3 in logical order.",
    "Alt Text": "All images should have descriptive alt tags for search engines and screen readers.",
    "Semantics": "Use <nav>, <main>, <footer> tags rather than generic <div>s."
}

def get_ux_checklist() -> list:
    """Returns a checklist for modern UX design."""
    return UX_CHECKLIST

def get_seo_basics() -> dict:
    """Returns foundational rules for on-page SEO."""
    return SEO_BASICS

def list_design_patterns(pattern_type: str = "Landing") -> str:
    """Returns standard layout patterns for different site types."""
    patterns = {
        "Landing": "- Hero -> Social Proof -> Features -> FAQ -> Final CTA.",
        "Dashboard": "- Sidebar Nav -> Header Search -> Central Grid Cards.",
        "Blog": "- Featured Post -> Category Filter -> Article List -> Newsletter Opt-in."
    }
    return patterns.get(pattern_type.capitalize(), patterns["Landing"])