#!/usr/bin/env python3
"""Generate a 50-mark elaborate essay PDF on Critical Appraisal of Metallic and
Non-Metallic Inlays and Onlays."""

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

OUT = "/tmp/workspace/inlay-onlay-essay/output/Critical_Appraisal_Inlays_Onlays.pdf"

styles = getSampleStyleSheet()
styles.add(ParagraphStyle(name="TitleBig", fontSize=20, leading=24, alignment=TA_CENTER,
                           spaceAfter=6, fontName="Helvetica-Bold"))
styles.add(ParagraphStyle(name="SubTitle", fontSize=12, leading=16, alignment=TA_CENTER,
                           spaceAfter=18, fontName="Helvetica-Oblique", textColor=colors.HexColor("#444444")))
styles.add(ParagraphStyle(name="H1", fontSize=15, leading=18, spaceBefore=16, spaceAfter=8,
                           fontName="Helvetica-Bold", textColor=colors.HexColor("#1a3d6d")))
styles.add(ParagraphStyle(name="H2", fontSize=12.5, leading=15, spaceBefore=10, spaceAfter=6,
                           fontName="Helvetica-Bold", textColor=colors.HexColor("#2a5a8a")))
styles.add(ParagraphStyle(name="Body", fontSize=10.7, leading=15.5, alignment=TA_JUSTIFY,
                           spaceAfter=8, fontName="Helvetica"))
styles.add(ParagraphStyle(name="BodyBold", parent=styles["Body"], fontName="Helvetica-Bold"))
styles.add(ParagraphStyle(name="Bullet", parent=styles["Body"], leftIndent=14, spaceAfter=3))
styles.add(ParagraphStyle(name="TableCell", fontSize=9, leading=11.5, fontName="Helvetica"))
styles.add(ParagraphStyle(name="TableHeader", fontSize=9.3, leading=12, fontName="Helvetica-Bold",
                           textColor=colors.white))

def P(text, style="Body"):
    return Paragraph(text, styles[style])

def bullets(items, style="Bullet"):
    return ListFlowable(
        [ListItem(P(i, style), leftIndent=10, value="•") for i in items],
        bulletType="bullet", start="•", leftIndent=12, spaceBefore=2, spaceAfter=8
    )

def make_table(header, rows, col_widths):
    data = [[Paragraph(h, styles["TableHeader"]) for h in header]]
    for r in rows:
        data.append([Paragraph(str(c), styles["TableCell"]) for c in r])
    t = Table(data, colWidths=col_widths, repeatRows=1)
    t.setStyle(TableStyle([
        ("BACKGROUND", (0, 0), (-1, 0), colors.HexColor("#1a3d6d")),
        ("GRID", (0, 0), (-1, -1), 0.5, colors.HexColor("#999999")),
        ("VALIGN", (0, 0), (-1, -1), "TOP"),
        ("ROWBACKGROUNDS", (0, 1), (-1, -1), [colors.white, colors.HexColor("#eef2f8")]),
        ("TOPPADDING", (0, 0), (-1, -1), 5),
        ("BOTTOMPADDING", (0, 0), (-1, -1), 5),
        ("LEFTPADDING", (0, 0), (-1, -1), 5),
        ("RIGHTPADDING", (0, 0), (-1, -1), 5),
    ]))
    return t

story = []

# ---------- Title Page ----------
story.append(Spacer(1, 3*cm))
story.append(P("CRITICAL APPRAISAL OF METALLIC AND<br/>NON-METALLIC INLAYS AND ONLAYS", "TitleBig"))
story.append(P("An Elaborate Essay - Conservative Dentistry &amp; Restorative Prosthodontics (50 Marks)", "SubTitle"))
story.append(Spacer(1, 1.5*cm))
story.append(P(
    "Inlays and onlays occupy the middle ground of restorative dentistry, bridging the gap between "
    "simple direct plastic restorations and full-coverage crowns. The choice of restorative material - "
    "metallic (cast gold and base-metal alloys) versus non-metallic (composite resin, ceramic, and "
    "CAD/CAM-milled materials) - profoundly influences the biomechanical performance, esthetic outcome, "
    "biological compatibility, longevity and cost of the restoration. This essay critically appraises both "
    "categories across their indications, contraindications, laboratory and clinical properties, advantages, "
    "disadvantages, and long-term evidence, so as to guide rational material selection in contemporary practice.",
    "Body"
))
story.append(PageBreak())

# ---------- 1. Introduction ----------
story.append(P("1. INTRODUCTION", "H1"))
story.append(P(
    "An <b>inlay</b> is an intracoronal indirect restoration that is fabricated outside the mouth (extraorally) "
    "and cemented into a prepared cavity, restoring the restoration within the confines of the cusps without "
    "covering them. An <b>onlay</b> is an extension of the inlay concept that additionally covers one or more "
    "cusps or the entire occlusal surface, thereby providing cuspal protection while still being more "
    "conservative than a full crown. Both are classified as indirect restorations because they are constructed "
    "on a cast or a digital model and later luted to tooth structure with a cement or resin adhesive, in "
    "contrast to direct restorations (amalgam, direct composite) that are placed and set inside the mouth in a "
    "single visit.", "Body"))
story.append(P(
    "Historically, inlays and onlays were almost exclusively fabricated from cast gold alloys because of their "
    "unmatched combination of marginal adaptability, wear compatibility with enamel, and longevity. With the "
    "advent of acid-etch bonding, improved composite resins, pressed and milled ceramics, and CAD/CAM "
    "technology, non-metallic tooth-colored alternatives have become the restorations of choice for most "
    "patients who prioritize esthetics. A critical appraisal therefore requires comparing both material classes "
    "on scientific and clinical merit rather than on popularity alone.", "Body"))

story.append(P("1.1 Classification of Inlays and Onlays", "H2"))
story.append(bullets([
    "<b>Based on material:</b> Metallic (Type II/III/IV gold alloys, base-metal alloys - Ni-Cr, Co-Cr) and "
    "Non-metallic (direct/indirect composite resin, feldspathic porcelain, leucite-reinforced ceramic, lithium "
    "disilicate, zirconia-reinforced lithium silicate, resin nanoceramic/hybrid ceramic, CAD/CAM composite blocks).",
    "<b>Based on extent:</b> Simple inlay (intracoronal only), onlay (cuspal coverage), high-strength/reinforced "
    "onlay, and overlay/table-top onlay (full occlusal coverage without axial reduction).",
    "<b>Based on fabrication technique:</b> Direct (fabricated intraorally, e.g., direct composite inlay), "
    "Indirect conventional (wax pattern - casting; or laboratory-processed composite/porcelain), and "
    "CAD/CAM (optical scan - digital design - milling or 3D printing).",
]))

# ---------- 2. Metallic ----------
story.append(P("2. METALLIC INLAYS AND ONLAYS", "H1"))
story.append(P(
    "Cast gold alloys remain the historical gold standard (literally) for posterior indirect restorations. "
    "Alloys used range from Type I (soft, for low-stress inlays) to Type IV (hard, for onlays and long-span "
    "restorations), along with base-metal alloys such as nickel-chromium and cobalt-chromium used in patients "
    "with cost constraints or specific clinical needs.", "Body"))

story.append(P("2.1 Properties Relevant to Clinical Performance", "H2"))
story.append(bullets([
    "<b>Marginal integrity:</b> Gold can be burnished, allowing the thin margins to be physically adapted to "
    "the cavosurface, producing the closest marginal seal of any restorative material.",
    "<b>Wear behavior:</b> The wear rate of gold alloy is very close to that of natural enamel, so it does not "
    "excessively abrade the opposing dentition, unlike some ceramics.",
    "<b>Mechanical strength:</b> High tensile and compressive strength, excellent fatigue resistance, and "
    "ductility allow thin restorations in areas of high occlusal load without fracture.",
    "<b>Biocompatibility:</b> High-noble gold alloys are chemically inert and extremely well tolerated by "
    "gingival and pulpal tissues; base-metal alloys carry a risk of nickel hypersensitivity.",
    "<b>Retention/resistance form:</b> Because of its strength, less axial taper and cavity depth are required "
    "compared to ceramic, permitting more conservative tooth preparation in certain situations (though margins "
    "still need adequate reduction for structural integrity).",
    "<b>Corrosion resistance:</b> Noble alloys resist tarnish and corrosion in the oral environment; base-metal "
    "alloys are more prone to corrosion products and ion release.",
]))

story.append(P("2.2 Indications", "H2"))
story.append(bullets([
    "Posterior teeth subjected to heavy occlusal loads (bruxism, clenching) where esthetics is a secondary concern.",
    "Long-span or large restorations replacing multiple cusps where fracture resistance is critical.",
    "Patients with a history of ceramic/composite restoration failure or high caries/wear risk.",
    "Situations demanding minimal-to-no tooth reduction at margins (feather-edge finish possible with gold).",
]))

story.append(P("2.3 Contraindications and Disadvantages", "H2"))
story.append(bullets([
    "<b>Esthetics:</b> The single greatest limitation - unacceptable in the esthetic zone and increasingly "
    "rejected by patients even in posterior teeth.",
    "<b>Cost:</b> High material cost (noble metal content) and laboratory/technician charges.",
    "<b>Technique and time:</b> Requires two or more appointments, precise impression making, die fabrication, "
    "wax pattern, casting, finishing and polishing - a resource- and time-intensive laboratory workflow.",
    "<b>Thermal conductivity:</b> High thermal conductivity can cause pulpal sensitivity if an adequate "
    "insulating base/liner is not placed, especially with deep preparations.",
    "<b>Galvanism:</b> Risk of galvanic current/metallic taste when dissimilar metallic restorations contact "
    "in the same arch.",
    "<b>Bonding limitation:</b> Conventional cast alloys are cemented rather than adhesively bonded (unless "
    "surface treatments/silane-coupled base metal are used), so retention relies more on geometric form than "
    "chemical adhesion, limiting reinforcement of remaining tooth structure.",
    "<b>Biocompatibility concerns with base-metal alloys:</b> nickel sensitization, beryllium toxicity in older "
    "alloys, and higher corrosion potential.",
]))

story.append(P("2.4 Critical Appraisal", "H2"))
story.append(P(
    "Cast gold alloy inlays/onlays possess the best long-term clinical longevity data of any indirect "
    "restoration, with multiple long-term follow-up studies reporting survival rates exceeding 90% at 10 years "
    "and many restorations surviving 20-30 years with minimal marginal deterioration. Their major limitation is "
    "purely esthetic, and secondarily economic and technique-related. In an era where patients demand "
    "tooth-colored restorations, gold's clinical superiority is frequently outweighed by patient preference, "
    "relegating it to a shrinking (though evidence-strong) niche indication - particularly molars, patients with "
    "parafunction, and situations of restricted vertical space where a thin but strong restoration is required.",
    "Body"))

# ---------- 3. Non-metallic ----------
story.append(P("3. NON-METALLIC INLAYS AND ONLAYS", "H1"))
story.append(P(
    "Non-metallic restorations are now the dominant choice in contemporary indirect dentistry because they "
    "combine adhesive bonding with tooth-like esthetics. They fall into two broad subgroups: resin-based "
    "(composite) and ceramic-based materials.", "Body"))

story.append(P("3.1 Composite Resin Inlays/Onlays", "H2"))
story.append(bullets([
    "<b>Direct composite inlay:</b> Fabricated intraorally on the prepared tooth or on a die, then bonded "
    "in the same visit.",
    "<b>Indirect/laboratory composite:</b> Fabricated on a model with additional heat, light, or "
    "pressure-and-heat post-curing, which improves the degree of conversion, reduces polymerization shrinkage "
    "stress, and increases wear resistance and strength compared to direct composite.",
    "<b>CAD/CAM composite (resin nanoceramic) blocks:</b> Milled from industrially pre-polymerized blocks with "
    "highly uniform, void-free microstructure (e.g., resin nanoceramic materials), giving superior mechanical "
    "consistency."
]))
story.append(P("Advantages of Composite Inlays/Onlays:", "BodyBold"))
story.append(bullets([
    "Excellent, tooth-matching esthetics with good polishability.",
    "Adhesive bonding reinforces the remaining tooth structure and reduces cuspal flexure (the restoration "
    "acts to 'glue' the tooth back together).",
    "Modulus of elasticity closer to dentin than ceramic, so composite is more forgiving on the opposing "
    "enamel (less wear of antagonist tooth) and is easily repairable intraorally if chipped.",
    "Lower cost than ceramic/gold; can be milled chairside for same-day delivery.",
    "Conservative preparation with rounded internal angles, since bonding (not retention form) provides "
    "resistance.",
]))
story.append(P("Disadvantages of Composite Inlays/Onlays:", "BodyBold"))
story.append(bullets([
    "Lower wear resistance and fracture toughness than ceramic; more prone to surface staining and gradual "
    "loss of anatomic form/polish over time.",
    "Polymerization shrinkage and associated stress at the cement interface (mitigated, but not eliminated, "
    "by indirect fabrication).",
    "Technique-sensitive bonding protocol; moisture contamination compromises the adhesive interface.",
    "Long-term color stability inferior to ceramic, particularly with staining beverages/tobacco.",
]))

story.append(P("3.2 Ceramic Inlays/Onlays", "H2"))
story.append(bullets([
    "<b>Feldspathic/leucite-reinforced porcelain:</b> Excellent esthetics and translucency but relatively low "
    "flexural strength (~120-160 MPa); best suited to low-stress-bearing, adhesively-bonded situations.",
    "<b>Lithium disilicate glass-ceramic:</b> High flexural strength (~360-400 MPa after crystallization), "
    "excellent esthetics, available as pressed ingots or CAD/CAM blocks; currently the most widely used "
    "ceramic for posterior inlays/onlays.",
    "<b>Zirconia-reinforced lithium silicate / polycrystalline zirconia:</b> Very high strength, used for "
    "high-load onlays, though monolithic zirconia has lower translucency.",
    "<b>Resin-matrix (hybrid) ceramics:</b> A compromise class combining ceramic filler with a resin matrix, "
    "offering shock absorption and easier milling/repair.",
]))
story.append(P("Advantages of Ceramic Inlays/Onlays:", "BodyBold"))
story.append(bullets([
    "Superior, long-term color stability and translucency - the best esthetic match to natural enamel.",
    "High compressive strength and excellent wear resistance when properly polished and glazed.",
    "Chemically inert, highly biocompatible, and does not corrode.",
    "Strong adhesive bond achievable via hydrofluoric acid etching + silane coupling (glass-ceramics), "
    "reinforcing remaining tooth structure similar to composite.",
    "CAD/CAM workflow (e.g., chairside milling systems) allows same-day, single-visit fabrication, reducing "
    "provisionalization needs.",
]))
story.append(P("Disadvantages of Ceramic Inlays/Onlays:", "BodyBold"))
story.append(bullets([
    "Brittle - susceptible to catastrophic (non-repairable) fracture under tensile/flexural stress, especially "
    "if minimum thickness recommendations (commonly 1.0-1.5 mm occlusal / 1.0 mm axial, material-dependent) "
    "are not respected.",
    "Requires more tooth reduction than metal or composite to provide adequate bulk for strength, making the "
    "preparation less conservative in some designs.",
    "Higher wear on opposing natural enamel if the ceramic surface is inadequately polished/glazed or becomes "
    "roughened by adjustment (a well-documented antagonist-wear controversy versus composite/gold).",
    "Technique-sensitive cementation (etching, silanation, isolation) and higher laboratory/chairside milling cost.",
    "Difficult and unreliable intraoral repair if fractured; usually requires remake.",
]))

# ---------- 4. Comparative Table ----------
story.append(PageBreak())
story.append(P("4. COMPARATIVE CRITICAL APPRAISAL", "H1"))
story.append(P(
    "The table below synthesizes the key clinically relevant parameters across the major inlay/onlay material "
    "categories to allow direct, evidence-based comparison.", "Body"))

header = ["Parameter", "Cast Gold Alloy", "Base-Metal Alloy", "Composite Resin", "Ceramic (Glass/Lithium Disilicate)"]
rows = [
    ["Esthetics", "Poor (metallic)", "Poor (metallic)", "Good-Very good", "Excellent"],
    ["Fracture toughness", "Excellent (ductile)", "Good", "Moderate", "Low-Moderate (brittle)"],
    ["Wear resistance", "Excellent, enamel-friendly", "Excellent, harder than enamel", "Moderate", "Excellent (if polished)"],
    ["Wear of opposing enamel", "Minimal", "Can be high", "Low", "Variable/can be high if rough"],
    ["Marginal adaptation", "Excellent (burnishable)", "Good", "Good (bonded)", "Good (bonded, technique dependent)"],
    ["Bond to tooth structure", "Cementation only (mechanical)", "Cementation only", "True adhesive bond", "True adhesive bond (etched)"],
    ["Reinforcement of tooth", "Minimal", "Minimal", "Good", "Good"],
    ["Biocompatibility", "Excellent (noble)", "Variable (Ni sensitivity risk)", "Good", "Excellent (inert)"],
    ["Thermal conductivity", "High (needs liner)", "High", "Low (insulating)", "Low (insulating)"],
    ["Tooth reduction needed", "Minimal-moderate", "Minimal-moderate", "Conservative", "Moderate (bulk for strength)"],
    ["Repairability if fractured/chipped", "Not typically needed", "Not typically needed", "Easy, intraoral", "Difficult, usually remake"],
    ["Chairside/CAD-CAM same-day option", "No", "No", "Yes", "Yes"],
    ["Relative cost", "High", "Moderate", "Low-Moderate", "Moderate-High"],
    ["Long-term survival evidence (>10 yr)", "Very strong, >90%", "Strong", "Moderate, improving with indirect/CAD-CAM", "Strong, improving with lithium disilicate"],
]
story.append(make_table(header, rows, [3.6*cm, 3.2*cm, 3.2*cm, 3.0*cm, 3.4*cm]))
story.append(Spacer(1, 10))

# ---------- 5. Clinical decision-making ----------
story.append(P("5. FACTORS GOVERNING CLINICAL MATERIAL SELECTION", "H1"))
story.append(bullets([
    "<b>Esthetic demand and location:</b> Anterior/premolar visible zones strongly favor ceramic or composite; "
    "posterior molars in low-esthetic-demand patients may still justify gold.",
    "<b>Occlusal load and parafunction:</b> Heavy bruxers may fare better with gold or high-strength lithium "
    "disilicate/zirconia-reinforced ceramic rather than feldspathic porcelain or composite.",
    "<b>Remaining tooth structure:</b> Extensively broken-down teeth benefit from the adhesive reinforcement of "
    "bonded composite/ceramic onlays, which act to splint cusps together, versus non-bonded metal.",
    "<b>Available interocclusal space:</b> Limited vertical space (e.g., over-erupted opposing tooth) may "
    "necessitate the thinner cross-section achievable with metal, since ceramic requires greater bulk for "
    "strength.",
    "<b>Opposing dentition:</b> Natural, unrestored opposing enamel is best preserved by gold or well-glazed "
    "ceramic/composite; rough or under-glazed ceramic can accelerate antagonist wear.",
    "<b>Cost and number of visits:</b> Direct/CAD-CAM composite or chairside-milled ceramic reduce visits and "
    "cost versus a conventional cast/laboratory ceramic workflow.",
    "<b>Patient factors:</b> Known metal (nickel) allergy rules out base-metal alloys; bruxism, poor oral "
    "hygiene, or high caries risk affect long-term prognosis of any bonded restoration.",
])) 

story.append(P("6. LIMITATIONS COMMON TO BOTH CATEGORIES", "H1"))
story.append(bullets([
    "Both require at least a two-step clinical/laboratory process (except single-visit CAD/CAM), with an "
    "interim/temporary restoration phase that carries its own risk of leakage or dislodgement.",
    "Both are technique-sensitive at cementation - moisture control, cement selection, and complete removal of "
    "excess cement are critical for pulpal and periodontal health regardless of material.",
    "Secondary caries can occur at the margins of any indirect restoration if isolation, impression accuracy, "
    "or marginal fit is compromised.",
    "All indirect restorations require additional tooth reduction compared to a simple direct filling, and none "
    "are indicated in extremely small or minimally invasive cavities where a direct restoration suffices.",
]))

# ---------- 7. Conclusion ----------
story.append(P("7. CONCLUSION", "H1"))
story.append(P(
    "Neither metallic nor non-metallic inlays and onlays can be labelled unconditionally superior; each "
    "material class has a well-defined envelope of clinical strength. Cast gold alloy remains the benchmark "
    "for marginal precision, wear compatibility, and documented longevity, but its clinical use is constrained "
    "almost entirely by esthetic unacceptability and cost in modern practice. Non-metallic restorations - "
    "particularly adhesively bonded composite resin and high-strength glass-ceramics such as lithium "
    "disilicate - have largely supplanted metal because they combine acceptable-to-excellent mechanical "
    "performance with esthetics and true adhesive reinforcement of remaining tooth structure, while allowing "
    "efficient single-visit CAD/CAM delivery. A critical, evidence-based appraisal therefore favors "
    "individualized material selection: gold alloy for heavy-load, low-esthetic-demand posterior situations "
    "and lithium disilicate/composite (increasingly CAD/CAM-fabricated) for the great majority of contemporary "
    "esthetic posterior indirect restorations, always tailored to the patient's occlusal risk, remaining tooth "
    "structure, esthetic expectations, and financial considerations.", "Body"))

story.append(Spacer(1, 10))
story.append(P(
    "<i>Prepared as an academic essay for examination purposes (Conservative Dentistry &amp; Endodontics / "
    "Prosthodontics). Sources synthesized from standard restorative dentistry principles and current clinical "
    "literature on indirect restorative materials.</i>", "Body"))

doc = SimpleDocTemplate(OUT, pagesize=A4,
                         leftMargin=2*cm, rightMargin=2*cm, topMargin=1.8*cm, bottomMargin=1.8*cm,
                         title="Critical Appraisal of Metallic and Non-Metallic Inlays and Onlays")
doc.build(story)
print("PDF written to", OUT)

Successfully replaced 1 instance(s) of the string in '/tmp/workspace/inlay-onlay-essay/build_pdf.py'

Successfully replaced 1 instance(s) of the string in '/tmp/workspace/inlay-onlay-essay/build_pdf.py'

#!/usr/bin/env python3
"""Generate a 50-mark elaborate essay PDF on Smear Layer - Current Concepts in
Conservative Dentistry and Endodontics."""

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

OUT = "/tmp/workspace/smear-layer-essay/output/Smear_Layer_Current_Concepts.pdf"

styles = getSampleStyleSheet()
styles.add(ParagraphStyle(name="TitleBig", fontSize=19, leading=23, alignment=TA_CENTER,
                           spaceAfter=6, fontName="Helvetica-Bold"))
styles.add(ParagraphStyle(name="SubTitle", fontSize=12, leading=16, alignment=TA_CENTER,
                           spaceAfter=18, fontName="Helvetica-Oblique", textColor=colors.HexColor("#444444")))
styles.add(ParagraphStyle(name="H1", fontSize=15, leading=18, spaceBefore=16, spaceAfter=8,
                           fontName="Helvetica-Bold", textColor=colors.HexColor("#1a3d6d")))
styles.add(ParagraphStyle(name="H2", fontSize=12.5, leading=15, spaceBefore=10, spaceAfter=6,
                           fontName="Helvetica-Bold", textColor=colors.HexColor("#2a5a8a")))
styles.add(ParagraphStyle(name="Body", fontSize=10.7, leading=15.5, alignment=TA_JUSTIFY,
                           spaceAfter=8, fontName="Helvetica"))
styles.add(ParagraphStyle(name="BodyBold", parent=styles["Body"], fontName="Helvetica-Bold"))
styles.add(ParagraphStyle(name="BulletItem", parent=styles["Body"], leftIndent=14, spaceAfter=3))
styles.add(ParagraphStyle(name="TableCell", fontSize=9, leading=11.5, fontName="Helvetica"))
styles.add(ParagraphStyle(name="TableHeader", fontSize=9.3, leading=12, fontName="Helvetica-Bold",
                           textColor=colors.white))

def P(text, style="Body"):
    return Paragraph(text, styles[style])

def bullets(items, style="BulletItem"):
    return ListFlowable(
        [ListItem(P(i, style), leftIndent=10, value="•") for i in items],
        bulletType="bullet", start="•", leftIndent=12, spaceBefore=2, spaceAfter=8
    )

def make_table(header, rows, col_widths):
    data = [[Paragraph(h, styles["TableHeader"]) for h in header]]
    for r in rows:
        data.append([Paragraph(str(c), styles["TableCell"]) for c in r])
    t = Table(data, colWidths=col_widths, repeatRows=1)
    t.setStyle(TableStyle([
        ("BACKGROUND", (0, 0), (-1, 0), colors.HexColor("#1a3d6d")),
        ("GRID", (0, 0), (-1, -1), 0.5, colors.HexColor("#999999")),
        ("VALIGN", (0, 0), (-1, -1), "TOP"),
        ("ROWBACKGROUNDS", (0, 1), (-1, -1), [colors.white, colors.HexColor("#eef2f8")]),
        ("TOPPADDING", (0, 0), (-1, -1), 5),
        ("BOTTOMPADDING", (0, 0), (-1, -1), 5),
        ("LEFTPADDING", (0, 0), (-1, -1), 5),
        ("RIGHTPADDING", (0, 0), (-1, -1), 5),
    ]))
    return t

story = []

# ---------- Title Page ----------
story.append(Spacer(1, 2.7*cm))
story.append(P("SMEAR LAYER: CURRENT CONCEPTS IN<br/>CONSERVATIVE DENTISTRY AND ENDODONTICS", "TitleBig"))
story.append(P("An Elaborate Essay (50 Marks)", "SubTitle"))
story.append(Spacer(1, 1.2*cm))
story.append(P(
    "The smear layer is an amorphous, irregular layer of debris created iatrogenically whenever dentin, enamel, "
    "or cementum is cut with a rotary or hand instrument. First described in detail by Brannstrom in the 1980s, "
    "it has since become one of the most extensively researched interfacial phenomena in restorative dentistry "
    "and endodontics, because its presence or removal directly governs adhesion, microbial penetration, "
    "obturation quality, and long-term treatment success. This essay presents an elaborate, current review of "
    "the composition, formation, clinical significance, and management of the smear layer in both coronal "
    "(restorative) and radicular (endodontic) contexts, along with contemporary evidence-based recommendations.",
    "Body"
))
story.append(PageBreak())

# ---------- 1. Introduction ----------
story.append(P("1. INTRODUCTION AND DEFINITION", "H1"))
story.append(P(
    "The <b>smear layer</b> is defined as a thin (1-5 micrometre thick), amorphous, granular layer of organic "
    "and inorganic debris that is mechanically produced on and adherent to dentin, enamel or cementum surfaces "
    "following cutting procedures such as cavity preparation, tooth preparation for indirect restorations, or "
    "root canal instrumentation. The term was popularized by <b>Brannstrom and Nordenvall (1984)</b>, though the "
    "phenomenon had been observed earlier under the electron microscope by Eick et al. (1970) as a 'gelatinous "
    "film' covering cut dentin. It consists of two structural components:", "Body"))
story.append(bullets([
    "<b>Surface smear layer proper:</b> a compact layer of tooth debris, denatured collagen, hydroxyapatite "
    "crystals, remnants of odontoblastic processes and, in the root canal, bacteria and necrotic pulp tissue, "
    "smeared over the cut surface.",
    "<b>Smear plugs:</b> extensions of the same debris packed 1-10 micrometres (occasionally up to 40 "
    "micrometres) into the dentinal tubule orifices, effectively occluding them.",
]))
story.append(P(
    "Because the smear layer is loosely adherent, poorly mineralized, and can itself harbor microorganisms, it "
    "occupies a paradoxical position in dentistry: it can act as a protective diffusion barrier reducing dentin "
    "permeability and postoperative sensitivity, yet it simultaneously interferes with adhesive bonding and "
    "shelters bacteria within the root canal system, making the decision to remove, modify, or retain it a "
    "central current concept in both conservative dentistry and endodontics.", "Body"))

story.append(P("1.1 Composition of the Smear Layer", "H2"))
story.append(bullets([
    "Inorganic: hydroxyapatite crystals, calcium and phosphate ions derived from cut mineralized tissue.",
    "Organic: denatured/degraded collagen fibrils, remnants of odontoblastic processes, and (in the root canal) "
    "bacterial cells, bacterial by-products, and necrotic or vital pulp tissue remnants.",
    "In the root canal specifically, the smear layer may also incorporate irrigant precipitates, particularly "
    "when sodium hypochlorite and chlorhexidine or EDTA are mixed inappropriately, forming an orange-brown "
    "para-chloroaniline (PCA) precipitate that further complicates the layer.",
]))

# ---------- 2. Formation ----------
story.append(P("2. FORMATION OF THE SMEAR LAYER", "H1"))
story.append(P("2.1 Coronal (Restorative) Smear Layer", "H2"))
story.append(P(
    "Formed during cavity preparation with rotary burs, hand instruments, air abrasion or sonic/ultrasonic "
    "tips. Its thickness and morphology vary with the type and sharpness of the cutting instrument, rotational "
    "speed, degree of water coolant, and the pressure applied. High-speed diamond burs under water spray produce "
    "a thinner, more uniform smear layer, whereas dull burs or dry cutting create a thicker, more irregular "
    "layer with deeper smear plugs.", "Body"))
story.append(P("2.2 Radicular (Endodontic) Smear Layer", "H2"))
story.append(P(
    "Produced during root canal instrumentation (hand files or rotary/reciprocating NiTi systems) as they plane "
    "the canal walls. It is generated along the entire length of canal preparation and is particularly thick in "
    "areas of instrument contact and in curved or irregular canal anatomy (isthmuses, fins, ramifications) that "
    "instruments cannot mechanically reach, leaving a persistent, bacterially-contaminated layer even after "
    "thorough instrumentation. Rotary instrumentation at higher speeds tends to produce a more compact and "
    "adherent smear layer than reciprocating or manual filing.", "Body"))
story.append(P(
    "Factors influencing the amount and adherence of smear layer formation include: type of instrument "
    "(rotary vs hand, NiTi vs stainless steel), instrumentation technique (continuous rotation vs "
    "reciprocation), speed and torque, irrigation regimen used concurrently, degree of canal curvature, "
    "presence of sclerotic or caries-affected dentin (which alters tubule patency), and whether the pulp was "
    "vital or necrotic at the time of preparation.", "Body"))

# ---------- 3. Significance ----------
story.append(P("3. CLINICAL SIGNIFICANCE - THE REMOVE-VERSUS-RETAIN DEBATE", "H1"))
story.append(P("3.1 In Conservative (Restorative) Dentistry", "H2"))
story.append(bullets([
    "<b>Case for removal:</b> The smear layer is weakly bonded to the underlying dentin (bond strength as low "
    "as 5-10 MPa), is highly permeable to bacteria and their toxins, and physically blocks resin monomer "
    "penetration into the collagen network, preventing formation of a true hybrid layer. Total-etch (etch-and-"
    "rinse) adhesive systems are built on the principle of completely removing the smear layer with phosphoric "
    "acid to open dentinal tubules and demineralize intertubular dentin for resin tag and hybrid layer formation.",
    "<b>Case for retention/modification:</b> Self-etch adhesive systems deliberately do not remove but instead "
    "demineralize and incorporate the smear layer into the hybrid layer itself, using mild acidic monomers "
    "(pH ~2) that simultaneously etch and prime, reducing postoperative sensitivity by avoiding complete tubule "
    "opening and limiting hydrodynamic fluid movement.",
    "<b>Current consensus:</b> A completely open dentin surface (aggressive smear removal without adequate "
    "bonding) increases the risk of postoperative sensitivity through exposed patent tubules, whereas a modified, "
    "thin, resin-infiltrated smear layer (as in self-etch/universal adhesives with selective enamel etching) is "
    "now considered clinically favorable, balancing bond strength with reduced sensitivity - this represents the "
    "modern shift away from the older 'total removal is always best' dogma.",
]))

story.append(P("3.2 In Endodontics", "H2"))
story.append(bullets([
    "<b>Case for removal:</b> The smear layer can harbor viable bacteria and their by-products deep within "
    "smear plugs, protecting them from irrigants and intracanal medicaments, and can interfere with the "
    "penetration of both disinfecting agents and sealers into dentinal tubules, compromising the "
    "sealer-dentin interface and long-term apical seal. Torabinejad et al. and subsequent consensus statements "
    "support complete smear layer removal before obturation in orthograde root canal treatment.",
    "<b>Case for retention (in select situations):</b> Some studies suggest an intact smear layer may "
    "transiently reduce dentin permeability and could theoretically limit apical microleakage immediately "
    "after preparation; however, the overwhelming current evidence favors removal because the smear layer's "
    "bacterial reservoir effect outweighs any barrier benefit, especially given the widespread adoption of "
    "bioceramic sealers that require tubule penetration for optimal adaptation and antimicrobial action.",
    "<b>Effect on obturation:</b> A retained smear layer prevents sealer tags from penetrating dentinal "
    "tubules, reduces the sealer-dentin bond strength, and creates a potential pathway (via loosely attached "
    "smear plugs) for coronal and apical microleakage over time.",
])) 

# ---------- 4. Methods table ----------
story.append(PageBreak())
story.append(P("4. METHODS OF SMEAR LAYER REMOVAL - CURRENT CONCEPTS", "H1"))
story.append(P(
    "Numerous chemical, mechanical, and energy-based methods have been described and refined over the past two "
    "decades to remove or modify the smear layer, both on prepared cavity walls and, more extensively "
    "researched, within the root canal system.", "Body"))

story.append(P("4.1 Chemical Methods", "H2"))
story.append(bullets([
    "<b>EDTA (ethylenediaminetetraacetic acid), 17%:</b> The classical chelating agent; removes the inorganic "
    "smear layer effectively but has no significant antibacterial or organic tissue-dissolving action - hence "
    "it is used in conjunction with sodium hypochlorite (NaOCl), typically as a final rinse.",
    "<b>Sodium hypochlorite (NaOCl), 1-6%:</b> Excellent organic tissue solvent and antimicrobial, but cannot "
    "remove the inorganic component of the smear layer alone; alternating NaOCl with a chelator is the classical "
    "'final flush' protocol.",
    "<b>Citric acid (10-50%):</b> An effective chelator and mild alternative to EDTA, shown in systematic "
    "reviews to produce comparable or superior smear layer removal and tubule patency, with some added "
    "antibacterial benefit.",
    "<b>Chitosan and chitosan nanoparticles:</b> A biopolymer chelator that has emerged as a promising "
    "biocompatible alternative; recent (2024-2025) systematic reviews and meta-analyses report chitosan and its "
    "nanoparticle formulations achieve smear layer removal efficacy comparable to, and in several studies "
    "superior to, EDTA, together with intrinsic antibacterial and biofilm-disrupting properties.",
    "<b>MTAD / Tetraclean / QMix:</b> Combination chelator-antibiotic or chelator-detergent-antimicrobial "
    "solutions designed as single-step final rinses combining smear removal with antibacterial action.",
    "<b>Phosphoric acid gel (restorative use):</b> 30-37% phosphoric acid etches and removes the coronal smear "
    "layer completely prior to total-etch adhesive bonding.",
]))

story.append(P("4.2 Mechanical and Energy-Based Activation Methods", "H2"))
story.append(bullets([
    "<b>Passive ultrasonic irrigation (PUI):</b> An oscillating, non-cutting file/wire activates irrigant to "
    "produce acoustic streaming and cavitation, substantially improving smear layer and debris removal, "
    "especially in the apical third and canal irregularities, compared with syringe irrigation alone.",
    "<b>Sonic activation (e.g., EndoActivator):</b> Lower-frequency sonic energy agitates irrigant with a "
    "flexible polymer tip; effective and technique-tolerant, though generally less powerful than ultrasonics.",
    "<b>Laser-activated irrigation - PIPS and SWEEPS (Erbium lasers):</b> Photon-Induced Photoacoustic Streaming "
    "and Shockwave-Enhanced Emission Photoacoustic Streaming use laser energy delivered into irrigant-filled "
    "canals to create powerful shockwaves and cavitation bubbles; recent systematic reviews (2025) confirm "
    "superior smear layer and debris removal, particularly in the apical third, compared with conventional "
    "syringe irrigation, though results versus ultrasonic activation remain mixed/technique-dependent.",
    "<b>Negative-pressure apical irrigation (e.g., EndoVac):</b> Delivers irrigant via simultaneous "
    "positive-delivery/negative-aspiration at the working length, improving apical third smear removal and "
    "reducing the risk of irrigant extrusion.",
    "<b>XP-endo Finisher and other NiTi finishing files:</b> Non-cutting, flexible, martensite-to-austenite "
    "phase-change files that adapt to canal irregularities, mechanically disrupting residual smear layer and "
    "debris beyond the reach of standard rotary instrumentation.",
    "<b>Er,Cr:YSGG and Nd:YAG laser irradiation:</b> Used both for direct ablation and as adjuncts to chemical "
    "irrigation, with variable but generally favorable smear layer removal profiles.",
]))

story.append(P("4.3 Evaluation Methods", "H2"))
story.append(bullets([
    "<b>Scanning Electron Microscopy (SEM):</b> The gold-standard qualitative/semi-quantitative method for "
    "grading smear layer and tubule patency on dentin surfaces at high magnification.",
    "<b>Confocal Laser Scanning Microscopy (CLSM):</b> Used with fluorescent dye penetration to assess sealer "
    "or adhesive penetration depth into tubules as an indirect marker of smear layer removal.",
    "<b>Energy-dispersive X-ray spectroscopy (EDX/EDS) and micro-CT:</b> Increasingly used for elemental and "
    "three-dimensional quantitative analysis of residual smear layer and tubule occlusion.",
]))

# ---------- Comparative table ----------
story.append(P("4.4 Comparative Summary of Smear Layer Removal Agents/Techniques", "H2"))
header = ["Method/Agent", "Mechanism", "Key Advantage", "Key Limitation"]
rows = [
    ["17% EDTA", "Chelation of inorganic component", "Gold-standard, widely available", "No antibacterial/organic action alone"],
    ["Citric acid", "Chelation, mild demineralization", "Effective, biocompatible, some antibacterial action", "Technique/concentration dependent"],
    ["Chitosan (+ nanoparticles)", "Chelation + biofilm disruption", "Antibacterial, biocompatible, promising recent evidence", "Newer agent, less long-term clinical data"],
    ["NaOCl + EDTA final flush", "Organic dissolution + chelation", "Classical, proven protocol", "Precipitate risk if mixed directly; needs sequential use"],
    ["Passive ultrasonic irrigation", "Acoustic streaming/cavitation", "Improves removal in irregular anatomy", "Requires additional armamentarium/time"],
    ["Laser-activated irrigation (PIPS/SWEEPS)", "Photoacoustic shockwaves", "Superior apical third cleaning in reviews", "Cost, learning curve, equipment"],
    ["Negative pressure irrigation (EndoVac)", "Apical aspiration + delivery", "Reduces extrusion risk, good apical cleaning", "Apparatus-dependent, added chair time"],
    ["Phosphoric acid (restorative)", "Etching/dissolution", "Complete removal for total-etch bonding", "Can increase permeability/sensitivity if over-etched"],
]
story.append(make_table(header, rows, [4.3*cm, 3.6*cm, 4.0*cm, 4.3*cm]))

# ---------- 5. Current concepts / controversies ----------
story.append(PageBreak())
story.append(P("5. CURRENT CONCEPTS AND CONTROVERSIES", "H1"))
story.append(bullets([
    "<b>Universal/multi-mode adhesives:</b> The current restorative trend favors universal adhesives that can "
    "be used in etch-and-rinse, self-etch, or selective-etch modes, allowing the clinician to modulate smear "
    "layer removal versus incorporation depending on substrate (enamel vs dentin) and desired sensitivity/bond "
    "strength balance - reflecting a shift from a one-size-fits-all removal philosophy to substrate-specific "
    "management.",
    "<b>Bioceramic sealers and smear layer:</b> The rise of bioceramic/calcium-silicate sealers in endodontics, "
    "which rely on tubule penetration and chemical interaction with dentin (forming hydroxyapatite-like "
    "structures), has reinforced the importance of thorough smear layer removal as a prerequisite for optimal "
    "sealer performance and apical seal, strengthening the 'complete removal' consensus in endodontics compared "
    "with the more nuanced position in restorative dentistry.",
    "<b>Biocompatible/green chelators:</b> Growing interest in plant-derived and biopolymer chelators (chitosan, "
    "moringa extracts, aloe vera-based irrigants) as safer, non-cytotoxic alternatives to EDTA/citric acid, "
    "supported by an expanding base of ex-vivo systematic reviews (2023-2025).",
    "<b>Continuous chelation and single-solution irrigants:</b> Development of irrigants (e.g., "
    "continuous-chelation NaOCl/EDTA combinations, QMix) that combine antibacterial, tissue-dissolving, and "
    "chelating actions in one solution to simplify protocol and improve smear removal in a single step.",
    "<b>Smear layer and regenerative endodontic procedures:</b> In regenerative/revascularization procedures, "
    "removal of the smear layer with EDTA (rather than NaOCl alone) at the final irrigation step is now "
    "recommended to preserve stem cell viability and growth factor release from dentin, an example of how "
    "smear layer management intersects with regenerative current concepts.",
    "<b>Debate on antagonist effect of concurrent NaOCl and chlorhexidine/EDTA use:</b> Current protocols "
    "emphasize strict sequencing and copious saline/water interim rinses to avoid the orange-brown "
    "para-chloroaniline precipitate, itself a problematic secondary smear-like deposit.",
]))

story.append(P("6. CLINICAL IMPLICATIONS AND RECOMMENDATIONS", "H1"))
story.append(bullets([
    "In restorative dentistry, complete or selective smear layer removal with phosphoric acid is preferred "
    "for enamel margins and when maximum bond strength is the priority (e.g., laminate veneers), whereas "
    "self-etch/universal adhesive incorporation of a modified smear layer is preferred in deep dentin to "
    "minimize postoperative sensitivity.",
    "In endodontics, a full smear layer removal protocol - typically an alternating or final-rinse sequence "
    "of NaOCl followed by 17% EDTA (or citric acid/chitosan alternatives) for 1 minute, activated ultrasonically "
    "or sonically, followed by a final saline/water rinse - is recommended before obturation, particularly when "
    "bioceramic sealers are used.",
    "Clinicians should tailor the choice of irrigant activation technique (manual, sonic, ultrasonic, "
    "laser-based, negative pressure) to canal anatomy complexity, since simple syringe irrigation alone is "
    "consistently shown to be the least effective method for removing smear layer beyond the coronal and "
    "middle thirds of the canal.",
    "Awareness of biocompatibility is growing: chitosan and other biopolymer chelators may replace or "
    "supplement EDTA/citric acid as evidence continues to accumulate, especially where antibacterial "
    "co-benefit is desired.",
]))

# ---------- 7. Conclusion ----------
story.append(P("7. CONCLUSION", "H1"))
story.append(P(
    "The smear layer remains a pivotal, dual-edged entity in both conservative dentistry and endodontics. "
    "Contemporary understanding has moved beyond the simplistic 'remove versus retain' dichotomy of earlier "
    "decades toward a substrate- and procedure-specific philosophy: selective or complete removal in "
    "restorative bonding depending on the adhesive strategy chosen, and near-universal complete removal in "
    "endodontics to eliminate its bacterial reservoir effect and to optimize sealer penetration, especially "
    "with modern bioceramic materials. Advances in chelating agents (citric acid, chitosan and its "
    "nanoparticles), irrigant activation technologies (ultrasonic, sonic, laser-activated PIPS/SWEEPS, "
    "negative-pressure systems), and universal adhesive chemistries continue to refine how clinicians manage "
    "the smear layer, and ongoing systematic reviews and meta-analyses (2023-2025) confirm that no single "
    "method is universally superior, reinforcing the need for an individualized, evidence-based approach "
    "tailored to canal anatomy, restorative material, and desired biological outcome.", "Body"))

story.append(Spacer(1, 10))
story.append(P(
    "<i>Prepared as an academic essay for examination purposes (Conservative Dentistry &amp; Endodontics). "
    "Content synthesized from standard textbook principles of dentin bonding and root canal irrigation, "
    "supplemented by recent systematic reviews and meta-analyses (2023-2025) on smear layer removal agents "
    "and activation techniques.</i>", "Body"))

doc = SimpleDocTemplate(OUT, pagesize=A4,
                         leftMargin=2*cm, rightMargin=2*cm, topMargin=1.8*cm, bottomMargin=1.8*cm,
                         title="Smear Layer - Current Concepts in Conservative Dentistry and Endodontics")
doc.build(story)
print("PDF written to", OUT)

#!/usr/bin/env python3
"""Generate a 50-mark elaborate essay PDF on Acid-Base Resistant Zone (ABRZ)
in Conservative Dentistry and Endodontics."""

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

OUT = "/tmp/workspace/abrz-essay/output/Acid_Base_Resistant_Zone.pdf"

styles = getSampleStyleSheet()
styles.add(ParagraphStyle(name="TitleBig", fontSize=18, leading=22, alignment=TA_CENTER,
                           spaceAfter=6, fontName="Helvetica-Bold"))
styles.add(ParagraphStyle(name="SubTitle", fontSize=12, leading=16, alignment=TA_CENTER,
                           spaceAfter=18, fontName="Helvetica-Oblique", textColor=colors.HexColor("#444444")))
styles.add(ParagraphStyle(name="H1", fontSize=15, leading=18, spaceBefore=16, spaceAfter=8,
                           fontName="Helvetica-Bold", textColor=colors.HexColor("#1a3d6d")))
styles.add(ParagraphStyle(name="H2", fontSize=12.5, leading=15, spaceBefore=10, spaceAfter=6,
                           fontName="Helvetica-Bold", textColor=colors.HexColor("#2a5a8a")))
styles.add(ParagraphStyle(name="Body", fontSize=10.7, leading=15.5, alignment=TA_JUSTIFY,
                           spaceAfter=8, fontName="Helvetica"))
styles.add(ParagraphStyle(name="BodyBold", parent=styles["Body"], fontName="Helvetica-Bold"))
styles.add(ParagraphStyle(name="BulletItem", parent=styles["Body"], leftIndent=14, spaceAfter=3))
styles.add(ParagraphStyle(name="TableCell", fontSize=9, leading=11.5, fontName="Helvetica"))
styles.add(ParagraphStyle(name="TableHeader", fontSize=9.3, leading=12, fontName="Helvetica-Bold",
                           textColor=colors.white))

def P(text, style="Body"):
    return Paragraph(text, styles[style])

def bullets(items, style="BulletItem"):
    return ListFlowable(
        [ListItem(P(i, style), leftIndent=10, value="•") for i in items],
        bulletType="bullet", start="•", leftIndent=12, spaceBefore=2, spaceAfter=8
    )

def make_table(header, rows, col_widths):
    data = [[Paragraph(h, styles["TableHeader"]) for h in header]]
    for r in rows:
        data.append([Paragraph(str(c), styles["TableCell"]) for c in r])
    t = Table(data, colWidths=col_widths, repeatRows=1)
    t.setStyle(TableStyle([
        ("BACKGROUND", (0, 0), (-1, 0), colors.HexColor("#1a3d6d")),
        ("GRID", (0, 0), (-1, -1), 0.5, colors.HexColor("#999999")),
        ("VALIGN", (0, 0), (-1, -1), "TOP"),
        ("ROWBACKGROUNDS", (0, 1), (-1, -1), [colors.white, colors.HexColor("#eef2f8")]),
        ("TOPPADDING", (0, 0), (-1, -1), 5),
        ("BOTTOMPADDING", (0, 0), (-1, -1), 5),
        ("LEFTPADDING", (0, 0), (-1, -1), 5),
        ("RIGHTPADDING", (0, 0), (-1, -1), 5),
    ]))
    return t

story = []

# ---------- Title Page ----------
story.append(Spacer(1, 2.7*cm))
story.append(P("ACID-BASE RESISTANT ZONE (ABRZ):<br/>CURRENT CONCEPTS IN CONSERVATIVE DENTISTRY<br/>AND ENDODONTICS", "TitleBig"))
story.append(P("An Elaborate Essay (50 Marks)", "SubTitle"))
story.append(Spacer(1, 1.2*cm))
story.append(P(
    "The acid-base resistant zone (ABRZ), popularly termed 'super dentin', is a distinct, highly "
    "mineral-resistant layer of dentin discovered beneath the hybrid layer following application of "
    "self-etching adhesive systems and glass-ionomer-based materials. Since its identification by Japanese "
    "researchers in the early 2000s, the ABRZ has become an important current concept linking adhesive "
    "dentistry, caries prevention, and minimally invasive restorative philosophy. This essay elaborates on the "
    "definition, formation mechanism, structure, materials and techniques that produce it, methods of "
    "evaluation, and its clinical significance and applications in conservative dentistry and endodontics.",
    "Body"
))
story.append(PageBreak())

# ---------- 1. Introduction ----------
story.append(P("1. INTRODUCTION AND DEFINITION", "H1"))
story.append(P(
    "The <b>acid-base resistant zone (ABRZ)</b> is defined as a narrow band of dentin, located immediately "
    "beneath the hybrid layer (or beneath a glass-ionomer/dentin interface), that demonstrates markedly "
    "increased resistance to both acidic and alkaline (basic) challenges compared to unaffected, normal dentin. "
    "It was first identified through argon-ion beam etching and scanning electron microscopy by "
    "<b>Kuboki et al. (1977)</b> in the context of caries-affected dentin, and was later characterized in "
    "detail by <b>Nikaido, Inoue, Tagami and co-workers (Tokyo Medical and Dental University, early 2000s)</b> "
    "in relation to dentin bonded with self-etching primers and all-in-one adhesive systems. Because this zone "
    "renders the underlying dentin markedly more resistant to demineralization than sound dentin, it is "
    "colloquially referred to as <b>'super dentin.'</b>", "Body"))
story.append(P(
    "The ABRZ is clinically significant because it is thought to confer long-term resistance against secondary "
    "(recurrent) caries at the tooth-restoration interface, an area that is otherwise the most common site of "
    "restoration failure. Understanding its formation, the materials/techniques that generate it, and how it "
    "can be maximized clinically is now considered an important 'current concept' in minimally invasive and "
    "biomimetic restorative dentistry.", "Body"))

story.append(P("1.1 Historical Background", "H2"))
story.append(bullets([
    "<b>1977 - Kuboki et al.:</b> First reported an acid-resistant layer in carious dentin using electron "
    "microscopy.",
    "<b>Late 1990s-2000s - Nikaido, Inoue, Tagami et al.:</b> Systematically demonstrated ABRZ formation "
    "beneath hybrid layers created by self-etching primer systems and coined the term 'super dentin' to "
    "describe its enhanced acid-base resistance.",
    "<b>Inoue et al. (2006), Journal of Dental Research/related literature:</b> Used argon-ion beam etching "
    "combined with SEM to clearly delineate the ABRZ as a distinct morphological zone deep to the hybrid "
    "layer, and showed the ABRZ of caries-affected dentin was thicker than that of sound dentin.",
    "Subsequent research through the 2010s-2020s extended these findings to resin-modified glass ionomers, "
    "giomers (PRG-technology restoratives), universal adhesives, and root dentin substrates relevant to "
    "endodontic post-space bonding.",
]))

# ---------- 2. Formation ----------
story.append(P("2. FORMATION AND MECHANISM OF THE ABRZ", "H1"))
story.append(P(
    "The ABRZ forms as a consequence of the partial/mild demineralization produced by self-etching primers "
    "(pH approximately 1.5-2.5) or by the ion-exchange adhesion mechanism of glass-ionomer-based materials, in "
    "contrast to the complete demineralization produced by phosphoric acid total-etch systems.", "Body"))
story.append(bullets([
    "<b>With self-etching primers/all-in-one adhesives:</b> The mildly acidic functional monomers "
    "(e.g., 4-MET, 10-MDP, phenyl-P) simultaneously demineralize and infiltrate dentin. Because the acid is "
    "weak and is buffered/neutralized as it penetrates deeper, demineralization becomes progressively "
    "incomplete with depth. Residual hydroxyapatite crystals remain partially intact at the base of the "
    "monomer-infiltrated hybrid layer, chemically interacting with and being partially encapsulated by the "
    "infiltrating resin monomers and functional monomer-calcium salts (e.g., MDP-Ca salts). This '<b>incompletely "
    "demineralized, resin/monomer-reinforced dentin</b>' constitutes the ABRZ, which resists further acid or "
    "alkaline dissolution because its residual minerals are shielded and stabilized by the infiltrated resin "
    "and monomer-calcium complexes.",
    "<b>With glass-ionomer cements (GIC) and resin-modified GIC:</b> Adhesion occurs via an ion-exchange "
    "mechanism in which polyacrylic acid transiently demineralizes the dentin surface, releasing calcium and "
    "phosphate ions, while fluoride, calcium, phosphate and aluminum ions are exchanged and diffuse into the "
    "adjacent dentin/enamel. This produces a mineral-rich, fluoride- and calcium-enriched zone that is "
    "chemically distinct and considerably more resistant to subsequent acid attack, analogous to the ABRZ seen "
    "with self-etch adhesives, sometimes referred to as an 'ion-exchange layer.'",
    "<b>Absence of ABRZ with total-etch (etch-and-rinse) systems:</b> Because 30-37% phosphoric acid produces "
    "complete demineralization of the etched dentin surface (typically 3-5 micrometres deep) with subsequent "
    "rinsing away of dissolution products, no residual mineral-resin interaction zone remains; hence a true "
    "ABRZ is not formed with conventional total-etch three-step or two-step etch-and-rinse adhesives.",
]))

story.append(P("2.1 Proposed Chemical Basis", "H2"))
story.append(bullets([
    "Functional monomers such as 10-MDP (10-methacryloyloxydecyl dihydrogen phosphate) chemically bond to "
    "calcium in residual hydroxyapatite, forming stable MDP-calcium salts ('nano-layering') that resist "
    "further acid dissolution - this is considered central to ABRZ stability and durability.",
    "Fluoride release from glass-ionomer-based materials promotes formation of fluorapatite/fluorhydroxyapatite, "
    "which is intrinsically less soluble in acid than hydroxyapatite, contributing to the enhanced acid "
    "resistance of the underlying dentin.",
    "The zone is not pure dentin nor pure resin, but a hybridized mineral-organic-resin complex, which is why "
    "some authors avoid calling it simply 'dentin' and prefer descriptive terms like 'super dentin' or "
    "'acid-base resistant zone.'",
]))

# ---------- 3. Structure/characterization ----------
story.append(P("3. STRUCTURE AND CHARACTERIZATION", "H1"))
story.append(bullets([
    "Location: immediately subjacent to the hybrid layer, between the hybrid layer and unaffected/sound "
    "dentin.",
    "Thickness: typically reported in the range of 2-5 micrometres, although the ABRZ in caries-affected "
    "dentin has been shown to be thicker than in sound dentin, likely reflecting the pre-existing "
    "hypermineralized/sclerotic changes and altered mineral content of carious dentin.",
    "Visualization requires argon-ion beam etching of a polished, acid/base-challenged dentin cross-section "
    "followed by SEM, because the ABRZ is not distinguishable by resin penetration/staining methods alone - "
    "the differential resistance to the etching process itself reveals the zone as a raised, "
    "less-eroded band.",
    "Elemental analysis (EDS/EDX) shows relatively preserved calcium and phosphorus content within the ABRZ "
    "compared to the more demineralized hybrid layer above it, supporting the concept of a "
    "residual-mineral-plus-resin composite structure.",
]))

# ---------- 4. Materials/techniques table ----------
story.append(PageBreak())
story.append(P("4. MATERIALS AND TECHNIQUES ASSOCIATED WITH ABRZ FORMATION", "H1"))
header = ["Material/Technique", "Mechanism", "ABRZ Formed?", "Notes"]
rows = [
    ["Two-step/one-step self-etch adhesives (mild, pH ~2)", "Simultaneous mild etch + infiltration", "Yes, well documented", "Classic system for ABRZ research (e.g., Clearfil SE Bond)"],
    ["All-in-one (one-bottle) self-etch adhesives", "Very mild simultaneous etch-prime-bond", "Yes", "Some variability in thickness/quality across brands"],
    ["Universal/multi-mode adhesives (self-etch mode)", "Mild self-etch with MDP monomer", "Yes", "Increasingly studied contemporary systems"],
    ["Total-etch (etch-and-rinse) 3-step/2-step", "Complete phosphoric acid demineralization", "No / minimal", "Complete removal of minerals precludes ABRZ"],
    ["Conventional glass ionomer cement (GIC)", "Ion exchange, fluoride/Ca/PO4 diffusion", "Yes (ion-exchange layer)", "Basis of ART and sandwich technique benefit"],
    ["Resin-modified glass ionomer (RMGIC)", "Ion exchange + resin component", "Yes", "Combines GIC ion exchange with resin bonding"],
    ["Giomer / PRG-technology composites", "Pre-reacted glass releases fluoride", "Yes (reported)", "Fluoride-releasing resin composite with ABRZ-like effect"],
]
story.append(make_table(header, rows, [4.3*cm, 4.0*cm, 2.9*cm, 4.5*cm]))

# ---------- 5. Clinical significance ----------
story.append(P("5. CLINICAL SIGNIFICANCE IN CONSERVATIVE DENTISTRY", "H1"))
story.append(bullets([
    "<b>Resistance to secondary (recurrent) caries:</b> Because the marginal/interfacial dentin is the most "
    "common site of restoration failure due to microleakage and bacterial acid attack, an ABRZ at this "
    "interface theoretically provides a durable, self-protective mineral barrier resistant to future "
    "cariogenic acid challenges, supporting longevity of the restoration margin.",
    "<b>Support for minimally invasive/biomimetic dentistry:</b> Formation of super dentin fits within the "
    "philosophy of preserving and reinforcing existing tooth structure rather than simply removing all "
    "affected tissue, aligning with selective caries removal and the modern deep-caries management "
    "protocols (e.g., stepwise excavation, indirect pulp capping) where residual affected dentin is sealed "
    "rather than completely excised.",
    "<b>Relevance to caries-affected dentin bonding:</b> Since caries-affected dentin (partially "
    "demineralized, but not infected) is increasingly left in place during minimally invasive cavity "
    "preparation, and this substrate has been shown to develop an even thicker ABRZ than sound dentin, the "
    "concept directly supports contemporary selective caries excavation protocols.",
    "<b>Role in atraumatic restorative treatment (ART) and glass-ionomer restorations:</b> The ion-exchange "
    "layer/ABRZ-equivalent formed under GIC restorations is proposed as part of the mechanism behind the "
    "clinically observed caries-inhibiting effect of glass-ionomer materials, particularly relevant in public "
    "health ART programs in areas with limited access to comprehensive dental care.",
    "<b>Sandwich technique:</b> In the open and closed sandwich techniques, a GIC base beneath composite resin "
    "is placed partly to exploit this ion-exchange/ABRZ-forming mechanism at the cervical dentin margin, an "
    "area prone to recurrent caries and marginal leakage.",
    "<b>Deep dentin/pulp protection:</b> The mineral-reinforced nature of the ABRZ may contribute to reduced "
    "dentin permeability, indirectly supporting pulp protection when self-etch systems or glass-ionomer liners "
    "are used in deep cavity preparations.",
]))

story.append(P("6. RELEVANCE TO ENDODONTICS", "H1"))
story.append(bullets([
    "<b>Radicular (root) dentin bonding:</b> Fiber-post luting and resin-sealer bonding to root canal dentin "
    "increasingly employ self-etch or universal adhesive strategies; an ABRZ-like resistant zone has been "
    "investigated in root dentin substrates, with implications for the long-term durability of the "
    "resin-dentin interface in post-endodontic restorations.",
    "<b>Bioceramic and glass-ionomer-based root canal sealers:</b> Some contemporary sealers exploit "
    "ion-exchange chemistry similar to that responsible for ABRZ formation, potentially reinforcing "
    "peri-canal dentin against future microbial acid challenge and improving the apical seal's long-term "
    "resistance to leakage.",
    "<b>Coronal seal and secondary caries around endodontically treated teeth:</b> Since endodontically "
    "treated teeth are frequently restored with adhesive core build-ups, the same ABRZ-forming self-etch "
    "adhesive/GIC-liner strategies used in vital teeth are relevant to protecting the coronal restoration "
    "margin against recurrent caries in root-filled teeth.",
    "<b>Research limitation:</b> The overwhelming majority of ABRZ research has been performed on coronal "
    "dentin; direct clinical evidence in endodontically relevant radicular dentin remains comparatively "
    "limited, representing an area of ongoing research interest.",
]))

# ---------- 7. Evaluation methods ----------
story.append(P("7. METHODS OF EVALUATION/ASSESSMENT OF ABRZ", "H1"))
story.append(bullets([
    "<b>Argon-ion beam etching + SEM:</b> The principal method; differential resistance of the ABRZ to argon "
    "ion bombardment reveals it as a distinctly raised band compared to the more eroded surrounding "
    "demineralized dentin.",
    "<b>Energy-dispersive X-ray spectroscopy (EDS/EDX):</b> Quantifies relative calcium, phosphorus and "
    "fluoride content across the hybrid layer-ABRZ-sound dentin continuum.",
    "<b>Transmission electron microscopy (TEM):</b> Provides ultrastructural detail of residual mineral "
    "crystals and their relationship with infiltrated resin/monomer-calcium complexes.",
    "<b>Microhardness testing (Knoop/Vickers):</b> Used to indirectly assess relative mineral content and "
    "mechanical integrity across the dentin-adhesive interface.",
    "<b>In vitro pH-cycling/artificial caries challenge models:</b> Subject bonded specimens to alternating "
    "demineralizing and remineralizing solutions to functionally test the acid-base resistance and caries "
    "inhibition potential attributable to the ABRZ.",
]))

# ---------- 8. Current concepts/controversies ----------
story.append(P("8. CURRENT CONCEPTS AND CONTROVERSIES", "H1"))
story.append(bullets([
    "<b>Universal adhesives and variability:</b> Not all contemporary universal/multi-mode adhesives produce "
    "an equally robust ABRZ; formation is sensitive to the specific functional monomer used (10-MDP-containing "
    "systems generally show more consistent, stable ABRZ formation than others), etching mode selected "
    "(self-etch vs. selective-etch vs. total-etch), and substrate condition.",
    "<b>In vitro versus clinical evidence gap:</b> Most ABRZ research remains laboratory-based (SEM, "
    "microhardness, pH-cycling); robust long-term randomized clinical trial evidence directly linking ABRZ "
    "presence to reduced secondary caries incidence in patients is still limited, an important caveat when "
    "translating this concept into strong clinical recommendations.",
    "<b>Systematic reviews (2023-2024):</b> Recent systematic reviews comparing ABRZ formation across "
    "different adhesive generations confirm consistent formation with self-etch/all-in-one systems and its "
    "general absence with total-etch systems, but highlight heterogeneity in study methodology (etching "
    "duration, acid/alkali challenge protocols) that limits direct cross-study comparison.",
    "<b>Optimization strategies:</b> Current research explores incorporating bioactive glass, fluoride-releasing "
    "resin monomers, and calcium-phosphate nanofillers into adhesives and liners specifically to enhance and "
    "thicken the ABRZ, extending the 'super dentin' concept toward next-generation bioactive restorative "
    "materials.",
    "<b>Debate on caries-affected dentin retention:</b> The thicker ABRZ observed in caries-affected dentin "
    "provides scientific support for retaining, rather than aggressively excavating, softened but "
    "remineralizable affected dentin during minimally invasive cavity preparation, reinforcing selective "
    "caries removal guidelines.",
]))

# ---------- 9. Conclusion ----------
story.append(P("9. CONCLUSION", "H1"))
story.append(P(
    "The acid-base resistant zone represents a scientifically fascinating and clinically meaningful "
    "'self-reinforcing' response of dentin to mild self-etching adhesive systems and ion-exchange-based "
    "restorative materials such as glass ionomers. By combining residual, only partially demineralized "
    "hydroxyapatite with infiltrated resin monomers and monomer-calcium/fluorapatite complexes, the ABRZ "
    "creates a zone of 'super dentin' that is substantially more resistant to future acid and alkaline "
    "challenge than either sound or fully demineralized dentin. Its formation depends critically on the "
    "adhesive strategy chosen - mild self-etch and glass-ionomer-based approaches favor ABRZ formation, "
    "whereas aggressive total-etch phosphoric acid systems do not - making material selection an important "
    "clinical decision when durability against secondary caries is a priority. While laboratory evidence "
    "strongly supports the existence, structure, and acid-resistant properties of the ABRZ, and its relevance "
    "extends from routine restorative dentistry into caries-affected dentin management, sandwich and ART "
    "techniques, and emerging radicular/endodontic bonding applications, further well-designed clinical "
    "studies are needed to firmly establish its long-term protective role in reducing secondary caries in "
    "practice. As adhesive and bioactive material technology continues to evolve, the acid-base resistant zone "
    "remains an important current concept bridging cariology, adhesive dentistry, and minimally invasive "
    "restorative and endodontic practice.", "Body"))

story.append(Spacer(1, 10))
story.append(P(
    "<i>Prepared as an academic essay for examination purposes (Conservative Dentistry &amp; Endodontics). "
    "Content synthesized from foundational literature on the acid-base resistant zone/super dentin concept "
    "(Kuboki et al.; Nikaido, Inoue, Tagami et al.) and current peer-reviewed and systematic-review sources on "
    "dentin bonding, self-etch adhesives, and glass-ionomer ion-exchange chemistry.</i>", "Body"))

doc = SimpleDocTemplate(OUT, pagesize=A4,
                         leftMargin=2*cm, rightMargin=2*cm, topMargin=1.8*cm, bottomMargin=1.8*cm,
                         title="Acid-Base Resistant Zone - Current Concepts in Conservative Dentistry and Endodontics")
doc.build(story)
print("PDF written to", OUT)