mkdir -p /home/daytona/workspace/neet-mds-notes && ls /home/daytona/workspace/ne…

~/neet-mds-notes/generate_pdf.py

from reportlab.lib.pagesizes import A4
from reportlab.lib import colors
from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle
from reportlab.lib.units import cm, mm
from reportlab.platypus import (
    SimpleDocTemplate, Paragraph, Spacer, Table, TableStyle,
    HRFlowable, PageBreak, KeepTogether
)
from reportlab.lib.enums import TA_CENTER, TA_LEFT, TA_JUSTIFY
from reportlab.platypus import ListFlowable, ListItem

OUTPUT_PATH = "/home/daytona/workspace/neet-mds-notes/NEET_MDS_Pulp_Periapical_Diseases_Shafer.pdf"

doc = SimpleDocTemplate(
    OUTPUT_PATH,
    pagesize=A4,
    rightMargin=1.8*cm,
    leftMargin=1.8*cm,
    topMargin=2*cm,
    bottomMargin=2*cm,
    title="NEET MDS Notes: Diseases of Pulp & Periapical Tissues (Shafer)",
    author="Orris AI"
)

# ── Colour palette ──────────────────────────────────────────────────────────
C_DARK_BLUE  = colors.HexColor("#0D2B6E")
C_MED_BLUE   = colors.HexColor("#1A56DB")
C_LIGHT_BLUE = colors.HexColor("#EBF4FF")
C_ACCENT     = colors.HexColor("#D62828")   # red for high-yield
C_YELLOW     = colors.HexColor("#FFF9C4")
C_GREEN      = colors.HexColor("#E8F5E9")
C_GREEN_DARK = colors.HexColor("#256029")
C_BORDER     = colors.HexColor("#B0C4DE")
C_HEADER_BG  = colors.HexColor("#1A56DB")
C_WHITE      = colors.white
C_LIGHT_GREY = colors.HexColor("#F5F5F5")
C_ORANGE     = colors.HexColor("#FF6F00")

# ── Styles ───────────────────────────────────────────────────────────────────
styles = getSampleStyleSheet()

def make_style(name, parent="Normal", **kwargs):
    s = ParagraphStyle(name=name, parent=styles[parent], **kwargs)
    return s

title_style = make_style("MainTitle", "Normal",
    fontSize=20, fontName="Helvetica-Bold",
    textColor=C_WHITE, alignment=TA_CENTER,
    spaceAfter=4, spaceBefore=4)

subtitle_style = make_style("Subtitle", "Normal",
    fontSize=11, fontName="Helvetica",
    textColor=C_LIGHT_BLUE, alignment=TA_CENTER,
    spaceAfter=2)

h1_style = make_style("H1", "Normal",
    fontSize=14, fontName="Helvetica-Bold",
    textColor=C_WHITE, spaceAfter=4, spaceBefore=10,
    leftIndent=0, leading=18)

h2_style = make_style("H2", "Normal",
    fontSize=11.5, fontName="Helvetica-Bold",
    textColor=C_DARK_BLUE, spaceAfter=3, spaceBefore=8,
    borderPad=3)

h3_style = make_style("H3", "Normal",
    fontSize=10.5, fontName="Helvetica-Bold",
    textColor=C_MED_BLUE, spaceAfter=2, spaceBefore=6)

body_style = make_style("Body", "Normal",
    fontSize=9.5, fontName="Helvetica",
    leading=14, spaceAfter=3, alignment=TA_JUSTIFY)

bullet_style = make_style("Bullet", "Normal",
    fontSize=9.5, fontName="Helvetica",
    leading=14, spaceAfter=2, leftIndent=14, bulletIndent=5)

high_yield_style = make_style("HighYield", "Normal",
    fontSize=9.5, fontName="Helvetica-Bold",
    textColor=C_ACCENT, leading=13, spaceAfter=2, leftIndent=14)

table_header_style = make_style("TblHdr", "Normal",
    fontSize=9, fontName="Helvetica-Bold",
    textColor=C_WHITE, alignment=TA_CENTER, leading=12)

table_cell_style = make_style("TblCell", "Normal",
    fontSize=9, fontName="Helvetica",
    leading=12, alignment=TA_LEFT)

note_style = make_style("Note", "Normal",
    fontSize=9, fontName="Helvetica-Oblique",
    textColor=C_GREEN_DARK, leading=13, spaceAfter=3,
    leftIndent=10, backColor=C_GREEN)

mnemonic_style = make_style("Mnemonic", "Normal",
    fontSize=9.5, fontName="Helvetica-Bold",
    textColor=C_ORANGE, leading=13, spaceAfter=3, leftIndent=10)

# ── Helper functions ──────────────────────────────────────────────────────────
story = []

def section_header(text, level=1):
    if level == 1:
        tbl = Table([[Paragraph(text, h1_style)]], colWidths=[doc.width])
        tbl.setStyle(TableStyle([
            ("BACKGROUND", (0,0), (-1,-1), C_DARK_BLUE),
            ("ROUNDEDCORNERS", [4]),
            ("TOPPADDING",    (0,0), (-1,-1), 6),
            ("BOTTOMPADDING", (0,0), (-1,-1), 6),
            ("LEFTPADDING",   (0,0), (-1,-1), 10),
        ]))
        story.append(Spacer(1, 6))
        story.append(tbl)
        story.append(Spacer(1, 4))
    elif level == 2:
        story.append(Spacer(1, 4))
        story.append(Paragraph(text, h2_style))
        story.append(HRFlowable(width="100%", thickness=1.2, color=C_MED_BLUE, spaceAfter=3))
    else:
        story.append(Paragraph(text, h3_style))

def bullet(text, bold_prefix=None):
    if bold_prefix:
        full = f"<b>{bold_prefix}</b> {text}"
    else:
        full = f"• {text}"
    story.append(Paragraph(full, bullet_style))

def high_yield(text):
    story.append(Paragraph(f"★ {text}", high_yield_style))

def body(text):
    story.append(Paragraph(text, body_style))

def note(text):
    story.append(Paragraph(f"📝 {text}", note_style))

def mnemonic(text):
    story.append(Paragraph(f"💡 {text}", mnemonic_style))

def spacer(h=4):
    story.append(Spacer(1, h))

def make_table(headers, rows, col_widths=None):
    if col_widths is None:
        n = len(headers)
        col_widths = [doc.width / n] * n
    header_row = [Paragraph(h, table_header_style) for h in headers]
    data = [header_row]
    for row in rows:
        data.append([Paragraph(str(c), table_cell_style) for c in row])
    tbl = Table(data, colWidths=col_widths, repeatRows=1)
    tbl.setStyle(TableStyle([
        ("BACKGROUND",    (0,0), (-1,0),  C_HEADER_BG),
        ("ROWBACKGROUNDS",(0,1), (-1,-1), [C_WHITE, C_LIGHT_GREY]),
        ("GRID",          (0,0), (-1,-1), 0.5, C_BORDER),
        ("TOPPADDING",    (0,0), (-1,-1), 4),
        ("BOTTOMPADDING", (0,0), (-1,-1), 4),
        ("LEFTPADDING",   (0,0), (-1,-1), 5),
        ("RIGHTPADDING",  (0,0), (-1,-1), 5),
        ("VALIGN",        (0,0), (-1,-1), "MIDDLE"),
    ]))
    story.append(tbl)
    story.append(Spacer(1, 6))

# ══════════════════════════════════════════════════════════════════════════════
#  COVER
# ══════════════════════════════════════════════════════════════════════════════
cover_data = [[Paragraph("NEET MDS HIGH-YIELD NOTES", title_style)],
              [Paragraph("Diseases of Pulp &amp; Periapical Tissues", title_style)],
              [Paragraph("Based on Shafer's Textbook of Oral Pathology", subtitle_style)],
              [Paragraph("Chapter-wise | MCQ-Focused | Key Points &amp; Tables", subtitle_style)]]
cover_tbl = Table(cover_data, colWidths=[doc.width])
cover_tbl.setStyle(TableStyle([
    ("BACKGROUND",    (0,0), (-1,-1), C_DARK_BLUE),
    ("TOPPADDING",    (0,0), (-1,-1), 10),
    ("BOTTOMPADDING", (0,0), (-1,-1), 10),
    ("LEFTPADDING",   (0,0), (-1,-1), 15),
    ("RIGHTPADDING",  (0,0), (-1,-1), 15),
    ("ROUNDEDCORNERS",[6]),
]))
story.append(Spacer(1, 20))
story.append(cover_tbl)
story.append(Spacer(1, 10))
note_text = "This document compiles the highest-yield facts from Shafer, Hine &amp; Levy's Textbook of Oral Pathology specifically targeting NEET MDS exam patterns. High-yield MCQ points are marked ★."
story.append(Paragraph(note_text, make_style("CoverNote","Normal",
    fontSize=9, fontName="Helvetica-Oblique",
    textColor=colors.HexColor("#555555"), alignment=TA_CENTER)))
story.append(PageBreak())

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 1 — CLASSIFICATION OF PULP DISEASES
# ══════════════════════════════════════════════════════════════════════════════
section_header("1. CLASSIFICATION OF PULP DISEASES")

body("Shafer classifies pulpal diseases based on clinical presentation, etiology, and histopathological features.")

section_header("1.1 Etiological Classification", 2)
bullet("Physical: trauma, heat from cavity preparation (>42°C), galvanism, barometric pressure changes")
bullet("Chemical: acids, bases, erosive dental materials, desiccation")
bullet("Bacterial: most common cause — direct extension of caries (most important), anachoresis, extension of periodontal disease")
high_yield("Most common cause of pulpitis = Dental caries (bacterial)")
high_yield("Heat generated during cavity preparation: >42°C causes irreversible pulp damage")

section_header("1.2 Shafer's Classification of Pulpitis", 2)

make_table(
    ["Type", "Sub-type", "Key Features"],
    [
        ["Acute Pulpitis", "Partial / Total", "Exudative inflammation; severe, spontaneous pain"],
        ["Chronic Pulpitis", "Open (Ulcerative) / Closed (Hyperplastic)", "Persistent low-grade inflammation"],
        ["Chronic Hyperplastic Pulpitis", "= Pulp Polyp", "Excess granulation tissue; painless; children"],
        ["Pulp Degeneration", "Calcific / Atrophic / Fibrous / Resorptive", "No frank inflammation"],
        ["Pulp Necrosis", "Coagulation / Liquefaction", "Death of pulp tissue"],
    ],
    col_widths=[4.5*cm, 5.5*cm, 9.5*cm]
)
high_yield("Chronic hyperplastic pulpitis (Pulp Polyp) = painless because new nerve fibres are not present in granulation tissue")

spacer()

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 2 — ACUTE PULPITIS
# ══════════════════════════════════════════════════════════════════════════════
section_header("2. ACUTE PULPITIS")

section_header("2.1 Reversible vs Irreversible Pulpitis", 2)
make_table(
    ["Feature", "Reversible Pulpitis", "Irreversible Pulpitis"],
    [
        ["Pain character",   "Mild–moderate, provoked",      "Severe, spontaneous, throbbing"],
        ["Duration",         "Short (seconds after stimulus)", "Prolonged (minutes–hours)"],
        ["Pain on percussion", "Negative / mild",           "Positive (late stage)"],
        ["Histology",        "Hyperaemia, mild inflammation", "Acute/chronic mixed inflammation; abscess"],
        ["Treatment",        "Remove irritant; sedative dressing", "RCT or extraction"],
        ["Electric pulp test", "Responds at low threshold",  "Responds at high threshold or no response"],
    ],
    col_widths=[4*cm, 5.5*cm, 5.5*cm]
)
high_yield("In irreversible pulpitis — pain LINGERS (>30 sec) after stimulus removed")
high_yield("Reversal of pain by cold in irreversible pulpitis = diagnostic of irreversible pulpitis with partial necrosis")

section_header("2.2 Histopathology of Acute Pulpitis", 2)
bullet("Early: vascular dilatation, oedema, transudation")
bullet("Established: polymorphonuclear neutrophil (PMN) infiltration — dominant cell")
bullet("Micro-abscess formation with liquefactive necrosis")
bullet("Pulp horns affected earliest (closest to caries)")
high_yield("Dominant cell in ACUTE pulpitis = PMN (Polymorphonuclear neutrophil)")

spacer()

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 3 — CHRONIC PULPITIS
# ══════════════════════════════════════════════════════════════════════════════
section_header("3. CHRONIC PULPITIS")

section_header("3.1 Chronic Closed (Ulcerative) Pulpitis", 2)
bullet("Occurs when pulp exposure is absent (caries has NOT yet reached pulp)")
bullet("Low-grade, smouldering inflammation")
bullet("Dominant cells: lymphocytes, plasma cells, macrophages")
bullet("Fibrous replacement in chronic phase")
high_yield("Dominant cell in CHRONIC pulpitis = Lymphocytes")

section_header("3.2 Chronic Open (Hyperplastic) Pulpitis — PULP POLYP", 2)
bullet("Aka Chronic Hyperplastic Pulpitis / Pulp Polyp")
bullet("Occurs in: young patients with large carious lesion + wide open apical foramen (good blood supply)")
bullet("Clinical: pink-red, fleshy, painless mass protruding through carious opening")
bullet("Histology: granulation tissue (young fibroblasts, capillaries, inflammatory cells) — covered by stratified squamous epithelium (from desquamated cells of oral mucosa)")
bullet("Cells: Fibroblasts, capillaries, few nerve fibres → explains why PAINLESS")
high_yield("Pulp Polyp = Chronic Hyperplastic Pulpitis = painless because newly formed granulation tissue has few/no nerve fibres")
high_yield("Surface epithelium on pulp polyp = stratified squamous epithelium from oral mucosa (NOT odontogenic)")
mnemonic("'Young Wide Painless Pink' = Young patient, Wide foramen, Painless, Pink polyp")

spacer()

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 4 — PULP DEGENERATION
# ══════════════════════════════════════════════════════════════════════════════
section_header("4. PULP DEGENERATION")

make_table(
    ["Type", "Description", "Key MCQ Point"],
    [
        ["Calcific Degeneration\n(Pulp Stones / Denticles)", "Calcified masses in pulp chamber/canal", "Most common degeneration; Free, Attached, Embedded"],
        ["Atrophic Degeneration", "Reduction in number of cells; fewer odontoblasts", "Seen in aged pulp; paucicellular"],
        ["Fibrous Degeneration", "Replacement of pulp by fibrous connective tissue", "Follows chronic inflammation"],
        ["Hyaline Degeneration", "Hyalinisation of pulp tissue", "Amorphous eosinophilic material"],
        ["Fatty Degeneration", "Fat vacuoles in pulp cells", "Rare"],
        ["Resorptive Degeneration\n(Internal Resorption)", "Odontoclastic resorption of dentine from within", "Pink spot on crown (Mummery's pink spot)"],
    ],
    col_widths=[4.5*cm, 6*cm, 5*cm]
)

section_header("4.1 Pulp Stones (Denticles) — High Yield", 2)
bullet("Calcified nodules in the pulp", bold_prefix="Definition:")
bullet("True denticles: contain dentinal tubules — resemble irregular dentine; formed by odontoblasts", bold_prefix="True denticles:")
bullet("False denticles: concentric layers of mineralisation — no tubules; dystrophic calcification", bold_prefix="False denticles:")
make_table(
    ["Classification", "Feature"],
    [
        ["Free denticle",     "Completely surrounded by pulp tissue"],
        ["Attached denticle", "Partially fused with dentine wall"],
        ["Embedded denticle", "Completely enclosed within dentine"],
        ["Interstitial",      "Within dentinal tubules (diffuse calcification)"],
    ],
    col_widths=[6*cm, 12*cm]
)
high_yield("Most common type of denticle = FALSE denticle (dystrophic calcification)")
high_yield("True denticle contains dentinal tubules; False denticle does NOT")
high_yield("Pulp stones are seen as radio-opaque masses on radiograph within pulp chamber")
high_yield("Pulp stones most common in: coronal pulp; most common associated condition = cardiovascular disease (incidental finding in Shafer)")

section_header("4.2 Internal Resorption (Pink Spot / Mummery's Pink Tooth)", 2)
bullet("Idiopathic resorption of dentine from within the canal by odontoclasts/multinucleated giant cells")
bullet("Appears clinically as 'pink spot' on crown — dentine absorbed → pulp tissue visible through translucent enamel")
bullet("Radiograph: smooth, round radiolucency within the root canal (balloon-shaped enlargement)")
bullet("Treatment: RCT (must remove all granulation tissue)")
high_yield("Internal resorption = Pink spot (Mummery's pink tooth) — pathognomonic clinical sign")
high_yield("Cell responsible = Odontoclasts (multinucleated giant cells similar to osteoclasts)")

spacer()

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 5 — PULP NECROSIS
# ══════════════════════════════════════════════════════════════════════════════
section_header("5. PULP NECROSIS")

make_table(
    ["Type", "Mechanism", "Features"],
    [
        ["Coagulation Necrosis", "Protein denaturation (physical/chemical insult)", "Dry, cheese-like necrosis; structure preserved"],
        ["Liquefaction Necrosis", "Enzymatic digestion by bacteria/PMNs", "Liquefied pus; more common in pulpitis; pulp becomes liquid"],
    ],
    col_widths=[5*cm, 5.5*cm, 6*cm]
)
high_yield("Most common type of pulp necrosis = Liquefaction necrosis (bacterial enzymatic)")
bullet("Necrotic pulp: NO response to electric pulp test, NO response to thermal tests")
bullet("May have positive percussion test if periapical tissues are involved")
bullet("Gangrene = necrosis + putrefactive bacteria (H2S, mercaptans, ammonia) → foul smell")
high_yield("Pulp gangrene = necrosis + anaerobic bacteria → characteristic foul odour")

spacer()

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 6 — PERIAPICAL DISEASES
# ══════════════════════════════════════════════════════════════════════════════
section_header("6. PERIAPICAL DISEASES — OVERVIEW")

body("Periapical diseases arise from spread of pulpal infection through the apical foramen into the periapical tissues.")

make_table(
    ["Condition", "Type", "Radiograph", "Key Feature"],
    [
        ["Acute Apical Periodontitis",      "Acute inflammatory",  "Normal (early) / slight widening PDL", "Exquisite pain on percussion"],
        ["Acute Dentoalveolar Abscess",     "Acute suppurative",   "Normal or diffuse lucency",             "Swelling, pus, fever"],
        ["Phoenix Abscess",                 "Acute on chronic",    "Periapical lucency",                   "Acute flare-up of chronic"],
        ["Chronic Apical Periodontitis",    "Chronic inflammatory","Periapical radiolucency",              "Usually asymptomatic"],
        ["Periapical Granuloma",            "Chronic productive",  "Well-defined radiolucency",            "Granulation tissue; most common periapical lesion"],
        ["Radicular Cyst",                  "Cystic",              "Well-defined corticated radiolucency", "Most common odontogenic cyst"],
        ["Condensing Osteitis",             "Bony reaction",       "Periapical radio-OPACITY",             "Sclerosis; low-virulence infection"],
    ],
    col_widths=[4.5*cm, 3.8*cm, 4.2*cm, 5*cm]
)

spacer()

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 7 — ACUTE PERIAPICAL DISEASES
# ══════════════════════════════════════════════════════════════════════════════
section_header("7. ACUTE PERIAPICAL DISEASES")

section_header("7.1 Acute Apical Periodontitis", 2)
bullet("Initial response of periapical tissues to pulpal infection or trauma")
bullet("Pain: severe, throbbing, constant; tooth feels 'elongated' (extruded)")
bullet("Histology: vascular dilatation, oedema, PMN infiltration in PDL")
bullet("Radiograph: usually normal OR slight widening of PDL space (early)")
high_yield("Acute apical periodontitis: tooth feels elongated — classic complaint; radiograph may be NORMAL early on")
high_yield("Dominant cell = PMN neutrophil")

section_header("7.2 Acute Dentoalveolar Abscess (Acute Alveolar Abscess)", 2)
bullet("Also called: Phoenix abscess (when arising from chronic lesion)")
bullet("Pus formation in periapical tissues → spreads along path of least resistance")
bullet("Stages: Initial periapical → Sub-periosteal → Sub-mucosal / Sub-cutaneous → Collar-stud abscess")
bullet("Systemic signs: fever, malaise, lymphadenopathy, trismus")
bullet("Histology: liquefactive necrosis, PMN infiltration, abscess cavity")
high_yield("Phoenix abscess = Acute exacerbation of chronic periapical lesion (granuloma/cyst)")
high_yield("Route of spread depends on: thickness of cortical plate + attachment of muscles")

make_table(
    ["Root Apex Position", "Spread Pattern"],
    [
        ["Maxillary incisors — labial root", "Labial vestibule"],
        ["Maxillary molars — buccal roots",  "Buccal vestibule (above buccinator = vestibular; below = buccal space abscess)"],
        ["Maxillary molars — palatal root",  "Palatal abscess"],
        ["Mandibular molars — lingual root above mylohyoid", "Sublingual space"],
        ["Mandibular molars — lingual root below mylohyoid", "Submandibular space → Ludwig's angina"],
        ["Canine fossa (maxillary canine)", "Canine space → cavernous sinus thrombosis risk"],
    ],
    col_widths=[6*cm, 11.5*cm]
)
high_yield("Ludwig's angina = bilateral submandibular + sublingual + submental space infection; floor of mouth elevation; airway emergency")
high_yield("Cavernous sinus thrombosis: commonest source = maxillary canine ('danger triangle of face')")

spacer()

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 8 — PERIAPICAL GRANULOMA
# ══════════════════════════════════════════════════════════════════════════════
section_header("8. PERIAPICAL GRANULOMA (Chronic Apical Periodontitis)")

section_header("8.1 Key Features", 2)
bullet("Most common periapical lesion overall")
bullet("Formed by: proliferation of granulation tissue around apex due to chronic low-grade infection")
bullet("Usually ASYMPTOMATIC (found incidentally on radiograph)")
bullet("Non-vital tooth")
bullet("Epithelial lining: ABSENT (no epithelium = granuloma, not cyst)")
high_yield("Periapical GRANULOMA = most common periapical lesion; NO epithelial lining")

section_header("8.2 Histopathology", 2)
bullet("Central zone: granulation tissue — proliferating fibroblasts, capillaries, inflammatory cells")
bullet("Inflammatory cells: lymphocytes, plasma cells, macrophages (Russell bodies from plasma cells)")
bullet("Peripheral zone: fibrous capsule (condensed fibrous tissue = Fibrous capsule)")
bullet("Epithelial rests of Malassez (ERM) may be present at periphery — can transform into radicular cyst")
bullet("Foam cells (cholesterol clefts) may be seen")
bullet("Russell bodies = eosinophilic globules = degenerated/secreting plasma cells")
high_yield("Russell bodies = degenerated plasma cells (immunoglobulin accumulation); seen in granuloma & radicular cyst")
high_yield("Epithelial rests of Malassez (ERM) = proliferate to form epithelial lining of radicular cyst")
high_yield("Peripheral fibrous capsule = condensed fibrous tissue at periphery of granuloma")

section_header("8.3 Radiographic Features", 2)
bullet("Well-defined periapical radiolucency")
bullet("Round/oval, attached to root apex")
bullet("Usually ≤1.5 cm (difficult to differentiate from small radicular cyst radiographically)")
note("Definitive diagnosis requires histopathology — radiograph CANNOT reliably distinguish granuloma from cyst")

spacer()

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 9 — RADICULAR CYST (Periapical Cyst)
# ══════════════════════════════════════════════════════════════════════════════
section_header("9. RADICULAR CYST (Periapical / Apical Periodontal Cyst)")

section_header("9.1 Key Features", 2)
bullet("Most common odontogenic cyst (55–70% of all jaw cysts)")
bullet("Most common cyst of the jaws overall")
bullet("Associated with non-vital teeth (carious, traumatised, or restored)")
bullet("Origin: Epithelial rests of Malassez (ERM) proliferate due to periapical inflammation")
high_yield("Radicular cyst = most common odontogenic cyst AND most common cyst of jaws")
high_yield("Stimulus for ERM proliferation = inflammatory mediators from pulp necrosis (prostaglandins, IL-1, TNF-α)")

section_header("9.2 Pathogenesis — Three-Phase Theory (Shafer)", 2)
make_table(
    ["Phase", "Event"],
    [
        ["Phase 1: Initiation", "ERM stimulated by inflammatory products → epithelial cell proliferation"],
        ["Phase 2: Cyst Formation", "Central cells of epithelial mass undergo ischaemic necrosis → cavity forms"],
        ["Phase 3: Enlargement", "Osmotic pressure differentials → fluid accumulation → cyst expansion"],
    ],
    col_widths=[5*cm, 12.5*cm]
)
high_yield("Mechanism of radicular cyst enlargement = osmotic pressure (hyperosmolar cyst fluid attracts water)")

section_header("9.3 Histopathology", 2)
bullet("Lining: Non-keratinised stratified squamous epithelium (arcading/network pattern with spongiosis)")
bullet("Rushton bodies (hyaline bodies): straight, curved, or hairpin-shaped eosinophilic structures within epithelium")
bullet("Cyst wall: chronically inflamed fibrous connective tissue")
bullet("Cholesterol clefts with foreign body giant cells")
bullet("Russell bodies (plasma cell derivatives)")
bullet("Mucous cells may be present (from metaplasia)")
high_yield("Rushton bodies = pathognomonic for radicular cyst (hyaline bodies in epithelial lining)")
high_yield("Rushton bodies: possibly derived from haemoglobin breakdown or degenerate epithelial cells")
high_yield("Epithelium in radicular cyst: NON-keratinised stratified squamous epithelium (arcading pattern)")

section_header("9.4 Residual Cyst", 2)
bullet("Radicular cyst that REMAINS after extraction of causative tooth")
bullet("Most common cyst found in edentulous areas")
high_yield("Residual cyst = radicular cyst left behind after tooth extraction = most common cyst in edentulous jaw")

section_header("9.5 Lateral Periodontal Cyst (Lateral Radicular Cyst)", 2)
bullet("Associated with lateral accessory canals")
bullet("On lateral surface of root (not apex)")
bullet("Same histopathology as periapical cyst")

spacer()

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 10 — CONDENSING OSTEITIS
# ══════════════════════════════════════════════════════════════════════════════
section_header("10. CONDENSING OSTEITIS (Focal Sclerosing Osteomyelitis)")

bullet("Host response to LOW-VIRULENCE chronic infection (e.g., caries of lower first molar)")
bullet("Bone attempts to wall off infection by sclerosis instead of resorption")
bullet("Clinical: asymptomatic; associated with mandibular first molar most commonly")
bullet("Radiograph: periapical RADIO-OPAQUE mass (diffuse sclerosis) — opposite of most periapical lesions")
bullet("Histology: dense trabeculae of bone with sparse marrow; few inflammatory cells")
high_yield("Condensing osteitis = ONLY periapical lesion that is RADIO-OPAQUE (not radiolucent)")
high_yield("Most common tooth involved = mandibular first molar")
high_yield("Caused by LOW virulence organisms — host has high resistance")

spacer()

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 11 — EXTERNAL ROOT RESORPTION
# ══════════════════════════════════════════════════════════════════════════════
section_header("11. EXTERNAL ROOT RESORPTION")

make_table(
    ["Type", "Cause", "Key Feature"],
    [
        ["Apical external resorption",      "Orthodontic forces, trauma, reimplantation", "Blunting of root apex on X-ray"],
        ["Inflammatory external resorption","Periapical infection",                       "Bowl-shaped resorption of root surface"],
        ["Replacement resorption (Ankylosis)","Avulsion + replantation; loss of PDL",     "Root replaced by bone; tooth sounds dull on percussion"],
        ["Cervical invasive resorption",    "Trauma, orthodontics, bleaching",            "Invasive below CEJ; 'helioid' pattern"],
    ],
    col_widths=[4.5*cm, 5.5*cm, 7.5*cm]
)
high_yield("Replacement resorption = ankylosis; dull percussion note; root replaced by bone")
high_yield("Most common cause of external root resorption = orthodontic force")

spacer()

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 12 — ACUTE VS CHRONIC — RAPID COMPARISON TABLE
# ══════════════════════════════════════════════════════════════════════════════
section_header("12. RAPID COMPARISON TABLE — PERIAPICAL LESIONS")

make_table(
    ["Feature",          "Periapical Granuloma", "Radicular Cyst",       "Acute Alveolar Abscess", "Condensing Osteitis"],
    [
        ["Symptoms",     "Asymptomatic",         "Asymptomatic",         "Severe pain, swelling",  "Asymptomatic"],
        ["Radiograph",   "Radiolucent (round)",  "Radiolucent (larger)", "Diffuse / normal",       "Radio-OPAQUE"],
        ["Epithelium",   "Absent",               "Present (NKSSqE)",     "Absent",                 "Absent"],
        ["Rushton bodies","Absent",              "PRESENT (pathog.)",    "Absent",                 "Absent"],
        ["Treatment",    "RCT / Curettage",      "Enucleation + RCT",    "I&D + RCT",              "RCT / Monitor"],
        ["Common",       "Most common PAL",      "Most common cyst",     "Acute variant",          "Lower molar"],
    ],
    col_widths=[4*cm, 4*cm, 4*cm, 4*cm, 3.5*cm]
)
high_yield("NKSSqE = Non-Keratinised Stratified Squamous Epithelium (lining of radicular cyst)")

spacer()

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 13 — IMPORTANT MCQ FACTS (ONE-LINERS)
# ══════════════════════════════════════════════════════════════════════════════
section_header("13. HIGH-YIELD ONE-LINER MCQ FACTS")

facts = [
    "Pulp Polyp = Chronic Hyperplastic Pulpitis = painless pink mass; young patients; wide foramen",
    "Dominant cell in acute pulpitis = PMN neutrophil",
    "Dominant cell in chronic pulpitis = Lymphocyte",
    "Pulp necrosis most common type = Liquefaction necrosis",
    "Pulp gangrene = necrosis + anaerobes → foul odour (H2S, mercaptans)",
    "True denticle = has dentinal tubules; False denticle = no tubules (most common)",
    "Internal resorption = Pink spot (Mummery's pink tooth) = odontoclasts",
    "External resorption most common cause = orthodontic force",
    "Periapical granuloma = most common periapical lesion; NO cyst lining",
    "Radicular cyst = most common odontogenic cyst; Rushton bodies are pathognomonic",
    "Residual cyst = radicular cyst after extraction = most common cyst in edentulous jaw",
    "Condensing osteitis = only radio-OPAQUE periapical lesion; low-virulence infection; mandibular 1st molar",
    "Rushton bodies = hyaline bodies in epithelial lining = unique to radicular cyst",
    "Russell bodies = degenerated plasma cells; seen in granuloma and radicular cyst",
    "Epithelial rests of Malassez (ERM) = residues of Hertwig's epithelial root sheath → form radicular cyst",
    "Radicular cyst enlargement mechanism = osmotic pressure",
    "Phoenix abscess = acute exacerbation of chronic periapical granuloma/cyst",
    "Temperature > 42°C during cavity prep → irreversible pulp damage",
    "Most common cause of pulp disease = dental caries",
    "Pink spot on tooth = internal resorption (Mummery's tooth); pathognomonic",
    "Anachoresis = localisation of blood-borne bacteria to inflamed pulp",
    "Granuloma: Fibrous capsule at periphery = condensed fibrous tissue / Zone of Neumayer",
    "ERM proliferates due to: prostaglandins, IL-1β, TNF-α from periapical inflammation",
    "Three-phase theory of cyst development: Initiation → Cyst formation → Enlargement (Shafer)",
    "Collar-stud abscess = abscess perforates periosteum → two compartments connected by narrow track",
    "Ludwig's angina: bilateral; submandibular + sublingual + submental; floor of mouth raised; life-threatening airway",
    "Pulpitis reversible: pain lasts SECONDS; irreversible: pain lasts MINUTES to HOURS",
    "Replacement resorption = ankylosis; root replaced by bone; high-pitched/dull percussion",
]

for f in facts:
    high_yield(f)

spacer()

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 14 — DIFFERENTIAL DIAGNOSIS
# ══════════════════════════════════════════════════════════════════════════════
section_header("14. DIFFERENTIAL DIAGNOSIS — PERIAPICAL RADIOLUCENCIES")

make_table(
    ["Condition",              "Cortication",  "Size",      "Associated Tooth",     "Special Feature"],
    [
        ["Periapical Granuloma",  "No/minimal",  "< 1.5 cm",  "Non-vital",            "Most common periapical lesion"],
        ["Radicular Cyst",        "Well-corticated", "> 1.5 cm", "Non-vital",         "Rushton bodies; NKSSqE lining"],
        ["Periapical Abscess",    "None (diffuse)", "Variable", "Non-vital",           "Pain, swelling, sinus tract"],
        ["Periapical Cemental Dysplasia", "Yes (mixed)", "Variable", "VITAL",          "No infection; fibro-cemento-osseous"],
        ["Traumatic Bone Cyst",   "Scalloping",  "Variable",  "Usually vital",        "Empty on surgery"],
        ["Nasopalatine Duct Cyst","Inverted pear","1–3 cm",   "Vital incisors",       "Heart/pear shape; btwn roots of central incisors"],
    ],
    col_widths=[4.5*cm, 3.5*cm, 2.5*cm, 4*cm, 5*cm]
)
high_yield("Periapical cemental dysplasia = VITAL tooth with periapical lesion — do NOT treat")
high_yield("Nasopalatine duct cyst = most common non-odontogenic cyst of jaws")

spacer()

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 15 — MNEMONICS
# ══════════════════════════════════════════════════════════════════════════════
section_header("15. MNEMONICS & MEMORY AIDS")

mnemonic("PAIRS = Periapical diseases: P=Periodontitis, A=Abscess, I=Internal resorption, R=Radicular cyst, S=Sclerosing osteitis")
mnemonic("'Rusty Radicular' = Rushton bodies are specific to Radicular cyst")
mnemonic("PINK = Internal resorption (Pulp Is Now Killing dentine)")
mnemonic("'FAE' for denticles: Free → Attached → Embedded (degree of fusion)")
mnemonic("'PLay' for pulp necrosis: P=Putrefactive (gangrene), L=Liquefaction (most common), Co=Coagulation")
mnemonic("For condensing osteitis: LORE = Low virulence, Opaque, Resistant host, Endemic in mandibular molar")
mnemonic("3 R's of periapical lesion histology: Russell bodies, Rushton bodies, Rests of Malassez")

spacer()

# ══════════════════════════════════════════════════════════════════════════════
#  SECTION 16 — PREVIOUSLY ASKED NEET MDS MCQ PATTERN TOPICS
# ══════════════════════════════════════════════════════════════════════════════
section_header("16. FREQUENTLY ASKED NEET MDS TOPIC PATTERNS")

make_table(
    ["Topic Area", "Most Commonly Tested Fact"],
    [
        ["Classification of pulpitis",       "Reversible vs Irreversible: pain duration criterion"],
        ["Pulp polyp",                        "Age, painlessness, wide foramen, granulation tissue, squamous epithelium"],
        ["Pulp stones",                       "True vs false; free/attached/embedded classification"],
        ["Internal vs external resorption",  "Pink spot = internal; blunted root = external; odontoclasts"],
        ["Periapical granuloma",             "Most common PAL; no epithelium; Russell bodies; fibrous capsule"],
        ["Radicular cyst",                   "Most common OGC; Rushton bodies; ERM origin; NKSSqE; osmotic expansion"],
        ["Condensing osteitis",              "Radio-OPAQUE; low virulence; mandibular molar; sclerosis"],
        ["Phoenix abscess",                  "Acute flare on chronic lesion; existing radiolucency + acute symptoms"],
        ["Residual cyst",                    "After extraction; edentulous jaw"],
        ["Ludwig's angina",                  "Bilateral; submandibular space; airway emergency"],
        ["Three-phase cyst formation",       "Shafer's theory: initiation, cyst formation, enlargement"],
        ["ERM",                              "Origin = Hertwig's epithelial root sheath; proliferate in radicular cyst"],
        ["Anachoresis",                      "Haematogenous bacteria localising to inflamed pulp — cause of pulpitis"],
        ["Galvanism",                        "Electrical effect between dissimilar metals — physical cause of pulpitis"],
    ],
    col_widths=[6*cm, 11.5*cm]
)

spacer()

# ── Footer note ──────────────────────────────────────────────────────────────
story.append(HRFlowable(width="100%", thickness=1, color=C_BORDER))
spacer(4)
footer_style = make_style("Footer", "Normal",
    fontSize=8, fontName="Helvetica-Oblique",
    textColor=colors.HexColor("#888888"), alignment=TA_CENTER)
story.append(Paragraph(
    "Source: Shafer, Hine &amp; Levy – A Textbook of Oral Pathology | Compiled for NEET MDS Preparation | Orris AI",
    footer_style))
story.append(Paragraph(
    "★ = High-yield MCQ point | All facts verified against Shafer's Oral Pathology standard chapters",
    footer_style))

# ── Build ─────────────────────────────────────────────────────────────────────
doc.build(story)
print(f"PDF generated successfully: {OUTPUT_PATH}")

cd /home/daytona/workspace/neet-mds-notes && python generate_pdf.py

ls -lh /home/daytona/workspace/neet-mds-notes/NEET_MDS_Pulp_Periapical_Diseases_…