Struct Document 

pub struct Document { /* private fields */ }

A Word document (.docx file).

This is the main entry point for reading, creating, and modifying DOCX documents.

Implementations

impl Document

pub fn new() -> Self

Create a new, empty document with default page setup and styles.

Examples found in repository

examples/convert_html_md.rs (line 15)

fn main() {
    let doc = Document::open("samples/feature_showcase.docx").expect("Failed to open document");

    let html = doc.to_html();
    std::fs::write("/tmp/feature_showcase.html", &html).expect("Failed to write HTML");
    println!("HTML: {} bytes -> /tmp/feature_showcase.html", html.len());

    let md = doc.to_markdown();
    std::fs::write("/tmp/feature_showcase.md", &md).expect("Failed to write Markdown");
    println!("Markdown: {} bytes -> /tmp/feature_showcase.md", md.len());

    // Simple document
    let mut simple = Document::new();
    simple.add_paragraph("Hello, World!");
    let html = simple.to_html();
    println!("\n--- Simple HTML ---\n{html}");

    let md = simple.to_markdown();
    println!("--- Simple Markdown ---\n{md}");
}

examples/generate_pdf.rs (line 9)

fn main() {
    // Test 1: Simple document
    let doc = Document::new();
    match doc.to_pdf() {
        Ok(bytes) => {
            std::fs::write("/tmp/rdocx_simple.pdf", &bytes).unwrap();
            println!("Simple PDF: {} bytes -> /tmp/rdocx_simple.pdf", bytes.len());
        }
        Err(e) => println!("Simple PDF failed: {e}"),
    }

    // Test 2: Document with content
    let mut doc = Document::new();
    doc.set_title("Test PDF Document");
    doc.set_author("rdocx-pdf");
    doc.add_paragraph("Chapter 1: Introduction")
        .style("Heading1");
    doc.add_paragraph(
        "This is a test document generated by rdocx and rendered to PDF. \
         It demonstrates text rendering with proper font shaping and pagination.",
    );
    doc.add_paragraph("Section 1.1").style("Heading2");
    doc.add_paragraph("More content in a sub-section.");

    {
        let mut table = doc.add_table(2, 3);
        for r in 0..2 {
            for c in 0..3 {
                if let Some(mut cell) = table.cell(r, c) {
                    cell.set_text(&format!("R{}C{}", r + 1, c + 1));
                }
            }
        }
    }

    doc.add_paragraph("After the table.");

    match doc.to_pdf() {
        Ok(bytes) => {
            std::fs::write("/tmp/rdocx_content.pdf", &bytes).unwrap();
            println!(
                "Content PDF: {} bytes -> /tmp/rdocx_content.pdf",
                bytes.len()
            );
        }
        Err(e) => println!("Content PDF failed: {e}"),
    }

    // Test 3: From feature_showcase.docx
    let showcase_path = concat!(
        env!("CARGO_MANIFEST_DIR"),
        "/../../samples/feature_showcase.docx"
    );
    match Document::open(showcase_path) {
        Ok(doc) => match doc.to_pdf() {
            Ok(bytes) => {
                std::fs::write("/tmp/rdocx_showcase.pdf", &bytes).unwrap();
                println!(
                    "Showcase PDF: {} bytes -> /tmp/rdocx_showcase.pdf",
                    bytes.len()
                );
            }
            Err(e) => println!("Showcase PDF failed: {e}"),
        },
        Err(e) => println!("Failed to open showcase: {e}"),
    }
}

examples/template_replace.rs (line 44)

fn create_template(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );

    doc.set_header("{{company_name}} — Confidential");
    doc.set_footer("Prepared by {{author_name}} on {{date}}");

    // ── Title ──
    doc.add_paragraph("{{company_name}}")
        .style("Heading1")
        .alignment(Alignment::Center);

    doc.add_paragraph("Project Proposal")
        .alignment(Alignment::Center);

    doc.add_paragraph("");

    // ── Summary section ──
    doc.add_paragraph("Executive Summary").style("Heading2");

    doc.add_paragraph(
        "This proposal outlines the {{project_name}} project for {{company_name}}. \
         The primary contact is {{contact_name}} ({{contact_email}}). \
         The proposed start date is {{start_date}} with an estimated duration of {{duration}}.",
    );

    doc.add_paragraph("");

    // ── Cross-run placeholder (bold label + normal value) ──
    doc.add_paragraph("Key Details").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Project: ").bold(true);
        p.add_run("{{project_name}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Budget: ").bold(true);
        p.add_run("{{budget}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Status: ").bold(true);
        p.add_run("{{status}}");
    }

    doc.add_paragraph("");

    // ── Table with placeholders ──
    doc.add_paragraph("Team Members").style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        // Header row
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Email");

        tbl.cell(1, 0).unwrap().set_text("{{member1_name}}");
        tbl.cell(1, 1).unwrap().set_text("{{member1_role}}");
        tbl.cell(1, 2).unwrap().set_text("{{member1_email}}");

        tbl.cell(2, 0).unwrap().set_text("{{member2_name}}");
        tbl.cell(2, 1).unwrap().set_text("{{member2_role}}");
        tbl.cell(2, 2).unwrap().set_text("{{member2_email}}");

        tbl.cell(3, 0).unwrap().set_text("{{member3_name}}");
        tbl.cell(3, 1).unwrap().set_text("{{member3_role}}");
        tbl.cell(3, 2).unwrap().set_text("{{member3_email}}");
    }

    doc.add_paragraph("");

    // ── Deliverables section ──
    doc.add_paragraph("Deliverables").style("Heading2");

    doc.add_paragraph("INSERTION_POINT");

    doc.add_paragraph("");

    // ── Signature block ──
    doc.add_paragraph("Acceptance").style("Heading2");

    doc.add_paragraph(
        "By signing below, {{company_name}} agrees to the terms outlined in this proposal.",
    );

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer: ___________________");
        tbl.cell(0, 1)
            .unwrap()
            .set_text("Provider: ___________________");
        tbl.cell(1, 0).unwrap().set_text("Date: {{date}}");
        tbl.cell(1, 1).unwrap().set_text("Date: {{date}}");
    }

    doc.set_title("{{company_name}} — Project Proposal Template");
    doc.set_author("Template Generator");

    doc.save(path).unwrap();
}

examples/header_banner.rs (line 30)

fn generate_header_banner_doc(path: &Path) {
    let mut doc = Document::new();

    // Page setup with extra top margin for the banner
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::twips(2292), // top — extra tall for header banner
        Length::twips(1440), // right
        Length::twips(1440), // bottom
        Length::twips(1440), // left
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Generate a simple logo image (white text on transparent background)
    let logo_img = create_logo_png(220, 48);

    // ── Dark blue banner ──
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1A3C6E",
            banner_width: 7772400, // full page width in EMU (~8.5")
            banner_height: 969026, // banner height in EMU (~1.06")
            logo_width: 2011680,   // logo display width (~2.2")
            logo_height: 438912,   // logo display height (~0.48")
            logo_x_offset: 295125, // left padding
            logo_y_offset: 265057, // vertical centering
        },
    );

    doc.set_raw_header_with_images(
        banner.clone(),
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );

    // Use a different first page header (same banner, different color)
    doc.set_different_first_page(true);
    let first_page_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "2E75B6", // lighter blue for cover
            banner_width: 7772400,
            banner_height: 969026,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 265057,
        },
    );
    doc.set_raw_header_with_images(
        first_page_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );

    // Footer
    doc.set_footer("Confidential — Internal Use Only");

    // ── Page 1: Cover ──
    doc.add_paragraph("Company Report").style("Heading1");

    doc.add_paragraph(
        "This document demonstrates a custom header banner built with DrawingML \
         group shapes. The banner uses a colored rectangle with a logo image overlaid, \
         positioned at the top of each page.",
    );

    doc.add_paragraph("");

    doc.add_paragraph("How the Header Banner Works")
        .style("Heading2");

    doc.add_paragraph(
        "The header banner is built using set_raw_header_with_images(), which \
         accepts raw XML and a list of (rel_id, image_data, filename) tuples. \
         The XML uses a DrawingML group shape (wpg:wgp) containing:",
    );

    doc.add_bullet_list_item(
        "A wps:wsp rectangle shape with a solid color fill (the background bar)",
        0,
    );
    doc.add_bullet_list_item(
        "A pic:pic image element positioned within the group (the logo)",
        0,
    );
    doc.add_bullet_list_item(
        "The group is wrapped in a wp:anchor element for absolute page positioning",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Customization").style("Heading2");

    doc.add_paragraph(
        "All dimensions are in EMU (English Metric Units) where 914400 EMU = 1 inch. \
         You can customize:",
    );

    doc.add_bullet_list_item("bg_color — any hex color for the rectangle background", 0);
    doc.add_bullet_list_item("banner_width / banner_height — size of the full banner", 0);
    doc.add_bullet_list_item("logo_width / logo_height — display size of the logo", 0);
    doc.add_bullet_list_item(
        "logo_x_offset / logo_y_offset — logo position within the banner",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Different First Page").style("Heading2");

    doc.add_paragraph(
        "This page uses a lighter blue banner (first page header). \
         Subsequent pages use a darker blue banner (default header). \
         Use set_different_first_page(true) to enable this.",
    );

    // ── Page 2 ──
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("Second Page").style("Heading1");

    doc.add_paragraph(
        "This page shows the default header banner (dark blue). The first page \
         had a lighter blue banner because we set a different first-page header.",
    );

    doc.add_paragraph("");

    doc.add_paragraph(
        "The banner repeats on every page because it is placed in the header part. \
         You can have different banners for default, first-page, and even-page headers.",
    );

    doc.set_title("Header Banner Example");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/styled_tables.rs (line 25)

fn generate_styled_tables(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );

    doc.add_paragraph("Styled Tables Showcase")
        .style("Heading1");

    doc.add_paragraph("");

    // =========================================================================
    // 1. Professional report table with alternating rows
    // =========================================================================
    doc.add_paragraph("1. Report Table with Alternating Row Colors")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 4);
        tbl = tbl.borders(BorderStyle::Single, 2, "BFBFBF");
        tbl = tbl.width_pct(100.0);

        // Header row
        let headers = ["Product", "Q1 Sales", "Q2 Sales", "Growth"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().shading("2E75B6");
            tbl.cell(0, col).unwrap().set_text(h);
        }
        tbl.row(0).unwrap().header();

        // Data with alternating shading
        let data = [
            ["Enterprise Suite", "$245,000", "$312,000", "+27.3%"],
            ["Professional", "$189,000", "$201,000", "+6.3%"],
            ["Starter Pack", "$67,000", "$84,500", "+26.1%"],
            ["Add-ons", "$34,000", "$41,200", "+21.2%"],
            ["Training", "$22,000", "$28,900", "+31.4%"],
            ["Support Plans", "$56,000", "$62,300", "+11.3%"],
        ];

        for (i, row) in data.iter().enumerate() {
            let row_idx = i + 1;
            for (col, val) in row.iter().enumerate() {
                tbl.cell(row_idx, col).unwrap().set_text(val);
                // Alternate row colors
                if i % 2 == 0 {
                    tbl.cell(row_idx, col).unwrap().shading("F2F7FB");
                }
            }
        }

        // Total row
        tbl.cell(7, 0).unwrap().set_text("TOTAL");
        tbl.cell(7, 0).unwrap().shading("D6E4F0");
        tbl.cell(7, 1).unwrap().set_text("$613,000");
        tbl.cell(7, 1).unwrap().shading("D6E4F0");
        tbl.cell(7, 2).unwrap().set_text("$729,900");
        tbl.cell(7, 2).unwrap().shading("D6E4F0");
        tbl.cell(7, 3).unwrap().set_text("+19.1%");
        tbl.cell(7, 3).unwrap().shading("D6E4F0");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 2. Invoice-style table with merged header
    // =========================================================================
    doc.add_paragraph("2. Invoice Table with Merged Header & Row Spans")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(7, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Merged title row
        tbl.cell(0, 0).unwrap().set_text("INVOICE #2026-0042");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("1F4E79");

        // Column headers
        let headers = ["Item", "Description", "Qty", "Amount"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(1, col).unwrap().set_text(h);
            tbl.cell(1, col).unwrap().shading("D6E4F0");
        }

        // Line items
        tbl.cell(2, 0).unwrap().set_text("LIC-ENT-500");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Enterprise License (500 seats)");
        tbl.cell(2, 2).unwrap().set_text("1");
        tbl.cell(2, 3).unwrap().set_text("$60,000");

        tbl.cell(3, 0).unwrap().set_text("SVC-IMPL");
        tbl.cell(3, 1).unwrap().set_text("Implementation Services");
        tbl.cell(3, 2).unwrap().set_text("1");
        tbl.cell(3, 3).unwrap().set_text("$25,000");

        tbl.cell(4, 0).unwrap().set_text("SVC-TRAIN");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("On-site Training (3 days)");
        tbl.cell(4, 2).unwrap().set_text("1");
        tbl.cell(4, 3).unwrap().set_text("$4,500");

        // Subtotal
        tbl.cell(5, 0).unwrap().set_text("Subtotal");
        tbl.cell(5, 0).unwrap().grid_span(3);
        tbl.cell(5, 0).unwrap().shading("F2F2F2");
        tbl.cell(5, 3).unwrap().set_text("$89,500");
        tbl.cell(5, 3).unwrap().shading("F2F2F2");

        // Total
        tbl.cell(6, 0).unwrap().set_text("TOTAL DUE");
        tbl.cell(6, 0).unwrap().grid_span(3);
        tbl.cell(6, 0).unwrap().shading("1F4E79");
        tbl.cell(6, 3).unwrap().set_text("$89,500");
        tbl.cell(6, 3).unwrap().shading("1F4E79");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 3. Specification table with vertical merge
    // =========================================================================
    doc.add_paragraph("3. Specification Table with Vertical Merges")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Specification");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Value");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        // "Hardware" spans 3 rows
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 0).unwrap().shading("E2EFDA");
        tbl.cell(1, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(1, 1).unwrap().set_text("Processor");
        tbl.cell(1, 2).unwrap().set_text("Intel Xeon E-2388G");

        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Memory");
        tbl.cell(2, 2).unwrap().set_text("64 GB DDR4 ECC");

        tbl.cell(3, 0).unwrap().v_merge_continue();
        tbl.cell(3, 1).unwrap().set_text("Storage");
        tbl.cell(3, 2).unwrap().set_text("2x 1TB NVMe SSD (RAID 1)");

        // "Network" spans 2 rows
        tbl.cell(4, 0).unwrap().set_text("Network");
        tbl.cell(4, 0).unwrap().v_merge_restart();
        tbl.cell(4, 0).unwrap().shading("FCE4D6");
        tbl.cell(4, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(4, 1).unwrap().set_text("Ethernet");
        tbl.cell(4, 2).unwrap().set_text("4x 10GbE SFP+");

        tbl.cell(5, 0).unwrap().v_merge_continue();
        tbl.cell(5, 1).unwrap().set_text("Management");
        tbl.cell(5, 2).unwrap().set_text("1x 1GbE IPMI");

        // "Software" spans 2 rows
        tbl.cell(6, 0).unwrap().set_text("Software");
        tbl.cell(6, 0).unwrap().v_merge_restart();
        tbl.cell(6, 0).unwrap().shading("D6E4F0");
        tbl.cell(6, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(6, 1).unwrap().set_text("Operating System");
        tbl.cell(6, 2).unwrap().set_text("Ubuntu 24.04 LTS");

        tbl.cell(7, 0).unwrap().v_merge_continue();
        tbl.cell(7, 1).unwrap().set_text("Monitoring");
        tbl.cell(7, 2).unwrap().set_text("Prometheus + Grafana");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 4. Nested table (table inside a cell)
    // =========================================================================
    doc.add_paragraph("4. Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");
        tbl = tbl.width_pct(100.0);
        tbl = tbl.cell_margins(
            Length::twips(72),
            Length::twips(108),
            Length::twips(72),
            Length::twips(108),
        );

        tbl.cell(0, 0).unwrap().set_text("Project Alpha");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Project Beta");
        tbl.cell(0, 1).unwrap().shading("2E75B6");

        // Nested table in cell (1,0)
        {
            let mut cell = tbl.cell(1, 0).unwrap();
            cell.set_text("Milestones:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "70AD47");
            inner.cell(0, 0).unwrap().set_text("Phase");
            inner.cell(0, 0).unwrap().shading("E2EFDA");
            inner.cell(0, 1).unwrap().set_text("Status");
            inner.cell(0, 1).unwrap().shading("E2EFDA");
            inner.cell(1, 0).unwrap().set_text("Design");
            inner.cell(1, 1).unwrap().set_text("Complete");
            inner.cell(2, 0).unwrap().set_text("Build");
            inner.cell(2, 1).unwrap().set_text("In Progress");
        }

        // Nested table in cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Budget:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "ED7D31");
            inner.cell(0, 0).unwrap().set_text("Category");
            inner.cell(0, 0).unwrap().shading("FCE4D6");
            inner.cell(0, 1).unwrap().set_text("Amount");
            inner.cell(0, 1).unwrap().shading("FCE4D6");
            inner.cell(1, 0).unwrap().set_text("Development");
            inner.cell(1, 1).unwrap().set_text("$120,000");
            inner.cell(2, 0).unwrap().set_text("Testing");
            inner.cell(2, 1).unwrap().set_text("$35,000");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 5. Form-style table with labels
    // =========================================================================
    doc.add_paragraph("5. Form-Style Table").style("Heading2");

    {
        let mut tbl = doc.add_table(6, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "808080");
        tbl = tbl.width_pct(100.0);

        // Row 0: Full-width title
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer Registration Form");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("404040");

        // Row 1: Name fields
        tbl.cell(1, 0).unwrap().set_text("First Name");
        tbl.cell(1, 0).unwrap().shading("E8E8E8");
        tbl.cell(1, 1).unwrap().set_text("John");
        tbl.cell(1, 2).unwrap().set_text("Last Name");
        tbl.cell(1, 2).unwrap().shading("E8E8E8");
        tbl.cell(1, 3).unwrap().set_text("Smith");

        // Row 2: Contact
        tbl.cell(2, 0).unwrap().set_text("Email");
        tbl.cell(2, 0).unwrap().shading("E8E8E8");
        tbl.cell(2, 1).unwrap().set_text("john.smith@example.com");
        tbl.cell(2, 1).unwrap().grid_span(3);

        // Row 3: Phone
        tbl.cell(3, 0).unwrap().set_text("Phone");
        tbl.cell(3, 0).unwrap().shading("E8E8E8");
        tbl.cell(3, 1).unwrap().set_text("+1 (555) 123-4567");
        tbl.cell(3, 2).unwrap().set_text("Company");
        tbl.cell(3, 2).unwrap().shading("E8E8E8");
        tbl.cell(3, 3).unwrap().set_text("Acme Corp");

        // Row 4: Address (spanning)
        tbl.cell(4, 0).unwrap().set_text("Address");
        tbl.cell(4, 0).unwrap().shading("E8E8E8");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("123 Business Ave, Suite 400, Portland, OR 97201");
        tbl.cell(4, 1).unwrap().grid_span(3);

        // Row 5: Notes
        tbl.cell(5, 0).unwrap().set_text("Notes");
        tbl.cell(5, 0).unwrap().shading("E8E8E8");
        tbl.cell(5, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top);
        {
            let mut cell = tbl.cell(5, 1).unwrap().grid_span(3);
            cell.set_text("Premium customer since 2020. Preferred contact method: email.");
            cell.add_paragraph("Annual review scheduled for March 2026.");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 6. Comparison table with border styles
    // =========================================================================
    doc.add_paragraph("6. Comparison Table with Custom Borders")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(5, 3);
        tbl = tbl.borders(BorderStyle::Double, 4, "2E75B6");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Feature");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Basic Plan");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Enterprise Plan");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        tbl.cell(1, 0).unwrap().set_text("Users");
        tbl.cell(1, 1).unwrap().set_text("Up to 10");
        tbl.cell(1, 2).unwrap().set_text("Unlimited");
        tbl.cell(1, 2).unwrap().shading("E2EFDA");

        tbl.cell(2, 0).unwrap().set_text("Storage");
        tbl.cell(2, 1).unwrap().set_text("50 GB");
        tbl.cell(2, 2).unwrap().set_text("5 TB");
        tbl.cell(2, 2).unwrap().shading("E2EFDA");

        tbl.cell(3, 0).unwrap().set_text("Support");
        tbl.cell(3, 1).unwrap().set_text("Email only");
        tbl.cell(3, 2).unwrap().set_text("24/7 Phone + Email");
        tbl.cell(3, 2).unwrap().shading("E2EFDA");

        tbl.cell(4, 0).unwrap().set_text("Price");
        tbl.cell(4, 0).unwrap().shading("F2F2F2");
        tbl.cell(4, 1).unwrap().set_text("$29/month");
        tbl.cell(4, 1).unwrap().shading("F2F2F2");
        tbl.cell(4, 2).unwrap().set_text("$199/month");
        tbl.cell(4, 2).unwrap().shading("C6EFCE");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 7. Wide table with fixed layout and row height
    // =========================================================================
    doc.add_paragraph("7. Fixed Layout Table with Row Height Control")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 5);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width(Length::inches(7.0));
        tbl = tbl.layout_fixed();

        // Set column widths
        for col in 0..5 {
            tbl.cell(0, col).unwrap().width(Length::inches(1.4));
        }

        // Header with exact height
        tbl.row(0).unwrap().height_exact(Length::twips(480));
        tbl.row(0).unwrap().header();
        tbl.row(0).unwrap().cant_split();

        let headers = ["Mon", "Tue", "Wed", "Thu", "Fri"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("404040");
            tbl.cell(0, col)
                .unwrap()
                .vertical_alignment(VerticalAlignment::Center);
        }

        // Schedule rows with minimum height
        tbl.row(1).unwrap().height(Length::twips(600));
        tbl.cell(1, 0).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 1).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 2).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 3).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 4).unwrap().set_text("9:00 Standup");

        tbl.row(2).unwrap().height(Length::twips(600));
        tbl.cell(2, 0).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 0).unwrap().shading("D6E4F0");
        tbl.cell(2, 1).unwrap().set_text("10:00 Design Review");
        tbl.cell(2, 1).unwrap().shading("FCE4D6");
        tbl.cell(2, 2).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 2).unwrap().shading("D6E4F0");
        tbl.cell(2, 3).unwrap().set_text("10:00 Sprint Planning");
        tbl.cell(2, 3).unwrap().shading("E2EFDA");
        tbl.cell(2, 4).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 4).unwrap().shading("D6E4F0");

        tbl.row(3).unwrap().height(Length::twips(600));
        tbl.cell(3, 0).unwrap().set_text("14:00 Code Review");
        tbl.cell(3, 1).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 1).unwrap().shading("D6E4F0");
        tbl.cell(3, 2).unwrap().set_text("14:00 Demo");
        tbl.cell(3, 2).unwrap().shading("FCE4D6");
        tbl.cell(3, 3).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 3).unwrap().shading("D6E4F0");
        tbl.cell(3, 4).unwrap().set_text("14:00 Retro");
        tbl.cell(3, 4).unwrap().shading("E2EFDA");
    }

    doc.set_title("Styled Tables Showcase");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/generate_all_samples.rs (line 98)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

// =============================================================================
// 6. LETTER — Slate blue + silver scheme
// =============================================================================
fn generate_letter(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Slate #4A5568, Blue accent #3182CE
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
    );
    doc.set_title("Business Letter");
    doc.set_author("Walter White");

    // Banner header using raw XML
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "4A5568",
            banner_width: 7772400,
            banner_height: 731520, // ~0.8"
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 146304,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_margins(
        Length::twips(2000),
        Length::twips(1800),
        Length::twips(1440),
        Length::twips(1800),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Footer with contact
    doc.set_footer(
        "Tensorbee | 123 Innovation Drive, Suite 400 | San Francisco, CA 94105 | tensorbee.com",
    );

    // ── Sender Address ──
    doc.add_paragraph("Walter White");
    doc.add_paragraph("Chief Executive Officer");
    doc.add_paragraph("Tensorbee");
    doc.add_paragraph("123 Innovation Drive, Suite 400");
    doc.add_paragraph("San Francisco, CA 94105");
    doc.add_paragraph("");
    doc.add_paragraph("February 22, 2026");

    doc.add_paragraph("");

    // ── Recipient ──
    doc.add_paragraph("Ms. Sarah Chen");
    doc.add_paragraph("VP of Engineering");
    doc.add_paragraph("Meridian Dynamics LLC");
    doc.add_paragraph("456 Enterprise Boulevard");
    doc.add_paragraph("Austin, TX 78701");

    doc.add_paragraph("");

    // ── Subject ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Re: Strategic Technology Partnership — Phase 2 Expansion")
            .bold(true);
    }

    doc.add_paragraph("");

    // ── Body ──
    doc.add_paragraph("Dear Ms. Chen,");
    doc.add_paragraph("");

    doc.add_paragraph(
        "I am writing to express Tensorbee's enthusiasm for expanding our strategic technology \
         partnership with Meridian Dynamics. Following the successful completion of Phase 1, \
         which delivered a 40% improvement in your ML inference pipeline throughput, we believe \
         the foundation is firmly established for an ambitious Phase 2 engagement.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "During our recent executive review, your team highlighted three priority areas for \
         the next phase of collaboration:",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_numbered_list_item(
        "Real-time anomaly detection for your financial transaction monitoring system, \
         targeting sub-100ms latency at 50,000 transactions per second.",
        0,
    );
    doc.add_numbered_list_item(
        "Federated learning infrastructure to enable model training across your distributed \
         data centers without centralizing sensitive financial data.",
        0,
    );
    doc.add_numbered_list_item(
        "MLOps automation to reduce your model deployment cycle from the current 5 days \
         to under 4 hours.",
        0,
    );

    doc.add_paragraph(
        "Our engineering team has prepared a detailed technical proposal addressing each of \
         these areas. We have allocated a dedicated team of eight senior engineers, led by \
         our CTO, to ensure continuity with the Phase 1 team your organization has already \
         built a productive working relationship with.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "I would welcome the opportunity to present our Phase 2 proposal in person. My \
         assistant will reach out to coordinate a meeting at your convenience during the \
         first week of March.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("");

    doc.add_paragraph("Warm regards,");
    doc.add_paragraph("");
    doc.add_paragraph("");

    // Signature line
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "4A5568");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Walter White").bold(true).size(12.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Chief Executive Officer, Tensorbee")
            .italic(true)
            .size(10.0)
            .color("666666");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("walter@tensorbee.com | +1 (415) 555-0199")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 7. EMPLOYMENT CONTRACT — Purple + charcoal scheme
// =============================================================================
fn generate_contract(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Purple #5B2C6F, Plum #8E44AD, Gray #2C3E50
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Employment Agreement");
    doc.set_author("Tensorbee HR Department");
    doc.set_subject("Employment Contract — Walter White");
    doc.set_keywords("employment, contract, agreement, Tensorbee");

    doc.set_header("TENSORBEE — Employment Agreement");
    doc.set_footer("Employment Agreement — Walter White — Page");

    // ── Title Block ──
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("EMPLOYMENT AGREEMENT")
            .bold(true)
            .size(24.0)
            .color("5B2C6F")
            .font("Georgia");
    }
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    doc.add_paragraph("");

    // ── Parties ──
    doc.add_paragraph(
        "This Employment Agreement (\"Agreement\") is entered into as of February 22, 2026 \
         (\"Effective Date\"), by and between:",
    );

    doc.add_paragraph("");

    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYER: ").bold(true);
        p.add_run(
            "Tensorbee, Inc., a Delaware corporation with its principal place of business at \
                   123 Innovation Drive, Suite 400, San Francisco, CA 94105 (\"Company\")",
        );
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYEE: ").bold(true);
        p.add_run(
            "Walter White, residing at 308 Negra Arroyo Lane, Albuquerque, NM 87104 (\"Employee\")",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph("The Company and Employee are collectively referred to as the \"Parties.\"");
    doc.add_paragraph("");

    // ── Article 1: Position and Duties ──
    doc.add_paragraph("Article 1 — Position and Duties")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.1 ").bold(true);
        p.add_run("The Company hereby employs the Employee as ");
        p.add_run("Chief Executive Officer (CEO)")
            .bold(true)
            .italic(true);
        p.add_run(", reporting directly to the Board of Directors.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.2 ").bold(true);
        p.add_run("The Employee shall devote full working time, attention, and best efforts to \
                   the performance of duties as reasonably assigned by the Board, including but not limited to:");
    }
    doc.add_bullet_list_item(
        "Setting and executing the Company's strategic vision and business plan",
        0,
    );
    doc.add_bullet_list_item(
        "Overseeing all operations, engineering, and commercial activities",
        0,
    );
    doc.add_bullet_list_item(
        "Representing the Company to investors, customers, and the public",
        0,
    );
    doc.add_bullet_list_item("Recruiting, developing, and retaining key talent", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.3 ").bold(true);
        p.add_run(
            "The Employee's primary work location shall be the Company's San Francisco \
                   headquarters, with reasonable travel as required by business needs.",
        );
    }

    // ── Article 2: Compensation ──
    doc.add_paragraph("Article 2 — Compensation and Benefits")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.1 Base Salary. ").bold(true);
        p.add_run("The Company shall pay the Employee an annual base salary of ");
        p.add_run("$375,000.00").bold(true);
        p.add_run(" (Three Hundred Seventy-Five Thousand Dollars), payable in accordance with the \
                   Company's standard payroll schedule, less applicable withholdings and deductions.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.2 Annual Bonus. ").bold(true);
        p.add_run("The Employee shall be eligible for an annual performance bonus of up to ");
        p.add_run("40%").bold(true);
        p.add_run(
            " of base salary, based on achievement of mutually agreed performance objectives.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.3 Equity. ").bold(true);
        p.add_run("Subject to Board approval, the Employee shall receive a stock option grant of ");
        p.add_run("500,000 shares").bold(true);
        p.add_run(
            " of the Company's common stock, vesting over four (4) years with a one-year cliff, \
                   at an exercise price equal to the fair market value on the date of grant.",
        );
    }

    // Compensation summary table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "5B2C6F")
            .width_pct(70.0)
            .alignment(Alignment::Center);
        tbl.cell(0, 0).unwrap().set_text("Compensation Element");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");
        let items = [
            ("Base Salary", "$375,000/year"),
            ("Target Bonus", "Up to 40% ($150,000)"),
            ("Equity Grant", "500,000 shares (4yr vest)"),
            ("Total Target Comp", "$525,000 + equity"),
        ];
        for (i, (elem, val)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(elem);
            tbl.cell(i + 1, 1).unwrap().set_text(val);
            if i == 3 {
                tbl.cell(i + 1, 0).unwrap().shading("E8DAEF");
                tbl.cell(i + 1, 1).unwrap().shading("E8DAEF");
            }
        }
    }

    // ── Article 3: Benefits ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Article 3 — Benefits").style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.1 ").bold(true);
        p.add_run(
            "The Employee shall be entitled to participate in all benefit programs \
                   generally available to senior executives, including:",
        );
    }
    doc.add_bullet_list_item(
        "Medical, dental, and vision insurance (100% premium coverage for employee and dependents)",
        0,
    );
    doc.add_bullet_list_item("401(k) retirement plan with 6% company match", 0);
    doc.add_bullet_list_item("Life insurance and long-term disability coverage", 0);
    doc.add_bullet_list_item("Annual professional development allowance of $10,000", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.2 Paid Time Off. ").bold(true);
        p.add_run(
            "The Employee shall receive 25 days of paid vacation per year, plus Company holidays, \
                   accruing on a monthly basis.",
        );
    }

    // ── Article 4: Term and Termination ──
    doc.add_paragraph("Article 4 — Term and Termination")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.1 At-Will Employment. ").bold(true);
        p.add_run(
            "This Agreement is for at-will employment and may be terminated by either Party \
                   at any time, with or without cause, subject to the notice provisions herein.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.2 Notice Period. ").bold(true);
        p.add_run("Either Party shall provide ");
        p.add_run("ninety (90) days").bold(true);
        p.add_run(" written notice of termination, or pay in lieu thereof.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.3 Severance. ").bold(true);
        p.add_run("In the event of termination by the Company without Cause, the Employee shall \
                   receive (a) twelve (12) months of base salary continuation, (b) pro-rata bonus \
                   for the year of termination, and (c) twelve (12) months of COBRA premium coverage.");
    }

    // ── Article 5: Confidentiality ──
    doc.add_paragraph("Article 5 — Confidentiality and IP")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.1 ").bold(true);
        p.add_run(
            "The Employee agrees to maintain strict confidentiality of all proprietary \
                   information, trade secrets, and business plans of the Company during and after \
                   employment.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.2 ").bold(true);
        p.add_run(
            "All intellectual property, inventions, and works of authorship created by the \
                   Employee during the term of employment and within the scope of duties shall be \
                   the sole and exclusive property of the Company.",
        );
    }

    // ── Article 6: Non-Compete ──
    doc.add_paragraph("Article 6 — Non-Competition")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("6.1 ").bold(true);
        p.add_run("For a period of twelve (12) months following termination, the Employee agrees \
                   not to engage in any business that directly competes with the Company's core \
                   business of AI infrastructure and ML operations services, within the United States.");
    }

    // ── Article 7: General Provisions ──
    doc.add_paragraph("Article 7 — General Provisions")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.1 Governing Law. ").bold(true);
        p.add_run(
            "This Agreement shall be governed by and construed in accordance with the laws of \
                   the State of California.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.2 Entire Agreement. ").bold(true);
        p.add_run(
            "This Agreement constitutes the entire agreement between the Parties and supersedes \
                   all prior negotiations, representations, and agreements.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.3 Amendment. ").bold(true);
        p.add_run(
            "This Agreement may only be amended by a written instrument signed by both Parties.",
        );
    }

    // ── Signature Block ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("IN WITNESS WHEREOF, the Parties have executed this Employment Agreement as of the Effective Date.")
        .space_after(Length::pt(24.0));

    // Signature table
    {
        let mut tbl = doc.add_table(6, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("FOR THE COMPANY:");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("EMPLOYEE:");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");

        tbl.cell(1, 0).unwrap().set_text("");
        tbl.cell(1, 1).unwrap().set_text("");
        tbl.row(1).unwrap().height(Length::pt(40.0));

        tbl.cell(2, 0)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(3, 0)
            .unwrap()
            .set_text("Name: Board Representative");
        tbl.cell(3, 1).unwrap().set_text("Name: Walter White");
        tbl.cell(4, 0)
            .unwrap()
            .set_text("Title: Chair, Board of Directors");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Title: Chief Executive Officer");
        tbl.cell(5, 0).unwrap().set_text("Date: _______________");
        tbl.cell(5, 1).unwrap().set_text("Date: _______________");
    }

    doc
}

pub fn open<P: AsRef<Path>>(path: P) -> Result<Self>

Open a document from a file path.

Examples found in repository

examples/convert_html_md.rs (line 4)

fn main() {
    let doc = Document::open("samples/feature_showcase.docx").expect("Failed to open document");

    let html = doc.to_html();
    std::fs::write("/tmp/feature_showcase.html", &html).expect("Failed to write HTML");
    println!("HTML: {} bytes -> /tmp/feature_showcase.html", html.len());

    let md = doc.to_markdown();
    std::fs::write("/tmp/feature_showcase.md", &md).expect("Failed to write Markdown");
    println!("Markdown: {} bytes -> /tmp/feature_showcase.md", md.len());

    // Simple document
    let mut simple = Document::new();
    simple.add_paragraph("Hello, World!");
    let html = simple.to_html();
    println!("\n--- Simple HTML ---\n{html}");

    let md = simple.to_markdown();
    println!("--- Simple Markdown ---\n{md}");
}

examples/generate_pdf.rs (line 60)

fn main() {
    // Test 1: Simple document
    let doc = Document::new();
    match doc.to_pdf() {
        Ok(bytes) => {
            std::fs::write("/tmp/rdocx_simple.pdf", &bytes).unwrap();
            println!("Simple PDF: {} bytes -> /tmp/rdocx_simple.pdf", bytes.len());
        }
        Err(e) => println!("Simple PDF failed: {e}"),
    }

    // Test 2: Document with content
    let mut doc = Document::new();
    doc.set_title("Test PDF Document");
    doc.set_author("rdocx-pdf");
    doc.add_paragraph("Chapter 1: Introduction")
        .style("Heading1");
    doc.add_paragraph(
        "This is a test document generated by rdocx and rendered to PDF. \
         It demonstrates text rendering with proper font shaping and pagination.",
    );
    doc.add_paragraph("Section 1.1").style("Heading2");
    doc.add_paragraph("More content in a sub-section.");

    {
        let mut table = doc.add_table(2, 3);
        for r in 0..2 {
            for c in 0..3 {
                if let Some(mut cell) = table.cell(r, c) {
                    cell.set_text(&format!("R{}C{}", r + 1, c + 1));
                }
            }
        }
    }

    doc.add_paragraph("After the table.");

    match doc.to_pdf() {
        Ok(bytes) => {
            std::fs::write("/tmp/rdocx_content.pdf", &bytes).unwrap();
            println!(
                "Content PDF: {} bytes -> /tmp/rdocx_content.pdf",
                bytes.len()
            );
        }
        Err(e) => println!("Content PDF failed: {e}"),
    }

    // Test 3: From feature_showcase.docx
    let showcase_path = concat!(
        env!("CARGO_MANIFEST_DIR"),
        "/../../samples/feature_showcase.docx"
    );
    match Document::open(showcase_path) {
        Ok(doc) => match doc.to_pdf() {
            Ok(bytes) => {
                std::fs::write("/tmp/rdocx_showcase.pdf", &bytes).unwrap();
                println!(
                    "Showcase PDF: {} bytes -> /tmp/rdocx_showcase.pdf",
                    bytes.len()
                );
            }
            Err(e) => println!("Showcase PDF failed: {e}"),
        },
        Err(e) => println!("Failed to open showcase: {e}"),
    }
}

examples/template_replace.rs (line 163)

fn fill_template(template_path: &Path, output_path: &Path) {
    let mut doc = Document::open(template_path).unwrap();

    // ── Batch replacement ──
    let mut replacements = HashMap::new();
    replacements.insert("{{company_name}}", "Riverside Medical Center");
    replacements.insert("{{project_name}}", "Network Security Upgrade");
    replacements.insert("{{contact_name}}", "Dr. Sarah Chen");
    replacements.insert("{{contact_email}}", "s.chen@riverside.org");
    replacements.insert("{{start_date}}", "March 1, 2026");
    replacements.insert("{{duration}}", "12 weeks");
    replacements.insert("{{budget}}", "$185,000");
    replacements.insert("{{status}}", "Pending Approval");
    replacements.insert("{{author_name}}", "James Wilson");
    replacements.insert("{{date}}", "February 22, 2026");

    // Team members
    replacements.insert("{{member1_name}}", "James Wilson");
    replacements.insert("{{member1_role}}", "Project Lead");
    replacements.insert("{{member1_email}}", "j.wilson@provider.com");
    replacements.insert("{{member2_name}}", "Maria Garcia");
    replacements.insert("{{member2_role}}", "Security Architect");
    replacements.insert("{{member2_email}}", "m.garcia@provider.com");
    replacements.insert("{{member3_name}}", "David Park");
    replacements.insert("{{member3_role}}", "Network Engineer");
    replacements.insert("{{member3_email}}", "d.park@provider.com");

    let count = doc.replace_all(&replacements);
    println!("  Replaced {} placeholders", count);

    // ── Insert deliverables at the insertion point ──
    if let Some(idx) = doc.find_content_index("INSERTION_POINT") {
        // Remove the placeholder paragraph
        doc.remove_content(idx);

        // Insert deliverables list
        doc.insert_paragraph(idx, "The following deliverables are included:");

        // Insert a deliverables table
        let mut tbl = doc.insert_table(idx + 1, 5, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("E2EFDA");
        }
        tbl.cell(0, 0).unwrap().set_text("Phase");
        tbl.cell(0, 1).unwrap().set_text("Description");
        tbl.cell(0, 2).unwrap().set_text("Timeline");

        tbl.cell(1, 0).unwrap().set_text("1. Discovery");
        tbl.cell(1, 1)
            .unwrap()
            .set_text("Network assessment and asset inventory");
        tbl.cell(1, 2).unwrap().set_text("Weeks 1-3");

        tbl.cell(2, 0).unwrap().set_text("2. Design");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Security architecture and policy design");
        tbl.cell(2, 2).unwrap().set_text("Weeks 4-6");

        tbl.cell(3, 0).unwrap().set_text("3. Implementation");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("Deploy monitoring and access controls");
        tbl.cell(3, 2).unwrap().set_text("Weeks 7-10");

        tbl.cell(4, 0).unwrap().set_text("4. Validation");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Testing, training, and handover");
        tbl.cell(4, 2).unwrap().set_text("Weeks 11-12");

        println!("  Inserted deliverables table at position {}", idx);
    }

    // ── Update metadata ──
    doc.set_title("Riverside Medical Center — Network Security Upgrade Proposal");
    doc.set_author("James Wilson");
    doc.set_subject("Project Proposal");
    doc.set_keywords("security, network, medical, proposal");

    doc.save(output_path).unwrap();
}

pub fn from_bytes(bytes: &[u8]) -> Result<Self>

Open a document from bytes.

pub fn save<P: AsRef<Path>>(&mut self, path: P) -> Result<()>

Save the document to a file path.

Examples found in repository

examples/generate_all_samples.rs (line 63)

fn export_all(dir: &Path, name: &str, mut doc: Document) {
    let docx_path = dir.join(format!("{name}.docx"));
    doc.save(&docx_path).unwrap();
    println!("  {name}.docx");

    let png = doc
        .render_page_to_png_deterministic(0, 150.0)
        .unwrap()
        .expect("every generated sample should have a first page");
    let png_path = dir.join(format!("{name}.png"));
    std::fs::write(&png_path, &png).unwrap();
    println!("  {name}.png ({} bytes)", png.len());

    match doc.to_pdf_deterministic() {
        Ok(pdf) => {
            let pdf_path = dir.join(format!("{name}.pdf"));
            std::fs::write(&pdf_path, &pdf).unwrap();
            println!("  {name}.pdf ({} bytes)", pdf.len());
        }
        Err(e) => println!("  {name}.pdf — skipped: {e}"),
    }

    let html = doc.to_html();
    let html_path = dir.join(format!("{name}.html"));
    std::fs::write(&html_path, &html).unwrap();
    println!("  {name}.html ({} bytes)", html.len());

    let md = doc.to_markdown();
    let md_path = dir.join(format!("{name}.md"));
    std::fs::write(&md_path, &md).unwrap();
    println!("  {name}.md ({} bytes)", md.len());
}

examples/template_replace.rs (line 158)

fn create_template(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );

    doc.set_header("{{company_name}} — Confidential");
    doc.set_footer("Prepared by {{author_name}} on {{date}}");

    // ── Title ──
    doc.add_paragraph("{{company_name}}")
        .style("Heading1")
        .alignment(Alignment::Center);

    doc.add_paragraph("Project Proposal")
        .alignment(Alignment::Center);

    doc.add_paragraph("");

    // ── Summary section ──
    doc.add_paragraph("Executive Summary").style("Heading2");

    doc.add_paragraph(
        "This proposal outlines the {{project_name}} project for {{company_name}}. \
         The primary contact is {{contact_name}} ({{contact_email}}). \
         The proposed start date is {{start_date}} with an estimated duration of {{duration}}.",
    );

    doc.add_paragraph("");

    // ── Cross-run placeholder (bold label + normal value) ──
    doc.add_paragraph("Key Details").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Project: ").bold(true);
        p.add_run("{{project_name}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Budget: ").bold(true);
        p.add_run("{{budget}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Status: ").bold(true);
        p.add_run("{{status}}");
    }

    doc.add_paragraph("");

    // ── Table with placeholders ──
    doc.add_paragraph("Team Members").style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        // Header row
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Email");

        tbl.cell(1, 0).unwrap().set_text("{{member1_name}}");
        tbl.cell(1, 1).unwrap().set_text("{{member1_role}}");
        tbl.cell(1, 2).unwrap().set_text("{{member1_email}}");

        tbl.cell(2, 0).unwrap().set_text("{{member2_name}}");
        tbl.cell(2, 1).unwrap().set_text("{{member2_role}}");
        tbl.cell(2, 2).unwrap().set_text("{{member2_email}}");

        tbl.cell(3, 0).unwrap().set_text("{{member3_name}}");
        tbl.cell(3, 1).unwrap().set_text("{{member3_role}}");
        tbl.cell(3, 2).unwrap().set_text("{{member3_email}}");
    }

    doc.add_paragraph("");

    // ── Deliverables section ──
    doc.add_paragraph("Deliverables").style("Heading2");

    doc.add_paragraph("INSERTION_POINT");

    doc.add_paragraph("");

    // ── Signature block ──
    doc.add_paragraph("Acceptance").style("Heading2");

    doc.add_paragraph(
        "By signing below, {{company_name}} agrees to the terms outlined in this proposal.",
    );

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer: ___________________");
        tbl.cell(0, 1)
            .unwrap()
            .set_text("Provider: ___________________");
        tbl.cell(1, 0).unwrap().set_text("Date: {{date}}");
        tbl.cell(1, 1).unwrap().set_text("Date: {{date}}");
    }

    doc.set_title("{{company_name}} — Project Proposal Template");
    doc.set_author("Template Generator");

    doc.save(path).unwrap();
}

/// Open the template, replace all placeholders, insert content, and save.
fn fill_template(template_path: &Path, output_path: &Path) {
    let mut doc = Document::open(template_path).unwrap();

    // ── Batch replacement ──
    let mut replacements = HashMap::new();
    replacements.insert("{{company_name}}", "Riverside Medical Center");
    replacements.insert("{{project_name}}", "Network Security Upgrade");
    replacements.insert("{{contact_name}}", "Dr. Sarah Chen");
    replacements.insert("{{contact_email}}", "s.chen@riverside.org");
    replacements.insert("{{start_date}}", "March 1, 2026");
    replacements.insert("{{duration}}", "12 weeks");
    replacements.insert("{{budget}}", "$185,000");
    replacements.insert("{{status}}", "Pending Approval");
    replacements.insert("{{author_name}}", "James Wilson");
    replacements.insert("{{date}}", "February 22, 2026");

    // Team members
    replacements.insert("{{member1_name}}", "James Wilson");
    replacements.insert("{{member1_role}}", "Project Lead");
    replacements.insert("{{member1_email}}", "j.wilson@provider.com");
    replacements.insert("{{member2_name}}", "Maria Garcia");
    replacements.insert("{{member2_role}}", "Security Architect");
    replacements.insert("{{member2_email}}", "m.garcia@provider.com");
    replacements.insert("{{member3_name}}", "David Park");
    replacements.insert("{{member3_role}}", "Network Engineer");
    replacements.insert("{{member3_email}}", "d.park@provider.com");

    let count = doc.replace_all(&replacements);
    println!("  Replaced {} placeholders", count);

    // ── Insert deliverables at the insertion point ──
    if let Some(idx) = doc.find_content_index("INSERTION_POINT") {
        // Remove the placeholder paragraph
        doc.remove_content(idx);

        // Insert deliverables list
        doc.insert_paragraph(idx, "The following deliverables are included:");

        // Insert a deliverables table
        let mut tbl = doc.insert_table(idx + 1, 5, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("E2EFDA");
        }
        tbl.cell(0, 0).unwrap().set_text("Phase");
        tbl.cell(0, 1).unwrap().set_text("Description");
        tbl.cell(0, 2).unwrap().set_text("Timeline");

        tbl.cell(1, 0).unwrap().set_text("1. Discovery");
        tbl.cell(1, 1)
            .unwrap()
            .set_text("Network assessment and asset inventory");
        tbl.cell(1, 2).unwrap().set_text("Weeks 1-3");

        tbl.cell(2, 0).unwrap().set_text("2. Design");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Security architecture and policy design");
        tbl.cell(2, 2).unwrap().set_text("Weeks 4-6");

        tbl.cell(3, 0).unwrap().set_text("3. Implementation");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("Deploy monitoring and access controls");
        tbl.cell(3, 2).unwrap().set_text("Weeks 7-10");

        tbl.cell(4, 0).unwrap().set_text("4. Validation");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Testing, training, and handover");
        tbl.cell(4, 2).unwrap().set_text("Weeks 11-12");

        println!("  Inserted deliverables table at position {}", idx);
    }

    // ── Update metadata ──
    doc.set_title("Riverside Medical Center — Network Security Upgrade Proposal");
    doc.set_author("James Wilson");
    doc.set_subject("Project Proposal");
    doc.set_keywords("security, network, medical, proposal");

    doc.save(output_path).unwrap();
}

examples/header_banner.rs (line 168)

fn generate_header_banner_doc(path: &Path) {
    let mut doc = Document::new();

    // Page setup with extra top margin for the banner
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::twips(2292), // top — extra tall for header banner
        Length::twips(1440), // right
        Length::twips(1440), // bottom
        Length::twips(1440), // left
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Generate a simple logo image (white text on transparent background)
    let logo_img = create_logo_png(220, 48);

    // ── Dark blue banner ──
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1A3C6E",
            banner_width: 7772400, // full page width in EMU (~8.5")
            banner_height: 969026, // banner height in EMU (~1.06")
            logo_width: 2011680,   // logo display width (~2.2")
            logo_height: 438912,   // logo display height (~0.48")
            logo_x_offset: 295125, // left padding
            logo_y_offset: 265057, // vertical centering
        },
    );

    doc.set_raw_header_with_images(
        banner.clone(),
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );

    // Use a different first page header (same banner, different color)
    doc.set_different_first_page(true);
    let first_page_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "2E75B6", // lighter blue for cover
            banner_width: 7772400,
            banner_height: 969026,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 265057,
        },
    );
    doc.set_raw_header_with_images(
        first_page_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );

    // Footer
    doc.set_footer("Confidential — Internal Use Only");

    // ── Page 1: Cover ──
    doc.add_paragraph("Company Report").style("Heading1");

    doc.add_paragraph(
        "This document demonstrates a custom header banner built with DrawingML \
         group shapes. The banner uses a colored rectangle with a logo image overlaid, \
         positioned at the top of each page.",
    );

    doc.add_paragraph("");

    doc.add_paragraph("How the Header Banner Works")
        .style("Heading2");

    doc.add_paragraph(
        "The header banner is built using set_raw_header_with_images(), which \
         accepts raw XML and a list of (rel_id, image_data, filename) tuples. \
         The XML uses a DrawingML group shape (wpg:wgp) containing:",
    );

    doc.add_bullet_list_item(
        "A wps:wsp rectangle shape with a solid color fill (the background bar)",
        0,
    );
    doc.add_bullet_list_item(
        "A pic:pic image element positioned within the group (the logo)",
        0,
    );
    doc.add_bullet_list_item(
        "The group is wrapped in a wp:anchor element for absolute page positioning",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Customization").style("Heading2");

    doc.add_paragraph(
        "All dimensions are in EMU (English Metric Units) where 914400 EMU = 1 inch. \
         You can customize:",
    );

    doc.add_bullet_list_item("bg_color — any hex color for the rectangle background", 0);
    doc.add_bullet_list_item("banner_width / banner_height — size of the full banner", 0);
    doc.add_bullet_list_item("logo_width / logo_height — display size of the logo", 0);
    doc.add_bullet_list_item(
        "logo_x_offset / logo_y_offset — logo position within the banner",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Different First Page").style("Heading2");

    doc.add_paragraph(
        "This page uses a lighter blue banner (first page header). \
         Subsequent pages use a darker blue banner (default header). \
         Use set_different_first_page(true) to enable this.",
    );

    // ── Page 2 ──
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("Second Page").style("Heading1");

    doc.add_paragraph(
        "This page shows the default header banner (dark blue). The first page \
         had a lighter blue banner because we set a different first-page header.",
    );

    doc.add_paragraph("");

    doc.add_paragraph(
        "The banner repeats on every page because it is placed in the header part. \
         You can have different banners for default, first-page, and even-page headers.",
    );

    doc.set_title("Header Banner Example");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/styled_tables.rs (line 448)

fn generate_styled_tables(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );

    doc.add_paragraph("Styled Tables Showcase")
        .style("Heading1");

    doc.add_paragraph("");

    // =========================================================================
    // 1. Professional report table with alternating rows
    // =========================================================================
    doc.add_paragraph("1. Report Table with Alternating Row Colors")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 4);
        tbl = tbl.borders(BorderStyle::Single, 2, "BFBFBF");
        tbl = tbl.width_pct(100.0);

        // Header row
        let headers = ["Product", "Q1 Sales", "Q2 Sales", "Growth"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().shading("2E75B6");
            tbl.cell(0, col).unwrap().set_text(h);
        }
        tbl.row(0).unwrap().header();

        // Data with alternating shading
        let data = [
            ["Enterprise Suite", "$245,000", "$312,000", "+27.3%"],
            ["Professional", "$189,000", "$201,000", "+6.3%"],
            ["Starter Pack", "$67,000", "$84,500", "+26.1%"],
            ["Add-ons", "$34,000", "$41,200", "+21.2%"],
            ["Training", "$22,000", "$28,900", "+31.4%"],
            ["Support Plans", "$56,000", "$62,300", "+11.3%"],
        ];

        for (i, row) in data.iter().enumerate() {
            let row_idx = i + 1;
            for (col, val) in row.iter().enumerate() {
                tbl.cell(row_idx, col).unwrap().set_text(val);
                // Alternate row colors
                if i % 2 == 0 {
                    tbl.cell(row_idx, col).unwrap().shading("F2F7FB");
                }
            }
        }

        // Total row
        tbl.cell(7, 0).unwrap().set_text("TOTAL");
        tbl.cell(7, 0).unwrap().shading("D6E4F0");
        tbl.cell(7, 1).unwrap().set_text("$613,000");
        tbl.cell(7, 1).unwrap().shading("D6E4F0");
        tbl.cell(7, 2).unwrap().set_text("$729,900");
        tbl.cell(7, 2).unwrap().shading("D6E4F0");
        tbl.cell(7, 3).unwrap().set_text("+19.1%");
        tbl.cell(7, 3).unwrap().shading("D6E4F0");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 2. Invoice-style table with merged header
    // =========================================================================
    doc.add_paragraph("2. Invoice Table with Merged Header & Row Spans")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(7, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Merged title row
        tbl.cell(0, 0).unwrap().set_text("INVOICE #2026-0042");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("1F4E79");

        // Column headers
        let headers = ["Item", "Description", "Qty", "Amount"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(1, col).unwrap().set_text(h);
            tbl.cell(1, col).unwrap().shading("D6E4F0");
        }

        // Line items
        tbl.cell(2, 0).unwrap().set_text("LIC-ENT-500");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Enterprise License (500 seats)");
        tbl.cell(2, 2).unwrap().set_text("1");
        tbl.cell(2, 3).unwrap().set_text("$60,000");

        tbl.cell(3, 0).unwrap().set_text("SVC-IMPL");
        tbl.cell(3, 1).unwrap().set_text("Implementation Services");
        tbl.cell(3, 2).unwrap().set_text("1");
        tbl.cell(3, 3).unwrap().set_text("$25,000");

        tbl.cell(4, 0).unwrap().set_text("SVC-TRAIN");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("On-site Training (3 days)");
        tbl.cell(4, 2).unwrap().set_text("1");
        tbl.cell(4, 3).unwrap().set_text("$4,500");

        // Subtotal
        tbl.cell(5, 0).unwrap().set_text("Subtotal");
        tbl.cell(5, 0).unwrap().grid_span(3);
        tbl.cell(5, 0).unwrap().shading("F2F2F2");
        tbl.cell(5, 3).unwrap().set_text("$89,500");
        tbl.cell(5, 3).unwrap().shading("F2F2F2");

        // Total
        tbl.cell(6, 0).unwrap().set_text("TOTAL DUE");
        tbl.cell(6, 0).unwrap().grid_span(3);
        tbl.cell(6, 0).unwrap().shading("1F4E79");
        tbl.cell(6, 3).unwrap().set_text("$89,500");
        tbl.cell(6, 3).unwrap().shading("1F4E79");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 3. Specification table with vertical merge
    // =========================================================================
    doc.add_paragraph("3. Specification Table with Vertical Merges")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Specification");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Value");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        // "Hardware" spans 3 rows
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 0).unwrap().shading("E2EFDA");
        tbl.cell(1, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(1, 1).unwrap().set_text("Processor");
        tbl.cell(1, 2).unwrap().set_text("Intel Xeon E-2388G");

        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Memory");
        tbl.cell(2, 2).unwrap().set_text("64 GB DDR4 ECC");

        tbl.cell(3, 0).unwrap().v_merge_continue();
        tbl.cell(3, 1).unwrap().set_text("Storage");
        tbl.cell(3, 2).unwrap().set_text("2x 1TB NVMe SSD (RAID 1)");

        // "Network" spans 2 rows
        tbl.cell(4, 0).unwrap().set_text("Network");
        tbl.cell(4, 0).unwrap().v_merge_restart();
        tbl.cell(4, 0).unwrap().shading("FCE4D6");
        tbl.cell(4, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(4, 1).unwrap().set_text("Ethernet");
        tbl.cell(4, 2).unwrap().set_text("4x 10GbE SFP+");

        tbl.cell(5, 0).unwrap().v_merge_continue();
        tbl.cell(5, 1).unwrap().set_text("Management");
        tbl.cell(5, 2).unwrap().set_text("1x 1GbE IPMI");

        // "Software" spans 2 rows
        tbl.cell(6, 0).unwrap().set_text("Software");
        tbl.cell(6, 0).unwrap().v_merge_restart();
        tbl.cell(6, 0).unwrap().shading("D6E4F0");
        tbl.cell(6, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(6, 1).unwrap().set_text("Operating System");
        tbl.cell(6, 2).unwrap().set_text("Ubuntu 24.04 LTS");

        tbl.cell(7, 0).unwrap().v_merge_continue();
        tbl.cell(7, 1).unwrap().set_text("Monitoring");
        tbl.cell(7, 2).unwrap().set_text("Prometheus + Grafana");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 4. Nested table (table inside a cell)
    // =========================================================================
    doc.add_paragraph("4. Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");
        tbl = tbl.width_pct(100.0);
        tbl = tbl.cell_margins(
            Length::twips(72),
            Length::twips(108),
            Length::twips(72),
            Length::twips(108),
        );

        tbl.cell(0, 0).unwrap().set_text("Project Alpha");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Project Beta");
        tbl.cell(0, 1).unwrap().shading("2E75B6");

        // Nested table in cell (1,0)
        {
            let mut cell = tbl.cell(1, 0).unwrap();
            cell.set_text("Milestones:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "70AD47");
            inner.cell(0, 0).unwrap().set_text("Phase");
            inner.cell(0, 0).unwrap().shading("E2EFDA");
            inner.cell(0, 1).unwrap().set_text("Status");
            inner.cell(0, 1).unwrap().shading("E2EFDA");
            inner.cell(1, 0).unwrap().set_text("Design");
            inner.cell(1, 1).unwrap().set_text("Complete");
            inner.cell(2, 0).unwrap().set_text("Build");
            inner.cell(2, 1).unwrap().set_text("In Progress");
        }

        // Nested table in cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Budget:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "ED7D31");
            inner.cell(0, 0).unwrap().set_text("Category");
            inner.cell(0, 0).unwrap().shading("FCE4D6");
            inner.cell(0, 1).unwrap().set_text("Amount");
            inner.cell(0, 1).unwrap().shading("FCE4D6");
            inner.cell(1, 0).unwrap().set_text("Development");
            inner.cell(1, 1).unwrap().set_text("$120,000");
            inner.cell(2, 0).unwrap().set_text("Testing");
            inner.cell(2, 1).unwrap().set_text("$35,000");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 5. Form-style table with labels
    // =========================================================================
    doc.add_paragraph("5. Form-Style Table").style("Heading2");

    {
        let mut tbl = doc.add_table(6, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "808080");
        tbl = tbl.width_pct(100.0);

        // Row 0: Full-width title
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer Registration Form");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("404040");

        // Row 1: Name fields
        tbl.cell(1, 0).unwrap().set_text("First Name");
        tbl.cell(1, 0).unwrap().shading("E8E8E8");
        tbl.cell(1, 1).unwrap().set_text("John");
        tbl.cell(1, 2).unwrap().set_text("Last Name");
        tbl.cell(1, 2).unwrap().shading("E8E8E8");
        tbl.cell(1, 3).unwrap().set_text("Smith");

        // Row 2: Contact
        tbl.cell(2, 0).unwrap().set_text("Email");
        tbl.cell(2, 0).unwrap().shading("E8E8E8");
        tbl.cell(2, 1).unwrap().set_text("john.smith@example.com");
        tbl.cell(2, 1).unwrap().grid_span(3);

        // Row 3: Phone
        tbl.cell(3, 0).unwrap().set_text("Phone");
        tbl.cell(3, 0).unwrap().shading("E8E8E8");
        tbl.cell(3, 1).unwrap().set_text("+1 (555) 123-4567");
        tbl.cell(3, 2).unwrap().set_text("Company");
        tbl.cell(3, 2).unwrap().shading("E8E8E8");
        tbl.cell(3, 3).unwrap().set_text("Acme Corp");

        // Row 4: Address (spanning)
        tbl.cell(4, 0).unwrap().set_text("Address");
        tbl.cell(4, 0).unwrap().shading("E8E8E8");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("123 Business Ave, Suite 400, Portland, OR 97201");
        tbl.cell(4, 1).unwrap().grid_span(3);

        // Row 5: Notes
        tbl.cell(5, 0).unwrap().set_text("Notes");
        tbl.cell(5, 0).unwrap().shading("E8E8E8");
        tbl.cell(5, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top);
        {
            let mut cell = tbl.cell(5, 1).unwrap().grid_span(3);
            cell.set_text("Premium customer since 2020. Preferred contact method: email.");
            cell.add_paragraph("Annual review scheduled for March 2026.");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 6. Comparison table with border styles
    // =========================================================================
    doc.add_paragraph("6. Comparison Table with Custom Borders")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(5, 3);
        tbl = tbl.borders(BorderStyle::Double, 4, "2E75B6");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Feature");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Basic Plan");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Enterprise Plan");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        tbl.cell(1, 0).unwrap().set_text("Users");
        tbl.cell(1, 1).unwrap().set_text("Up to 10");
        tbl.cell(1, 2).unwrap().set_text("Unlimited");
        tbl.cell(1, 2).unwrap().shading("E2EFDA");

        tbl.cell(2, 0).unwrap().set_text("Storage");
        tbl.cell(2, 1).unwrap().set_text("50 GB");
        tbl.cell(2, 2).unwrap().set_text("5 TB");
        tbl.cell(2, 2).unwrap().shading("E2EFDA");

        tbl.cell(3, 0).unwrap().set_text("Support");
        tbl.cell(3, 1).unwrap().set_text("Email only");
        tbl.cell(3, 2).unwrap().set_text("24/7 Phone + Email");
        tbl.cell(3, 2).unwrap().shading("E2EFDA");

        tbl.cell(4, 0).unwrap().set_text("Price");
        tbl.cell(4, 0).unwrap().shading("F2F2F2");
        tbl.cell(4, 1).unwrap().set_text("$29/month");
        tbl.cell(4, 1).unwrap().shading("F2F2F2");
        tbl.cell(4, 2).unwrap().set_text("$199/month");
        tbl.cell(4, 2).unwrap().shading("C6EFCE");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 7. Wide table with fixed layout and row height
    // =========================================================================
    doc.add_paragraph("7. Fixed Layout Table with Row Height Control")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 5);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width(Length::inches(7.0));
        tbl = tbl.layout_fixed();

        // Set column widths
        for col in 0..5 {
            tbl.cell(0, col).unwrap().width(Length::inches(1.4));
        }

        // Header with exact height
        tbl.row(0).unwrap().height_exact(Length::twips(480));
        tbl.row(0).unwrap().header();
        tbl.row(0).unwrap().cant_split();

        let headers = ["Mon", "Tue", "Wed", "Thu", "Fri"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("404040");
            tbl.cell(0, col)
                .unwrap()
                .vertical_alignment(VerticalAlignment::Center);
        }

        // Schedule rows with minimum height
        tbl.row(1).unwrap().height(Length::twips(600));
        tbl.cell(1, 0).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 1).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 2).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 3).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 4).unwrap().set_text("9:00 Standup");

        tbl.row(2).unwrap().height(Length::twips(600));
        tbl.cell(2, 0).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 0).unwrap().shading("D6E4F0");
        tbl.cell(2, 1).unwrap().set_text("10:00 Design Review");
        tbl.cell(2, 1).unwrap().shading("FCE4D6");
        tbl.cell(2, 2).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 2).unwrap().shading("D6E4F0");
        tbl.cell(2, 3).unwrap().set_text("10:00 Sprint Planning");
        tbl.cell(2, 3).unwrap().shading("E2EFDA");
        tbl.cell(2, 4).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 4).unwrap().shading("D6E4F0");

        tbl.row(3).unwrap().height(Length::twips(600));
        tbl.cell(3, 0).unwrap().set_text("14:00 Code Review");
        tbl.cell(3, 1).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 1).unwrap().shading("D6E4F0");
        tbl.cell(3, 2).unwrap().set_text("14:00 Demo");
        tbl.cell(3, 2).unwrap().shading("FCE4D6");
        tbl.cell(3, 3).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 3).unwrap().shading("D6E4F0");
        tbl.cell(3, 4).unwrap().set_text("14:00 Retro");
        tbl.cell(3, 4).unwrap().shading("E2EFDA");
    }

    doc.set_title("Styled Tables Showcase");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

pub fn to_bytes(&mut self) -> Result<Vec<u8>>

Save the document to a byte vector.

pub fn paragraphs(&self) -> Vec<ParagraphRef<'_>>

Get immutable references to all paragraphs.

pub fn paragraph(&self, index: usize) -> Option<ParagraphRef<'_>>

Get an immutable reference to a paragraph by index (among paragraphs only).

pub fn footnotes(&self) -> Vec<(i32, String)>

All footnotes as (id, plain text), in file order.

Separator entries are excluded. They live in the same stream and are retained by the model so a round trip preserves them, but they are not notes and never were part of this listing.

pub fn add_footnote(&mut self, text: &str) -> i32

Add a footnote with the given text; returns its id. Pair with Paragraph::add_footnote_ref to reference it from the body.

pub fn add_paragraph(&mut self, text: &str) -> Paragraph<'_>

Add a paragraph with the given text and return a mutable reference.

Examples found in repository

examples/convert_html_md.rs (line 16)

fn main() {
    let doc = Document::open("samples/feature_showcase.docx").expect("Failed to open document");

    let html = doc.to_html();
    std::fs::write("/tmp/feature_showcase.html", &html).expect("Failed to write HTML");
    println!("HTML: {} bytes -> /tmp/feature_showcase.html", html.len());

    let md = doc.to_markdown();
    std::fs::write("/tmp/feature_showcase.md", &md).expect("Failed to write Markdown");
    println!("Markdown: {} bytes -> /tmp/feature_showcase.md", md.len());

    // Simple document
    let mut simple = Document::new();
    simple.add_paragraph("Hello, World!");
    let html = simple.to_html();
    println!("\n--- Simple HTML ---\n{html}");

    let md = simple.to_markdown();
    println!("--- Simple Markdown ---\n{md}");
}

examples/generate_pdf.rs (line 22)

fn main() {
    // Test 1: Simple document
    let doc = Document::new();
    match doc.to_pdf() {
        Ok(bytes) => {
            std::fs::write("/tmp/rdocx_simple.pdf", &bytes).unwrap();
            println!("Simple PDF: {} bytes -> /tmp/rdocx_simple.pdf", bytes.len());
        }
        Err(e) => println!("Simple PDF failed: {e}"),
    }

    // Test 2: Document with content
    let mut doc = Document::new();
    doc.set_title("Test PDF Document");
    doc.set_author("rdocx-pdf");
    doc.add_paragraph("Chapter 1: Introduction")
        .style("Heading1");
    doc.add_paragraph(
        "This is a test document generated by rdocx and rendered to PDF. \
         It demonstrates text rendering with proper font shaping and pagination.",
    );
    doc.add_paragraph("Section 1.1").style("Heading2");
    doc.add_paragraph("More content in a sub-section.");

    {
        let mut table = doc.add_table(2, 3);
        for r in 0..2 {
            for c in 0..3 {
                if let Some(mut cell) = table.cell(r, c) {
                    cell.set_text(&format!("R{}C{}", r + 1, c + 1));
                }
            }
        }
    }

    doc.add_paragraph("After the table.");

    match doc.to_pdf() {
        Ok(bytes) => {
            std::fs::write("/tmp/rdocx_content.pdf", &bytes).unwrap();
            println!(
                "Content PDF: {} bytes -> /tmp/rdocx_content.pdf",
                bytes.len()
            );
        }
        Err(e) => println!("Content PDF failed: {e}"),
    }

    // Test 3: From feature_showcase.docx
    let showcase_path = concat!(
        env!("CARGO_MANIFEST_DIR"),
        "/../../samples/feature_showcase.docx"
    );
    match Document::open(showcase_path) {
        Ok(doc) => match doc.to_pdf() {
            Ok(bytes) => {
                std::fs::write("/tmp/rdocx_showcase.pdf", &bytes).unwrap();
                println!(
                    "Showcase PDF: {} bytes -> /tmp/rdocx_showcase.pdf",
                    bytes.len()
                );
            }
            Err(e) => println!("Showcase PDF failed: {e}"),
        },
        Err(e) => println!("Failed to open showcase: {e}"),
    }
}

examples/template_replace.rs (line 57)

fn create_template(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );

    doc.set_header("{{company_name}} — Confidential");
    doc.set_footer("Prepared by {{author_name}} on {{date}}");

    // ── Title ──
    doc.add_paragraph("{{company_name}}")
        .style("Heading1")
        .alignment(Alignment::Center);

    doc.add_paragraph("Project Proposal")
        .alignment(Alignment::Center);

    doc.add_paragraph("");

    // ── Summary section ──
    doc.add_paragraph("Executive Summary").style("Heading2");

    doc.add_paragraph(
        "This proposal outlines the {{project_name}} project for {{company_name}}. \
         The primary contact is {{contact_name}} ({{contact_email}}). \
         The proposed start date is {{start_date}} with an estimated duration of {{duration}}.",
    );

    doc.add_paragraph("");

    // ── Cross-run placeholder (bold label + normal value) ──
    doc.add_paragraph("Key Details").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Project: ").bold(true);
        p.add_run("{{project_name}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Budget: ").bold(true);
        p.add_run("{{budget}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Status: ").bold(true);
        p.add_run("{{status}}");
    }

    doc.add_paragraph("");

    // ── Table with placeholders ──
    doc.add_paragraph("Team Members").style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        // Header row
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Email");

        tbl.cell(1, 0).unwrap().set_text("{{member1_name}}");
        tbl.cell(1, 1).unwrap().set_text("{{member1_role}}");
        tbl.cell(1, 2).unwrap().set_text("{{member1_email}}");

        tbl.cell(2, 0).unwrap().set_text("{{member2_name}}");
        tbl.cell(2, 1).unwrap().set_text("{{member2_role}}");
        tbl.cell(2, 2).unwrap().set_text("{{member2_email}}");

        tbl.cell(3, 0).unwrap().set_text("{{member3_name}}");
        tbl.cell(3, 1).unwrap().set_text("{{member3_role}}");
        tbl.cell(3, 2).unwrap().set_text("{{member3_email}}");
    }

    doc.add_paragraph("");

    // ── Deliverables section ──
    doc.add_paragraph("Deliverables").style("Heading2");

    doc.add_paragraph("INSERTION_POINT");

    doc.add_paragraph("");

    // ── Signature block ──
    doc.add_paragraph("Acceptance").style("Heading2");

    doc.add_paragraph(
        "By signing below, {{company_name}} agrees to the terms outlined in this proposal.",
    );

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer: ___________________");
        tbl.cell(0, 1)
            .unwrap()
            .set_text("Provider: ___________________");
        tbl.cell(1, 0).unwrap().set_text("Date: {{date}}");
        tbl.cell(1, 1).unwrap().set_text("Date: {{date}}");
    }

    doc.set_title("{{company_name}} — Project Proposal Template");
    doc.set_author("Template Generator");

    doc.save(path).unwrap();
}

examples/header_banner.rs (line 89)

fn generate_header_banner_doc(path: &Path) {
    let mut doc = Document::new();

    // Page setup with extra top margin for the banner
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::twips(2292), // top — extra tall for header banner
        Length::twips(1440), // right
        Length::twips(1440), // bottom
        Length::twips(1440), // left
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Generate a simple logo image (white text on transparent background)
    let logo_img = create_logo_png(220, 48);

    // ── Dark blue banner ──
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1A3C6E",
            banner_width: 7772400, // full page width in EMU (~8.5")
            banner_height: 969026, // banner height in EMU (~1.06")
            logo_width: 2011680,   // logo display width (~2.2")
            logo_height: 438912,   // logo display height (~0.48")
            logo_x_offset: 295125, // left padding
            logo_y_offset: 265057, // vertical centering
        },
    );

    doc.set_raw_header_with_images(
        banner.clone(),
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );

    // Use a different first page header (same banner, different color)
    doc.set_different_first_page(true);
    let first_page_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "2E75B6", // lighter blue for cover
            banner_width: 7772400,
            banner_height: 969026,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 265057,
        },
    );
    doc.set_raw_header_with_images(
        first_page_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );

    // Footer
    doc.set_footer("Confidential — Internal Use Only");

    // ── Page 1: Cover ──
    doc.add_paragraph("Company Report").style("Heading1");

    doc.add_paragraph(
        "This document demonstrates a custom header banner built with DrawingML \
         group shapes. The banner uses a colored rectangle with a logo image overlaid, \
         positioned at the top of each page.",
    );

    doc.add_paragraph("");

    doc.add_paragraph("How the Header Banner Works")
        .style("Heading2");

    doc.add_paragraph(
        "The header banner is built using set_raw_header_with_images(), which \
         accepts raw XML and a list of (rel_id, image_data, filename) tuples. \
         The XML uses a DrawingML group shape (wpg:wgp) containing:",
    );

    doc.add_bullet_list_item(
        "A wps:wsp rectangle shape with a solid color fill (the background bar)",
        0,
    );
    doc.add_bullet_list_item(
        "A pic:pic image element positioned within the group (the logo)",
        0,
    );
    doc.add_bullet_list_item(
        "The group is wrapped in a wp:anchor element for absolute page positioning",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Customization").style("Heading2");

    doc.add_paragraph(
        "All dimensions are in EMU (English Metric Units) where 914400 EMU = 1 inch. \
         You can customize:",
    );

    doc.add_bullet_list_item("bg_color — any hex color for the rectangle background", 0);
    doc.add_bullet_list_item("banner_width / banner_height — size of the full banner", 0);
    doc.add_bullet_list_item("logo_width / logo_height — display size of the logo", 0);
    doc.add_bullet_list_item(
        "logo_x_offset / logo_y_offset — logo position within the banner",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Different First Page").style("Heading2");

    doc.add_paragraph(
        "This page uses a lighter blue banner (first page header). \
         Subsequent pages use a darker blue banner (default header). \
         Use set_different_first_page(true) to enable this.",
    );

    // ── Page 2 ──
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("Second Page").style("Heading1");

    doc.add_paragraph(
        "This page shows the default header banner (dark blue). The first page \
         had a lighter blue banner because we set a different first-page header.",
    );

    doc.add_paragraph("");

    doc.add_paragraph(
        "The banner repeats on every page because it is placed in the header part. \
         You can have different banners for default, first-page, and even-page headers.",
    );

    doc.set_title("Header Banner Example");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/styled_tables.rs (line 34)

fn generate_styled_tables(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );

    doc.add_paragraph("Styled Tables Showcase")
        .style("Heading1");

    doc.add_paragraph("");

    // =========================================================================
    // 1. Professional report table with alternating rows
    // =========================================================================
    doc.add_paragraph("1. Report Table with Alternating Row Colors")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 4);
        tbl = tbl.borders(BorderStyle::Single, 2, "BFBFBF");
        tbl = tbl.width_pct(100.0);

        // Header row
        let headers = ["Product", "Q1 Sales", "Q2 Sales", "Growth"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().shading("2E75B6");
            tbl.cell(0, col).unwrap().set_text(h);
        }
        tbl.row(0).unwrap().header();

        // Data with alternating shading
        let data = [
            ["Enterprise Suite", "$245,000", "$312,000", "+27.3%"],
            ["Professional", "$189,000", "$201,000", "+6.3%"],
            ["Starter Pack", "$67,000", "$84,500", "+26.1%"],
            ["Add-ons", "$34,000", "$41,200", "+21.2%"],
            ["Training", "$22,000", "$28,900", "+31.4%"],
            ["Support Plans", "$56,000", "$62,300", "+11.3%"],
        ];

        for (i, row) in data.iter().enumerate() {
            let row_idx = i + 1;
            for (col, val) in row.iter().enumerate() {
                tbl.cell(row_idx, col).unwrap().set_text(val);
                // Alternate row colors
                if i % 2 == 0 {
                    tbl.cell(row_idx, col).unwrap().shading("F2F7FB");
                }
            }
        }

        // Total row
        tbl.cell(7, 0).unwrap().set_text("TOTAL");
        tbl.cell(7, 0).unwrap().shading("D6E4F0");
        tbl.cell(7, 1).unwrap().set_text("$613,000");
        tbl.cell(7, 1).unwrap().shading("D6E4F0");
        tbl.cell(7, 2).unwrap().set_text("$729,900");
        tbl.cell(7, 2).unwrap().shading("D6E4F0");
        tbl.cell(7, 3).unwrap().set_text("+19.1%");
        tbl.cell(7, 3).unwrap().shading("D6E4F0");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 2. Invoice-style table with merged header
    // =========================================================================
    doc.add_paragraph("2. Invoice Table with Merged Header & Row Spans")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(7, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Merged title row
        tbl.cell(0, 0).unwrap().set_text("INVOICE #2026-0042");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("1F4E79");

        // Column headers
        let headers = ["Item", "Description", "Qty", "Amount"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(1, col).unwrap().set_text(h);
            tbl.cell(1, col).unwrap().shading("D6E4F0");
        }

        // Line items
        tbl.cell(2, 0).unwrap().set_text("LIC-ENT-500");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Enterprise License (500 seats)");
        tbl.cell(2, 2).unwrap().set_text("1");
        tbl.cell(2, 3).unwrap().set_text("$60,000");

        tbl.cell(3, 0).unwrap().set_text("SVC-IMPL");
        tbl.cell(3, 1).unwrap().set_text("Implementation Services");
        tbl.cell(3, 2).unwrap().set_text("1");
        tbl.cell(3, 3).unwrap().set_text("$25,000");

        tbl.cell(4, 0).unwrap().set_text("SVC-TRAIN");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("On-site Training (3 days)");
        tbl.cell(4, 2).unwrap().set_text("1");
        tbl.cell(4, 3).unwrap().set_text("$4,500");

        // Subtotal
        tbl.cell(5, 0).unwrap().set_text("Subtotal");
        tbl.cell(5, 0).unwrap().grid_span(3);
        tbl.cell(5, 0).unwrap().shading("F2F2F2");
        tbl.cell(5, 3).unwrap().set_text("$89,500");
        tbl.cell(5, 3).unwrap().shading("F2F2F2");

        // Total
        tbl.cell(6, 0).unwrap().set_text("TOTAL DUE");
        tbl.cell(6, 0).unwrap().grid_span(3);
        tbl.cell(6, 0).unwrap().shading("1F4E79");
        tbl.cell(6, 3).unwrap().set_text("$89,500");
        tbl.cell(6, 3).unwrap().shading("1F4E79");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 3. Specification table with vertical merge
    // =========================================================================
    doc.add_paragraph("3. Specification Table with Vertical Merges")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Specification");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Value");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        // "Hardware" spans 3 rows
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 0).unwrap().shading("E2EFDA");
        tbl.cell(1, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(1, 1).unwrap().set_text("Processor");
        tbl.cell(1, 2).unwrap().set_text("Intel Xeon E-2388G");

        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Memory");
        tbl.cell(2, 2).unwrap().set_text("64 GB DDR4 ECC");

        tbl.cell(3, 0).unwrap().v_merge_continue();
        tbl.cell(3, 1).unwrap().set_text("Storage");
        tbl.cell(3, 2).unwrap().set_text("2x 1TB NVMe SSD (RAID 1)");

        // "Network" spans 2 rows
        tbl.cell(4, 0).unwrap().set_text("Network");
        tbl.cell(4, 0).unwrap().v_merge_restart();
        tbl.cell(4, 0).unwrap().shading("FCE4D6");
        tbl.cell(4, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(4, 1).unwrap().set_text("Ethernet");
        tbl.cell(4, 2).unwrap().set_text("4x 10GbE SFP+");

        tbl.cell(5, 0).unwrap().v_merge_continue();
        tbl.cell(5, 1).unwrap().set_text("Management");
        tbl.cell(5, 2).unwrap().set_text("1x 1GbE IPMI");

        // "Software" spans 2 rows
        tbl.cell(6, 0).unwrap().set_text("Software");
        tbl.cell(6, 0).unwrap().v_merge_restart();
        tbl.cell(6, 0).unwrap().shading("D6E4F0");
        tbl.cell(6, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(6, 1).unwrap().set_text("Operating System");
        tbl.cell(6, 2).unwrap().set_text("Ubuntu 24.04 LTS");

        tbl.cell(7, 0).unwrap().v_merge_continue();
        tbl.cell(7, 1).unwrap().set_text("Monitoring");
        tbl.cell(7, 2).unwrap().set_text("Prometheus + Grafana");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 4. Nested table (table inside a cell)
    // =========================================================================
    doc.add_paragraph("4. Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");
        tbl = tbl.width_pct(100.0);
        tbl = tbl.cell_margins(
            Length::twips(72),
            Length::twips(108),
            Length::twips(72),
            Length::twips(108),
        );

        tbl.cell(0, 0).unwrap().set_text("Project Alpha");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Project Beta");
        tbl.cell(0, 1).unwrap().shading("2E75B6");

        // Nested table in cell (1,0)
        {
            let mut cell = tbl.cell(1, 0).unwrap();
            cell.set_text("Milestones:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "70AD47");
            inner.cell(0, 0).unwrap().set_text("Phase");
            inner.cell(0, 0).unwrap().shading("E2EFDA");
            inner.cell(0, 1).unwrap().set_text("Status");
            inner.cell(0, 1).unwrap().shading("E2EFDA");
            inner.cell(1, 0).unwrap().set_text("Design");
            inner.cell(1, 1).unwrap().set_text("Complete");
            inner.cell(2, 0).unwrap().set_text("Build");
            inner.cell(2, 1).unwrap().set_text("In Progress");
        }

        // Nested table in cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Budget:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "ED7D31");
            inner.cell(0, 0).unwrap().set_text("Category");
            inner.cell(0, 0).unwrap().shading("FCE4D6");
            inner.cell(0, 1).unwrap().set_text("Amount");
            inner.cell(0, 1).unwrap().shading("FCE4D6");
            inner.cell(1, 0).unwrap().set_text("Development");
            inner.cell(1, 1).unwrap().set_text("$120,000");
            inner.cell(2, 0).unwrap().set_text("Testing");
            inner.cell(2, 1).unwrap().set_text("$35,000");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 5. Form-style table with labels
    // =========================================================================
    doc.add_paragraph("5. Form-Style Table").style("Heading2");

    {
        let mut tbl = doc.add_table(6, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "808080");
        tbl = tbl.width_pct(100.0);

        // Row 0: Full-width title
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer Registration Form");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("404040");

        // Row 1: Name fields
        tbl.cell(1, 0).unwrap().set_text("First Name");
        tbl.cell(1, 0).unwrap().shading("E8E8E8");
        tbl.cell(1, 1).unwrap().set_text("John");
        tbl.cell(1, 2).unwrap().set_text("Last Name");
        tbl.cell(1, 2).unwrap().shading("E8E8E8");
        tbl.cell(1, 3).unwrap().set_text("Smith");

        // Row 2: Contact
        tbl.cell(2, 0).unwrap().set_text("Email");
        tbl.cell(2, 0).unwrap().shading("E8E8E8");
        tbl.cell(2, 1).unwrap().set_text("john.smith@example.com");
        tbl.cell(2, 1).unwrap().grid_span(3);

        // Row 3: Phone
        tbl.cell(3, 0).unwrap().set_text("Phone");
        tbl.cell(3, 0).unwrap().shading("E8E8E8");
        tbl.cell(3, 1).unwrap().set_text("+1 (555) 123-4567");
        tbl.cell(3, 2).unwrap().set_text("Company");
        tbl.cell(3, 2).unwrap().shading("E8E8E8");
        tbl.cell(3, 3).unwrap().set_text("Acme Corp");

        // Row 4: Address (spanning)
        tbl.cell(4, 0).unwrap().set_text("Address");
        tbl.cell(4, 0).unwrap().shading("E8E8E8");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("123 Business Ave, Suite 400, Portland, OR 97201");
        tbl.cell(4, 1).unwrap().grid_span(3);

        // Row 5: Notes
        tbl.cell(5, 0).unwrap().set_text("Notes");
        tbl.cell(5, 0).unwrap().shading("E8E8E8");
        tbl.cell(5, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top);
        {
            let mut cell = tbl.cell(5, 1).unwrap().grid_span(3);
            cell.set_text("Premium customer since 2020. Preferred contact method: email.");
            cell.add_paragraph("Annual review scheduled for March 2026.");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 6. Comparison table with border styles
    // =========================================================================
    doc.add_paragraph("6. Comparison Table with Custom Borders")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(5, 3);
        tbl = tbl.borders(BorderStyle::Double, 4, "2E75B6");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Feature");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Basic Plan");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Enterprise Plan");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        tbl.cell(1, 0).unwrap().set_text("Users");
        tbl.cell(1, 1).unwrap().set_text("Up to 10");
        tbl.cell(1, 2).unwrap().set_text("Unlimited");
        tbl.cell(1, 2).unwrap().shading("E2EFDA");

        tbl.cell(2, 0).unwrap().set_text("Storage");
        tbl.cell(2, 1).unwrap().set_text("50 GB");
        tbl.cell(2, 2).unwrap().set_text("5 TB");
        tbl.cell(2, 2).unwrap().shading("E2EFDA");

        tbl.cell(3, 0).unwrap().set_text("Support");
        tbl.cell(3, 1).unwrap().set_text("Email only");
        tbl.cell(3, 2).unwrap().set_text("24/7 Phone + Email");
        tbl.cell(3, 2).unwrap().shading("E2EFDA");

        tbl.cell(4, 0).unwrap().set_text("Price");
        tbl.cell(4, 0).unwrap().shading("F2F2F2");
        tbl.cell(4, 1).unwrap().set_text("$29/month");
        tbl.cell(4, 1).unwrap().shading("F2F2F2");
        tbl.cell(4, 2).unwrap().set_text("$199/month");
        tbl.cell(4, 2).unwrap().shading("C6EFCE");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 7. Wide table with fixed layout and row height
    // =========================================================================
    doc.add_paragraph("7. Fixed Layout Table with Row Height Control")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 5);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width(Length::inches(7.0));
        tbl = tbl.layout_fixed();

        // Set column widths
        for col in 0..5 {
            tbl.cell(0, col).unwrap().width(Length::inches(1.4));
        }

        // Header with exact height
        tbl.row(0).unwrap().height_exact(Length::twips(480));
        tbl.row(0).unwrap().header();
        tbl.row(0).unwrap().cant_split();

        let headers = ["Mon", "Tue", "Wed", "Thu", "Fri"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("404040");
            tbl.cell(0, col)
                .unwrap()
                .vertical_alignment(VerticalAlignment::Center);
        }

        // Schedule rows with minimum height
        tbl.row(1).unwrap().height(Length::twips(600));
        tbl.cell(1, 0).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 1).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 2).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 3).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 4).unwrap().set_text("9:00 Standup");

        tbl.row(2).unwrap().height(Length::twips(600));
        tbl.cell(2, 0).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 0).unwrap().shading("D6E4F0");
        tbl.cell(2, 1).unwrap().set_text("10:00 Design Review");
        tbl.cell(2, 1).unwrap().shading("FCE4D6");
        tbl.cell(2, 2).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 2).unwrap().shading("D6E4F0");
        tbl.cell(2, 3).unwrap().set_text("10:00 Sprint Planning");
        tbl.cell(2, 3).unwrap().shading("E2EFDA");
        tbl.cell(2, 4).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 4).unwrap().shading("D6E4F0");

        tbl.row(3).unwrap().height(Length::twips(600));
        tbl.cell(3, 0).unwrap().set_text("14:00 Code Review");
        tbl.cell(3, 1).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 1).unwrap().shading("D6E4F0");
        tbl.cell(3, 2).unwrap().set_text("14:00 Demo");
        tbl.cell(3, 2).unwrap().shading("FCE4D6");
        tbl.cell(3, 3).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 3).unwrap().shading("D6E4F0");
        tbl.cell(3, 4).unwrap().set_text("14:00 Retro");
        tbl.cell(3, 4).unwrap().shading("E2EFDA");
    }

    doc.set_title("Styled Tables Showcase");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/generate_all_samples.rs (line 127)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

// =============================================================================
// 6. LETTER — Slate blue + silver scheme
// =============================================================================
fn generate_letter(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Slate #4A5568, Blue accent #3182CE
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
    );
    doc.set_title("Business Letter");
    doc.set_author("Walter White");

    // Banner header using raw XML
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "4A5568",
            banner_width: 7772400,
            banner_height: 731520, // ~0.8"
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 146304,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_margins(
        Length::twips(2000),
        Length::twips(1800),
        Length::twips(1440),
        Length::twips(1800),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Footer with contact
    doc.set_footer(
        "Tensorbee | 123 Innovation Drive, Suite 400 | San Francisco, CA 94105 | tensorbee.com",
    );

    // ── Sender Address ──
    doc.add_paragraph("Walter White");
    doc.add_paragraph("Chief Executive Officer");
    doc.add_paragraph("Tensorbee");
    doc.add_paragraph("123 Innovation Drive, Suite 400");
    doc.add_paragraph("San Francisco, CA 94105");
    doc.add_paragraph("");
    doc.add_paragraph("February 22, 2026");

    doc.add_paragraph("");

    // ── Recipient ──
    doc.add_paragraph("Ms. Sarah Chen");
    doc.add_paragraph("VP of Engineering");
    doc.add_paragraph("Meridian Dynamics LLC");
    doc.add_paragraph("456 Enterprise Boulevard");
    doc.add_paragraph("Austin, TX 78701");

    doc.add_paragraph("");

    // ── Subject ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Re: Strategic Technology Partnership — Phase 2 Expansion")
            .bold(true);
    }

    doc.add_paragraph("");

    // ── Body ──
    doc.add_paragraph("Dear Ms. Chen,");
    doc.add_paragraph("");

    doc.add_paragraph(
        "I am writing to express Tensorbee's enthusiasm for expanding our strategic technology \
         partnership with Meridian Dynamics. Following the successful completion of Phase 1, \
         which delivered a 40% improvement in your ML inference pipeline throughput, we believe \
         the foundation is firmly established for an ambitious Phase 2 engagement.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "During our recent executive review, your team highlighted three priority areas for \
         the next phase of collaboration:",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_numbered_list_item(
        "Real-time anomaly detection for your financial transaction monitoring system, \
         targeting sub-100ms latency at 50,000 transactions per second.",
        0,
    );
    doc.add_numbered_list_item(
        "Federated learning infrastructure to enable model training across your distributed \
         data centers without centralizing sensitive financial data.",
        0,
    );
    doc.add_numbered_list_item(
        "MLOps automation to reduce your model deployment cycle from the current 5 days \
         to under 4 hours.",
        0,
    );

    doc.add_paragraph(
        "Our engineering team has prepared a detailed technical proposal addressing each of \
         these areas. We have allocated a dedicated team of eight senior engineers, led by \
         our CTO, to ensure continuity with the Phase 1 team your organization has already \
         built a productive working relationship with.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "I would welcome the opportunity to present our Phase 2 proposal in person. My \
         assistant will reach out to coordinate a meeting at your convenience during the \
         first week of March.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("");

    doc.add_paragraph("Warm regards,");
    doc.add_paragraph("");
    doc.add_paragraph("");

    // Signature line
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "4A5568");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Walter White").bold(true).size(12.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Chief Executive Officer, Tensorbee")
            .italic(true)
            .size(10.0)
            .color("666666");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("walter@tensorbee.com | +1 (415) 555-0199")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 7. EMPLOYMENT CONTRACT — Purple + charcoal scheme
// =============================================================================
fn generate_contract(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Purple #5B2C6F, Plum #8E44AD, Gray #2C3E50
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Employment Agreement");
    doc.set_author("Tensorbee HR Department");
    doc.set_subject("Employment Contract — Walter White");
    doc.set_keywords("employment, contract, agreement, Tensorbee");

    doc.set_header("TENSORBEE — Employment Agreement");
    doc.set_footer("Employment Agreement — Walter White — Page");

    // ── Title Block ──
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("EMPLOYMENT AGREEMENT")
            .bold(true)
            .size(24.0)
            .color("5B2C6F")
            .font("Georgia");
    }
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    doc.add_paragraph("");

    // ── Parties ──
    doc.add_paragraph(
        "This Employment Agreement (\"Agreement\") is entered into as of February 22, 2026 \
         (\"Effective Date\"), by and between:",
    );

    doc.add_paragraph("");

    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYER: ").bold(true);
        p.add_run(
            "Tensorbee, Inc., a Delaware corporation with its principal place of business at \
                   123 Innovation Drive, Suite 400, San Francisco, CA 94105 (\"Company\")",
        );
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYEE: ").bold(true);
        p.add_run(
            "Walter White, residing at 308 Negra Arroyo Lane, Albuquerque, NM 87104 (\"Employee\")",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph("The Company and Employee are collectively referred to as the \"Parties.\"");
    doc.add_paragraph("");

    // ── Article 1: Position and Duties ──
    doc.add_paragraph("Article 1 — Position and Duties")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.1 ").bold(true);
        p.add_run("The Company hereby employs the Employee as ");
        p.add_run("Chief Executive Officer (CEO)")
            .bold(true)
            .italic(true);
        p.add_run(", reporting directly to the Board of Directors.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.2 ").bold(true);
        p.add_run("The Employee shall devote full working time, attention, and best efforts to \
                   the performance of duties as reasonably assigned by the Board, including but not limited to:");
    }
    doc.add_bullet_list_item(
        "Setting and executing the Company's strategic vision and business plan",
        0,
    );
    doc.add_bullet_list_item(
        "Overseeing all operations, engineering, and commercial activities",
        0,
    );
    doc.add_bullet_list_item(
        "Representing the Company to investors, customers, and the public",
        0,
    );
    doc.add_bullet_list_item("Recruiting, developing, and retaining key talent", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.3 ").bold(true);
        p.add_run(
            "The Employee's primary work location shall be the Company's San Francisco \
                   headquarters, with reasonable travel as required by business needs.",
        );
    }

    // ── Article 2: Compensation ──
    doc.add_paragraph("Article 2 — Compensation and Benefits")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.1 Base Salary. ").bold(true);
        p.add_run("The Company shall pay the Employee an annual base salary of ");
        p.add_run("$375,000.00").bold(true);
        p.add_run(" (Three Hundred Seventy-Five Thousand Dollars), payable in accordance with the \
                   Company's standard payroll schedule, less applicable withholdings and deductions.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.2 Annual Bonus. ").bold(true);
        p.add_run("The Employee shall be eligible for an annual performance bonus of up to ");
        p.add_run("40%").bold(true);
        p.add_run(
            " of base salary, based on achievement of mutually agreed performance objectives.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.3 Equity. ").bold(true);
        p.add_run("Subject to Board approval, the Employee shall receive a stock option grant of ");
        p.add_run("500,000 shares").bold(true);
        p.add_run(
            " of the Company's common stock, vesting over four (4) years with a one-year cliff, \
                   at an exercise price equal to the fair market value on the date of grant.",
        );
    }

    // Compensation summary table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "5B2C6F")
            .width_pct(70.0)
            .alignment(Alignment::Center);
        tbl.cell(0, 0).unwrap().set_text("Compensation Element");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");
        let items = [
            ("Base Salary", "$375,000/year"),
            ("Target Bonus", "Up to 40% ($150,000)"),
            ("Equity Grant", "500,000 shares (4yr vest)"),
            ("Total Target Comp", "$525,000 + equity"),
        ];
        for (i, (elem, val)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(elem);
            tbl.cell(i + 1, 1).unwrap().set_text(val);
            if i == 3 {
                tbl.cell(i + 1, 0).unwrap().shading("E8DAEF");
                tbl.cell(i + 1, 1).unwrap().shading("E8DAEF");
            }
        }
    }

    // ── Article 3: Benefits ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Article 3 — Benefits").style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.1 ").bold(true);
        p.add_run(
            "The Employee shall be entitled to participate in all benefit programs \
                   generally available to senior executives, including:",
        );
    }
    doc.add_bullet_list_item(
        "Medical, dental, and vision insurance (100% premium coverage for employee and dependents)",
        0,
    );
    doc.add_bullet_list_item("401(k) retirement plan with 6% company match", 0);
    doc.add_bullet_list_item("Life insurance and long-term disability coverage", 0);
    doc.add_bullet_list_item("Annual professional development allowance of $10,000", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.2 Paid Time Off. ").bold(true);
        p.add_run(
            "The Employee shall receive 25 days of paid vacation per year, plus Company holidays, \
                   accruing on a monthly basis.",
        );
    }

    // ── Article 4: Term and Termination ──
    doc.add_paragraph("Article 4 — Term and Termination")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.1 At-Will Employment. ").bold(true);
        p.add_run(
            "This Agreement is for at-will employment and may be terminated by either Party \
                   at any time, with or without cause, subject to the notice provisions herein.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.2 Notice Period. ").bold(true);
        p.add_run("Either Party shall provide ");
        p.add_run("ninety (90) days").bold(true);
        p.add_run(" written notice of termination, or pay in lieu thereof.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.3 Severance. ").bold(true);
        p.add_run("In the event of termination by the Company without Cause, the Employee shall \
                   receive (a) twelve (12) months of base salary continuation, (b) pro-rata bonus \
                   for the year of termination, and (c) twelve (12) months of COBRA premium coverage.");
    }

    // ── Article 5: Confidentiality ──
    doc.add_paragraph("Article 5 — Confidentiality and IP")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.1 ").bold(true);
        p.add_run(
            "The Employee agrees to maintain strict confidentiality of all proprietary \
                   information, trade secrets, and business plans of the Company during and after \
                   employment.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.2 ").bold(true);
        p.add_run(
            "All intellectual property, inventions, and works of authorship created by the \
                   Employee during the term of employment and within the scope of duties shall be \
                   the sole and exclusive property of the Company.",
        );
    }

    // ── Article 6: Non-Compete ──
    doc.add_paragraph("Article 6 — Non-Competition")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("6.1 ").bold(true);
        p.add_run("For a period of twelve (12) months following termination, the Employee agrees \
                   not to engage in any business that directly competes with the Company's core \
                   business of AI infrastructure and ML operations services, within the United States.");
    }

    // ── Article 7: General Provisions ──
    doc.add_paragraph("Article 7 — General Provisions")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.1 Governing Law. ").bold(true);
        p.add_run(
            "This Agreement shall be governed by and construed in accordance with the laws of \
                   the State of California.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.2 Entire Agreement. ").bold(true);
        p.add_run(
            "This Agreement constitutes the entire agreement between the Parties and supersedes \
                   all prior negotiations, representations, and agreements.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.3 Amendment. ").bold(true);
        p.add_run(
            "This Agreement may only be amended by a written instrument signed by both Parties.",
        );
    }

    // ── Signature Block ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("IN WITNESS WHEREOF, the Parties have executed this Employment Agreement as of the Effective Date.")
        .space_after(Length::pt(24.0));

    // Signature table
    {
        let mut tbl = doc.add_table(6, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("FOR THE COMPANY:");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("EMPLOYEE:");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");

        tbl.cell(1, 0).unwrap().set_text("");
        tbl.cell(1, 1).unwrap().set_text("");
        tbl.row(1).unwrap().height(Length::pt(40.0));

        tbl.cell(2, 0)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(3, 0)
            .unwrap()
            .set_text("Name: Board Representative");
        tbl.cell(3, 1).unwrap().set_text("Name: Walter White");
        tbl.cell(4, 0)
            .unwrap()
            .set_text("Title: Chair, Board of Directors");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Title: Chief Executive Officer");
        tbl.cell(5, 0).unwrap().set_text("Date: _______________");
        tbl.cell(5, 1).unwrap().set_text("Date: _______________");
    }

    doc
}

pub fn paragraph_count(&self) -> usize

Get the number of paragraphs.

pub fn text(&self) -> String

Get the plain text of body paragraphs and table cells in document order.

pub fn paragraph_mut(&mut self, index: usize) -> Option<Paragraph<'_>>

Get a mutable reference to a paragraph by index (among paragraphs only).

pub fn tables(&self) -> Vec<TableRef<'_>>

Get immutable references to all tables.

pub fn table(&self, index: usize) -> Option<TableRef<'_>>

Get an immutable table by index among tables only.

pub fn table_mut(&mut self, index: usize) -> Option<Table<'_>>

Get a mutable table by index among tables only.

pub fn add_table(&mut self, rows: usize, cols: usize) -> Table<'_>

Add a table with the specified number of rows and columns. Returns a mutable reference for further configuration.

Examples found in repository

examples/generate_pdf.rs (line 32)

fn main() {
    // Test 1: Simple document
    let doc = Document::new();
    match doc.to_pdf() {
        Ok(bytes) => {
            std::fs::write("/tmp/rdocx_simple.pdf", &bytes).unwrap();
            println!("Simple PDF: {} bytes -> /tmp/rdocx_simple.pdf", bytes.len());
        }
        Err(e) => println!("Simple PDF failed: {e}"),
    }

    // Test 2: Document with content
    let mut doc = Document::new();
    doc.set_title("Test PDF Document");
    doc.set_author("rdocx-pdf");
    doc.add_paragraph("Chapter 1: Introduction")
        .style("Heading1");
    doc.add_paragraph(
        "This is a test document generated by rdocx and rendered to PDF. \
         It demonstrates text rendering with proper font shaping and pagination.",
    );
    doc.add_paragraph("Section 1.1").style("Heading2");
    doc.add_paragraph("More content in a sub-section.");

    {
        let mut table = doc.add_table(2, 3);
        for r in 0..2 {
            for c in 0..3 {
                if let Some(mut cell) = table.cell(r, c) {
                    cell.set_text(&format!("R{}C{}", r + 1, c + 1));
                }
            }
        }
    }

    doc.add_paragraph("After the table.");

    match doc.to_pdf() {
        Ok(bytes) => {
            std::fs::write("/tmp/rdocx_content.pdf", &bytes).unwrap();
            println!(
                "Content PDF: {} bytes -> /tmp/rdocx_content.pdf",
                bytes.len()
            );
        }
        Err(e) => println!("Content PDF failed: {e}"),
    }

    // Test 3: From feature_showcase.docx
    let showcase_path = concat!(
        env!("CARGO_MANIFEST_DIR"),
        "/../../samples/feature_showcase.docx"
    );
    match Document::open(showcase_path) {
        Ok(doc) => match doc.to_pdf() {
            Ok(bytes) => {
                std::fs::write("/tmp/rdocx_showcase.pdf", &bytes).unwrap();
                println!(
                    "Showcase PDF: {} bytes -> /tmp/rdocx_showcase.pdf",
                    bytes.len()
                );
            }
            Err(e) => println!("Showcase PDF failed: {e}"),
        },
        Err(e) => println!("Failed to open showcase: {e}"),
    }
}

examples/template_replace.rs (line 102)

fn create_template(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );

    doc.set_header("{{company_name}} — Confidential");
    doc.set_footer("Prepared by {{author_name}} on {{date}}");

    // ── Title ──
    doc.add_paragraph("{{company_name}}")
        .style("Heading1")
        .alignment(Alignment::Center);

    doc.add_paragraph("Project Proposal")
        .alignment(Alignment::Center);

    doc.add_paragraph("");

    // ── Summary section ──
    doc.add_paragraph("Executive Summary").style("Heading2");

    doc.add_paragraph(
        "This proposal outlines the {{project_name}} project for {{company_name}}. \
         The primary contact is {{contact_name}} ({{contact_email}}). \
         The proposed start date is {{start_date}} with an estimated duration of {{duration}}.",
    );

    doc.add_paragraph("");

    // ── Cross-run placeholder (bold label + normal value) ──
    doc.add_paragraph("Key Details").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Project: ").bold(true);
        p.add_run("{{project_name}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Budget: ").bold(true);
        p.add_run("{{budget}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Status: ").bold(true);
        p.add_run("{{status}}");
    }

    doc.add_paragraph("");

    // ── Table with placeholders ──
    doc.add_paragraph("Team Members").style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        // Header row
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Email");

        tbl.cell(1, 0).unwrap().set_text("{{member1_name}}");
        tbl.cell(1, 1).unwrap().set_text("{{member1_role}}");
        tbl.cell(1, 2).unwrap().set_text("{{member1_email}}");

        tbl.cell(2, 0).unwrap().set_text("{{member2_name}}");
        tbl.cell(2, 1).unwrap().set_text("{{member2_role}}");
        tbl.cell(2, 2).unwrap().set_text("{{member2_email}}");

        tbl.cell(3, 0).unwrap().set_text("{{member3_name}}");
        tbl.cell(3, 1).unwrap().set_text("{{member3_role}}");
        tbl.cell(3, 2).unwrap().set_text("{{member3_email}}");
    }

    doc.add_paragraph("");

    // ── Deliverables section ──
    doc.add_paragraph("Deliverables").style("Heading2");

    doc.add_paragraph("INSERTION_POINT");

    doc.add_paragraph("");

    // ── Signature block ──
    doc.add_paragraph("Acceptance").style("Heading2");

    doc.add_paragraph(
        "By signing below, {{company_name}} agrees to the terms outlined in this proposal.",
    );

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer: ___________________");
        tbl.cell(0, 1)
            .unwrap()
            .set_text("Provider: ___________________");
        tbl.cell(1, 0).unwrap().set_text("Date: {{date}}");
        tbl.cell(1, 1).unwrap().set_text("Date: {{date}}");
    }

    doc.set_title("{{company_name}} — Project Proposal Template");
    doc.set_author("Template Generator");

    doc.save(path).unwrap();
}

examples/styled_tables.rs (line 46)

fn generate_styled_tables(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );

    doc.add_paragraph("Styled Tables Showcase")
        .style("Heading1");

    doc.add_paragraph("");

    // =========================================================================
    // 1. Professional report table with alternating rows
    // =========================================================================
    doc.add_paragraph("1. Report Table with Alternating Row Colors")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 4);
        tbl = tbl.borders(BorderStyle::Single, 2, "BFBFBF");
        tbl = tbl.width_pct(100.0);

        // Header row
        let headers = ["Product", "Q1 Sales", "Q2 Sales", "Growth"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().shading("2E75B6");
            tbl.cell(0, col).unwrap().set_text(h);
        }
        tbl.row(0).unwrap().header();

        // Data with alternating shading
        let data = [
            ["Enterprise Suite", "$245,000", "$312,000", "+27.3%"],
            ["Professional", "$189,000", "$201,000", "+6.3%"],
            ["Starter Pack", "$67,000", "$84,500", "+26.1%"],
            ["Add-ons", "$34,000", "$41,200", "+21.2%"],
            ["Training", "$22,000", "$28,900", "+31.4%"],
            ["Support Plans", "$56,000", "$62,300", "+11.3%"],
        ];

        for (i, row) in data.iter().enumerate() {
            let row_idx = i + 1;
            for (col, val) in row.iter().enumerate() {
                tbl.cell(row_idx, col).unwrap().set_text(val);
                // Alternate row colors
                if i % 2 == 0 {
                    tbl.cell(row_idx, col).unwrap().shading("F2F7FB");
                }
            }
        }

        // Total row
        tbl.cell(7, 0).unwrap().set_text("TOTAL");
        tbl.cell(7, 0).unwrap().shading("D6E4F0");
        tbl.cell(7, 1).unwrap().set_text("$613,000");
        tbl.cell(7, 1).unwrap().shading("D6E4F0");
        tbl.cell(7, 2).unwrap().set_text("$729,900");
        tbl.cell(7, 2).unwrap().shading("D6E4F0");
        tbl.cell(7, 3).unwrap().set_text("+19.1%");
        tbl.cell(7, 3).unwrap().shading("D6E4F0");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 2. Invoice-style table with merged header
    // =========================================================================
    doc.add_paragraph("2. Invoice Table with Merged Header & Row Spans")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(7, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Merged title row
        tbl.cell(0, 0).unwrap().set_text("INVOICE #2026-0042");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("1F4E79");

        // Column headers
        let headers = ["Item", "Description", "Qty", "Amount"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(1, col).unwrap().set_text(h);
            tbl.cell(1, col).unwrap().shading("D6E4F0");
        }

        // Line items
        tbl.cell(2, 0).unwrap().set_text("LIC-ENT-500");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Enterprise License (500 seats)");
        tbl.cell(2, 2).unwrap().set_text("1");
        tbl.cell(2, 3).unwrap().set_text("$60,000");

        tbl.cell(3, 0).unwrap().set_text("SVC-IMPL");
        tbl.cell(3, 1).unwrap().set_text("Implementation Services");
        tbl.cell(3, 2).unwrap().set_text("1");
        tbl.cell(3, 3).unwrap().set_text("$25,000");

        tbl.cell(4, 0).unwrap().set_text("SVC-TRAIN");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("On-site Training (3 days)");
        tbl.cell(4, 2).unwrap().set_text("1");
        tbl.cell(4, 3).unwrap().set_text("$4,500");

        // Subtotal
        tbl.cell(5, 0).unwrap().set_text("Subtotal");
        tbl.cell(5, 0).unwrap().grid_span(3);
        tbl.cell(5, 0).unwrap().shading("F2F2F2");
        tbl.cell(5, 3).unwrap().set_text("$89,500");
        tbl.cell(5, 3).unwrap().shading("F2F2F2");

        // Total
        tbl.cell(6, 0).unwrap().set_text("TOTAL DUE");
        tbl.cell(6, 0).unwrap().grid_span(3);
        tbl.cell(6, 0).unwrap().shading("1F4E79");
        tbl.cell(6, 3).unwrap().set_text("$89,500");
        tbl.cell(6, 3).unwrap().shading("1F4E79");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 3. Specification table with vertical merge
    // =========================================================================
    doc.add_paragraph("3. Specification Table with Vertical Merges")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Specification");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Value");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        // "Hardware" spans 3 rows
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 0).unwrap().shading("E2EFDA");
        tbl.cell(1, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(1, 1).unwrap().set_text("Processor");
        tbl.cell(1, 2).unwrap().set_text("Intel Xeon E-2388G");

        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Memory");
        tbl.cell(2, 2).unwrap().set_text("64 GB DDR4 ECC");

        tbl.cell(3, 0).unwrap().v_merge_continue();
        tbl.cell(3, 1).unwrap().set_text("Storage");
        tbl.cell(3, 2).unwrap().set_text("2x 1TB NVMe SSD (RAID 1)");

        // "Network" spans 2 rows
        tbl.cell(4, 0).unwrap().set_text("Network");
        tbl.cell(4, 0).unwrap().v_merge_restart();
        tbl.cell(4, 0).unwrap().shading("FCE4D6");
        tbl.cell(4, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(4, 1).unwrap().set_text("Ethernet");
        tbl.cell(4, 2).unwrap().set_text("4x 10GbE SFP+");

        tbl.cell(5, 0).unwrap().v_merge_continue();
        tbl.cell(5, 1).unwrap().set_text("Management");
        tbl.cell(5, 2).unwrap().set_text("1x 1GbE IPMI");

        // "Software" spans 2 rows
        tbl.cell(6, 0).unwrap().set_text("Software");
        tbl.cell(6, 0).unwrap().v_merge_restart();
        tbl.cell(6, 0).unwrap().shading("D6E4F0");
        tbl.cell(6, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(6, 1).unwrap().set_text("Operating System");
        tbl.cell(6, 2).unwrap().set_text("Ubuntu 24.04 LTS");

        tbl.cell(7, 0).unwrap().v_merge_continue();
        tbl.cell(7, 1).unwrap().set_text("Monitoring");
        tbl.cell(7, 2).unwrap().set_text("Prometheus + Grafana");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 4. Nested table (table inside a cell)
    // =========================================================================
    doc.add_paragraph("4. Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");
        tbl = tbl.width_pct(100.0);
        tbl = tbl.cell_margins(
            Length::twips(72),
            Length::twips(108),
            Length::twips(72),
            Length::twips(108),
        );

        tbl.cell(0, 0).unwrap().set_text("Project Alpha");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Project Beta");
        tbl.cell(0, 1).unwrap().shading("2E75B6");

        // Nested table in cell (1,0)
        {
            let mut cell = tbl.cell(1, 0).unwrap();
            cell.set_text("Milestones:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "70AD47");
            inner.cell(0, 0).unwrap().set_text("Phase");
            inner.cell(0, 0).unwrap().shading("E2EFDA");
            inner.cell(0, 1).unwrap().set_text("Status");
            inner.cell(0, 1).unwrap().shading("E2EFDA");
            inner.cell(1, 0).unwrap().set_text("Design");
            inner.cell(1, 1).unwrap().set_text("Complete");
            inner.cell(2, 0).unwrap().set_text("Build");
            inner.cell(2, 1).unwrap().set_text("In Progress");
        }

        // Nested table in cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Budget:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "ED7D31");
            inner.cell(0, 0).unwrap().set_text("Category");
            inner.cell(0, 0).unwrap().shading("FCE4D6");
            inner.cell(0, 1).unwrap().set_text("Amount");
            inner.cell(0, 1).unwrap().shading("FCE4D6");
            inner.cell(1, 0).unwrap().set_text("Development");
            inner.cell(1, 1).unwrap().set_text("$120,000");
            inner.cell(2, 0).unwrap().set_text("Testing");
            inner.cell(2, 1).unwrap().set_text("$35,000");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 5. Form-style table with labels
    // =========================================================================
    doc.add_paragraph("5. Form-Style Table").style("Heading2");

    {
        let mut tbl = doc.add_table(6, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "808080");
        tbl = tbl.width_pct(100.0);

        // Row 0: Full-width title
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer Registration Form");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("404040");

        // Row 1: Name fields
        tbl.cell(1, 0).unwrap().set_text("First Name");
        tbl.cell(1, 0).unwrap().shading("E8E8E8");
        tbl.cell(1, 1).unwrap().set_text("John");
        tbl.cell(1, 2).unwrap().set_text("Last Name");
        tbl.cell(1, 2).unwrap().shading("E8E8E8");
        tbl.cell(1, 3).unwrap().set_text("Smith");

        // Row 2: Contact
        tbl.cell(2, 0).unwrap().set_text("Email");
        tbl.cell(2, 0).unwrap().shading("E8E8E8");
        tbl.cell(2, 1).unwrap().set_text("john.smith@example.com");
        tbl.cell(2, 1).unwrap().grid_span(3);

        // Row 3: Phone
        tbl.cell(3, 0).unwrap().set_text("Phone");
        tbl.cell(3, 0).unwrap().shading("E8E8E8");
        tbl.cell(3, 1).unwrap().set_text("+1 (555) 123-4567");
        tbl.cell(3, 2).unwrap().set_text("Company");
        tbl.cell(3, 2).unwrap().shading("E8E8E8");
        tbl.cell(3, 3).unwrap().set_text("Acme Corp");

        // Row 4: Address (spanning)
        tbl.cell(4, 0).unwrap().set_text("Address");
        tbl.cell(4, 0).unwrap().shading("E8E8E8");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("123 Business Ave, Suite 400, Portland, OR 97201");
        tbl.cell(4, 1).unwrap().grid_span(3);

        // Row 5: Notes
        tbl.cell(5, 0).unwrap().set_text("Notes");
        tbl.cell(5, 0).unwrap().shading("E8E8E8");
        tbl.cell(5, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top);
        {
            let mut cell = tbl.cell(5, 1).unwrap().grid_span(3);
            cell.set_text("Premium customer since 2020. Preferred contact method: email.");
            cell.add_paragraph("Annual review scheduled for March 2026.");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 6. Comparison table with border styles
    // =========================================================================
    doc.add_paragraph("6. Comparison Table with Custom Borders")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(5, 3);
        tbl = tbl.borders(BorderStyle::Double, 4, "2E75B6");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Feature");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Basic Plan");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Enterprise Plan");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        tbl.cell(1, 0).unwrap().set_text("Users");
        tbl.cell(1, 1).unwrap().set_text("Up to 10");
        tbl.cell(1, 2).unwrap().set_text("Unlimited");
        tbl.cell(1, 2).unwrap().shading("E2EFDA");

        tbl.cell(2, 0).unwrap().set_text("Storage");
        tbl.cell(2, 1).unwrap().set_text("50 GB");
        tbl.cell(2, 2).unwrap().set_text("5 TB");
        tbl.cell(2, 2).unwrap().shading("E2EFDA");

        tbl.cell(3, 0).unwrap().set_text("Support");
        tbl.cell(3, 1).unwrap().set_text("Email only");
        tbl.cell(3, 2).unwrap().set_text("24/7 Phone + Email");
        tbl.cell(3, 2).unwrap().shading("E2EFDA");

        tbl.cell(4, 0).unwrap().set_text("Price");
        tbl.cell(4, 0).unwrap().shading("F2F2F2");
        tbl.cell(4, 1).unwrap().set_text("$29/month");
        tbl.cell(4, 1).unwrap().shading("F2F2F2");
        tbl.cell(4, 2).unwrap().set_text("$199/month");
        tbl.cell(4, 2).unwrap().shading("C6EFCE");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 7. Wide table with fixed layout and row height
    // =========================================================================
    doc.add_paragraph("7. Fixed Layout Table with Row Height Control")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 5);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width(Length::inches(7.0));
        tbl = tbl.layout_fixed();

        // Set column widths
        for col in 0..5 {
            tbl.cell(0, col).unwrap().width(Length::inches(1.4));
        }

        // Header with exact height
        tbl.row(0).unwrap().height_exact(Length::twips(480));
        tbl.row(0).unwrap().header();
        tbl.row(0).unwrap().cant_split();

        let headers = ["Mon", "Tue", "Wed", "Thu", "Fri"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("404040");
            tbl.cell(0, col)
                .unwrap()
                .vertical_alignment(VerticalAlignment::Center);
        }

        // Schedule rows with minimum height
        tbl.row(1).unwrap().height(Length::twips(600));
        tbl.cell(1, 0).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 1).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 2).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 3).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 4).unwrap().set_text("9:00 Standup");

        tbl.row(2).unwrap().height(Length::twips(600));
        tbl.cell(2, 0).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 0).unwrap().shading("D6E4F0");
        tbl.cell(2, 1).unwrap().set_text("10:00 Design Review");
        tbl.cell(2, 1).unwrap().shading("FCE4D6");
        tbl.cell(2, 2).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 2).unwrap().shading("D6E4F0");
        tbl.cell(2, 3).unwrap().set_text("10:00 Sprint Planning");
        tbl.cell(2, 3).unwrap().shading("E2EFDA");
        tbl.cell(2, 4).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 4).unwrap().shading("D6E4F0");

        tbl.row(3).unwrap().height(Length::twips(600));
        tbl.cell(3, 0).unwrap().set_text("14:00 Code Review");
        tbl.cell(3, 1).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 1).unwrap().shading("D6E4F0");
        tbl.cell(3, 2).unwrap().set_text("14:00 Demo");
        tbl.cell(3, 2).unwrap().shading("FCE4D6");
        tbl.cell(3, 3).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 3).unwrap().shading("D6E4F0");
        tbl.cell(3, 4).unwrap().set_text("14:00 Retro");
        tbl.cell(3, 4).unwrap().shading("E2EFDA");
    }

    doc.set_title("Styled Tables Showcase");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/generate_all_samples.rs (line 365)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

// =============================================================================
// 6. LETTER — Slate blue + silver scheme
// =============================================================================
fn generate_letter(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Slate #4A5568, Blue accent #3182CE
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
    );
    doc.set_title("Business Letter");
    doc.set_author("Walter White");

    // Banner header using raw XML
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "4A5568",
            banner_width: 7772400,
            banner_height: 731520, // ~0.8"
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 146304,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_margins(
        Length::twips(2000),
        Length::twips(1800),
        Length::twips(1440),
        Length::twips(1800),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Footer with contact
    doc.set_footer(
        "Tensorbee | 123 Innovation Drive, Suite 400 | San Francisco, CA 94105 | tensorbee.com",
    );

    // ── Sender Address ──
    doc.add_paragraph("Walter White");
    doc.add_paragraph("Chief Executive Officer");
    doc.add_paragraph("Tensorbee");
    doc.add_paragraph("123 Innovation Drive, Suite 400");
    doc.add_paragraph("San Francisco, CA 94105");
    doc.add_paragraph("");
    doc.add_paragraph("February 22, 2026");

    doc.add_paragraph("");

    // ── Recipient ──
    doc.add_paragraph("Ms. Sarah Chen");
    doc.add_paragraph("VP of Engineering");
    doc.add_paragraph("Meridian Dynamics LLC");
    doc.add_paragraph("456 Enterprise Boulevard");
    doc.add_paragraph("Austin, TX 78701");

    doc.add_paragraph("");

    // ── Subject ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Re: Strategic Technology Partnership — Phase 2 Expansion")
            .bold(true);
    }

    doc.add_paragraph("");

    // ── Body ──
    doc.add_paragraph("Dear Ms. Chen,");
    doc.add_paragraph("");

    doc.add_paragraph(
        "I am writing to express Tensorbee's enthusiasm for expanding our strategic technology \
         partnership with Meridian Dynamics. Following the successful completion of Phase 1, \
         which delivered a 40% improvement in your ML inference pipeline throughput, we believe \
         the foundation is firmly established for an ambitious Phase 2 engagement.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "During our recent executive review, your team highlighted three priority areas for \
         the next phase of collaboration:",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_numbered_list_item(
        "Real-time anomaly detection for your financial transaction monitoring system, \
         targeting sub-100ms latency at 50,000 transactions per second.",
        0,
    );
    doc.add_numbered_list_item(
        "Federated learning infrastructure to enable model training across your distributed \
         data centers without centralizing sensitive financial data.",
        0,
    );
    doc.add_numbered_list_item(
        "MLOps automation to reduce your model deployment cycle from the current 5 days \
         to under 4 hours.",
        0,
    );

    doc.add_paragraph(
        "Our engineering team has prepared a detailed technical proposal addressing each of \
         these areas. We have allocated a dedicated team of eight senior engineers, led by \
         our CTO, to ensure continuity with the Phase 1 team your organization has already \
         built a productive working relationship with.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "I would welcome the opportunity to present our Phase 2 proposal in person. My \
         assistant will reach out to coordinate a meeting at your convenience during the \
         first week of March.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("");

    doc.add_paragraph("Warm regards,");
    doc.add_paragraph("");
    doc.add_paragraph("");

    // Signature line
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "4A5568");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Walter White").bold(true).size(12.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Chief Executive Officer, Tensorbee")
            .italic(true)
            .size(10.0)
            .color("666666");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("walter@tensorbee.com | +1 (415) 555-0199")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 7. EMPLOYMENT CONTRACT — Purple + charcoal scheme
// =============================================================================
fn generate_contract(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Purple #5B2C6F, Plum #8E44AD, Gray #2C3E50
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Employment Agreement");
    doc.set_author("Tensorbee HR Department");
    doc.set_subject("Employment Contract — Walter White");
    doc.set_keywords("employment, contract, agreement, Tensorbee");

    doc.set_header("TENSORBEE — Employment Agreement");
    doc.set_footer("Employment Agreement — Walter White — Page");

    // ── Title Block ──
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("EMPLOYMENT AGREEMENT")
            .bold(true)
            .size(24.0)
            .color("5B2C6F")
            .font("Georgia");
    }
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    doc.add_paragraph("");

    // ── Parties ──
    doc.add_paragraph(
        "This Employment Agreement (\"Agreement\") is entered into as of February 22, 2026 \
         (\"Effective Date\"), by and between:",
    );

    doc.add_paragraph("");

    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYER: ").bold(true);
        p.add_run(
            "Tensorbee, Inc., a Delaware corporation with its principal place of business at \
                   123 Innovation Drive, Suite 400, San Francisco, CA 94105 (\"Company\")",
        );
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYEE: ").bold(true);
        p.add_run(
            "Walter White, residing at 308 Negra Arroyo Lane, Albuquerque, NM 87104 (\"Employee\")",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph("The Company and Employee are collectively referred to as the \"Parties.\"");
    doc.add_paragraph("");

    // ── Article 1: Position and Duties ──
    doc.add_paragraph("Article 1 — Position and Duties")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.1 ").bold(true);
        p.add_run("The Company hereby employs the Employee as ");
        p.add_run("Chief Executive Officer (CEO)")
            .bold(true)
            .italic(true);
        p.add_run(", reporting directly to the Board of Directors.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.2 ").bold(true);
        p.add_run("The Employee shall devote full working time, attention, and best efforts to \
                   the performance of duties as reasonably assigned by the Board, including but not limited to:");
    }
    doc.add_bullet_list_item(
        "Setting and executing the Company's strategic vision and business plan",
        0,
    );
    doc.add_bullet_list_item(
        "Overseeing all operations, engineering, and commercial activities",
        0,
    );
    doc.add_bullet_list_item(
        "Representing the Company to investors, customers, and the public",
        0,
    );
    doc.add_bullet_list_item("Recruiting, developing, and retaining key talent", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.3 ").bold(true);
        p.add_run(
            "The Employee's primary work location shall be the Company's San Francisco \
                   headquarters, with reasonable travel as required by business needs.",
        );
    }

    // ── Article 2: Compensation ──
    doc.add_paragraph("Article 2 — Compensation and Benefits")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.1 Base Salary. ").bold(true);
        p.add_run("The Company shall pay the Employee an annual base salary of ");
        p.add_run("$375,000.00").bold(true);
        p.add_run(" (Three Hundred Seventy-Five Thousand Dollars), payable in accordance with the \
                   Company's standard payroll schedule, less applicable withholdings and deductions.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.2 Annual Bonus. ").bold(true);
        p.add_run("The Employee shall be eligible for an annual performance bonus of up to ");
        p.add_run("40%").bold(true);
        p.add_run(
            " of base salary, based on achievement of mutually agreed performance objectives.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.3 Equity. ").bold(true);
        p.add_run("Subject to Board approval, the Employee shall receive a stock option grant of ");
        p.add_run("500,000 shares").bold(true);
        p.add_run(
            " of the Company's common stock, vesting over four (4) years with a one-year cliff, \
                   at an exercise price equal to the fair market value on the date of grant.",
        );
    }

    // Compensation summary table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "5B2C6F")
            .width_pct(70.0)
            .alignment(Alignment::Center);
        tbl.cell(0, 0).unwrap().set_text("Compensation Element");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");
        let items = [
            ("Base Salary", "$375,000/year"),
            ("Target Bonus", "Up to 40% ($150,000)"),
            ("Equity Grant", "500,000 shares (4yr vest)"),
            ("Total Target Comp", "$525,000 + equity"),
        ];
        for (i, (elem, val)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(elem);
            tbl.cell(i + 1, 1).unwrap().set_text(val);
            if i == 3 {
                tbl.cell(i + 1, 0).unwrap().shading("E8DAEF");
                tbl.cell(i + 1, 1).unwrap().shading("E8DAEF");
            }
        }
    }

    // ── Article 3: Benefits ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Article 3 — Benefits").style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.1 ").bold(true);
        p.add_run(
            "The Employee shall be entitled to participate in all benefit programs \
                   generally available to senior executives, including:",
        );
    }
    doc.add_bullet_list_item(
        "Medical, dental, and vision insurance (100% premium coverage for employee and dependents)",
        0,
    );
    doc.add_bullet_list_item("401(k) retirement plan with 6% company match", 0);
    doc.add_bullet_list_item("Life insurance and long-term disability coverage", 0);
    doc.add_bullet_list_item("Annual professional development allowance of $10,000", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.2 Paid Time Off. ").bold(true);
        p.add_run(
            "The Employee shall receive 25 days of paid vacation per year, plus Company holidays, \
                   accruing on a monthly basis.",
        );
    }

    // ── Article 4: Term and Termination ──
    doc.add_paragraph("Article 4 — Term and Termination")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.1 At-Will Employment. ").bold(true);
        p.add_run(
            "This Agreement is for at-will employment and may be terminated by either Party \
                   at any time, with or without cause, subject to the notice provisions herein.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.2 Notice Period. ").bold(true);
        p.add_run("Either Party shall provide ");
        p.add_run("ninety (90) days").bold(true);
        p.add_run(" written notice of termination, or pay in lieu thereof.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.3 Severance. ").bold(true);
        p.add_run("In the event of termination by the Company without Cause, the Employee shall \
                   receive (a) twelve (12) months of base salary continuation, (b) pro-rata bonus \
                   for the year of termination, and (c) twelve (12) months of COBRA premium coverage.");
    }

    // ── Article 5: Confidentiality ──
    doc.add_paragraph("Article 5 — Confidentiality and IP")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.1 ").bold(true);
        p.add_run(
            "The Employee agrees to maintain strict confidentiality of all proprietary \
                   information, trade secrets, and business plans of the Company during and after \
                   employment.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.2 ").bold(true);
        p.add_run(
            "All intellectual property, inventions, and works of authorship created by the \
                   Employee during the term of employment and within the scope of duties shall be \
                   the sole and exclusive property of the Company.",
        );
    }

    // ── Article 6: Non-Compete ──
    doc.add_paragraph("Article 6 — Non-Competition")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("6.1 ").bold(true);
        p.add_run("For a period of twelve (12) months following termination, the Employee agrees \
                   not to engage in any business that directly competes with the Company's core \
                   business of AI infrastructure and ML operations services, within the United States.");
    }

    // ── Article 7: General Provisions ──
    doc.add_paragraph("Article 7 — General Provisions")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.1 Governing Law. ").bold(true);
        p.add_run(
            "This Agreement shall be governed by and construed in accordance with the laws of \
                   the State of California.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.2 Entire Agreement. ").bold(true);
        p.add_run(
            "This Agreement constitutes the entire agreement between the Parties and supersedes \
                   all prior negotiations, representations, and agreements.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.3 Amendment. ").bold(true);
        p.add_run(
            "This Agreement may only be amended by a written instrument signed by both Parties.",
        );
    }

    // ── Signature Block ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("IN WITNESS WHEREOF, the Parties have executed this Employment Agreement as of the Effective Date.")
        .space_after(Length::pt(24.0));

    // Signature table
    {
        let mut tbl = doc.add_table(6, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("FOR THE COMPANY:");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("EMPLOYEE:");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");

        tbl.cell(1, 0).unwrap().set_text("");
        tbl.cell(1, 1).unwrap().set_text("");
        tbl.row(1).unwrap().height(Length::pt(40.0));

        tbl.cell(2, 0)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(3, 0)
            .unwrap()
            .set_text("Name: Board Representative");
        tbl.cell(3, 1).unwrap().set_text("Name: Walter White");
        tbl.cell(4, 0)
            .unwrap()
            .set_text("Title: Chair, Board of Directors");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Title: Chief Executive Officer");
        tbl.cell(5, 0).unwrap().set_text("Date: _______________");
        tbl.cell(5, 1).unwrap().set_text("Date: _______________");
    }

    doc
}

pub fn table_count(&self) -> usize

Get the number of tables.

pub fn content_count(&self) -> usize

Get the number of body content elements (paragraphs + tables).

Examples found in repository

examples/generate_all_samples.rs (line 156)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

pub fn insert_paragraph(&mut self, index: usize, text: &str) -> Paragraph<'_>

Insert a paragraph at the given body index.

Returns a mutable Paragraph for further configuration.

Panics

Panics if index > content_count(). (Unlike Self::insert_document and Self::insert_toc, which clamp an out-of-range index to the end.)

Examples found in repository

examples/template_replace.rs (line 198)

fn fill_template(template_path: &Path, output_path: &Path) {
    let mut doc = Document::open(template_path).unwrap();

    // ── Batch replacement ──
    let mut replacements = HashMap::new();
    replacements.insert("{{company_name}}", "Riverside Medical Center");
    replacements.insert("{{project_name}}", "Network Security Upgrade");
    replacements.insert("{{contact_name}}", "Dr. Sarah Chen");
    replacements.insert("{{contact_email}}", "s.chen@riverside.org");
    replacements.insert("{{start_date}}", "March 1, 2026");
    replacements.insert("{{duration}}", "12 weeks");
    replacements.insert("{{budget}}", "$185,000");
    replacements.insert("{{status}}", "Pending Approval");
    replacements.insert("{{author_name}}", "James Wilson");
    replacements.insert("{{date}}", "February 22, 2026");

    // Team members
    replacements.insert("{{member1_name}}", "James Wilson");
    replacements.insert("{{member1_role}}", "Project Lead");
    replacements.insert("{{member1_email}}", "j.wilson@provider.com");
    replacements.insert("{{member2_name}}", "Maria Garcia");
    replacements.insert("{{member2_role}}", "Security Architect");
    replacements.insert("{{member2_email}}", "m.garcia@provider.com");
    replacements.insert("{{member3_name}}", "David Park");
    replacements.insert("{{member3_role}}", "Network Engineer");
    replacements.insert("{{member3_email}}", "d.park@provider.com");

    let count = doc.replace_all(&replacements);
    println!("  Replaced {} placeholders", count);

    // ── Insert deliverables at the insertion point ──
    if let Some(idx) = doc.find_content_index("INSERTION_POINT") {
        // Remove the placeholder paragraph
        doc.remove_content(idx);

        // Insert deliverables list
        doc.insert_paragraph(idx, "The following deliverables are included:");

        // Insert a deliverables table
        let mut tbl = doc.insert_table(idx + 1, 5, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("E2EFDA");
        }
        tbl.cell(0, 0).unwrap().set_text("Phase");
        tbl.cell(0, 1).unwrap().set_text("Description");
        tbl.cell(0, 2).unwrap().set_text("Timeline");

        tbl.cell(1, 0).unwrap().set_text("1. Discovery");
        tbl.cell(1, 1)
            .unwrap()
            .set_text("Network assessment and asset inventory");
        tbl.cell(1, 2).unwrap().set_text("Weeks 1-3");

        tbl.cell(2, 0).unwrap().set_text("2. Design");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Security architecture and policy design");
        tbl.cell(2, 2).unwrap().set_text("Weeks 4-6");

        tbl.cell(3, 0).unwrap().set_text("3. Implementation");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("Deploy monitoring and access controls");
        tbl.cell(3, 2).unwrap().set_text("Weeks 7-10");

        tbl.cell(4, 0).unwrap().set_text("4. Validation");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Testing, training, and handover");
        tbl.cell(4, 2).unwrap().set_text("Weeks 11-12");

        println!("  Inserted deliverables table at position {}", idx);
    }

    // ── Update metadata ──
    doc.set_title("Riverside Medical Center — Network Security Upgrade Proposal");
    doc.set_author("James Wilson");
    doc.set_subject("Project Proposal");
    doc.set_keywords("security, network, medical, proposal");

    doc.save(output_path).unwrap();
}

examples/generate_all_samples.rs (lines 556-559)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

pub fn insert_table( &mut self, index: usize, rows: usize, cols: usize, ) -> Table<'_>

Insert a table at the given body index.

Returns a mutable Table for further configuration. A cols of 0 produces a table with no columns rather than panicking.

Panics

Panics if index > content_count(). (Unlike Self::insert_document and Self::insert_toc, which clamp an out-of-range index to the end.)

Examples found in repository

examples/template_replace.rs (line 201)

fn fill_template(template_path: &Path, output_path: &Path) {
    let mut doc = Document::open(template_path).unwrap();

    // ── Batch replacement ──
    let mut replacements = HashMap::new();
    replacements.insert("{{company_name}}", "Riverside Medical Center");
    replacements.insert("{{project_name}}", "Network Security Upgrade");
    replacements.insert("{{contact_name}}", "Dr. Sarah Chen");
    replacements.insert("{{contact_email}}", "s.chen@riverside.org");
    replacements.insert("{{start_date}}", "March 1, 2026");
    replacements.insert("{{duration}}", "12 weeks");
    replacements.insert("{{budget}}", "$185,000");
    replacements.insert("{{status}}", "Pending Approval");
    replacements.insert("{{author_name}}", "James Wilson");
    replacements.insert("{{date}}", "February 22, 2026");

    // Team members
    replacements.insert("{{member1_name}}", "James Wilson");
    replacements.insert("{{member1_role}}", "Project Lead");
    replacements.insert("{{member1_email}}", "j.wilson@provider.com");
    replacements.insert("{{member2_name}}", "Maria Garcia");
    replacements.insert("{{member2_role}}", "Security Architect");
    replacements.insert("{{member2_email}}", "m.garcia@provider.com");
    replacements.insert("{{member3_name}}", "David Park");
    replacements.insert("{{member3_role}}", "Network Engineer");
    replacements.insert("{{member3_email}}", "d.park@provider.com");

    let count = doc.replace_all(&replacements);
    println!("  Replaced {} placeholders", count);

    // ── Insert deliverables at the insertion point ──
    if let Some(idx) = doc.find_content_index("INSERTION_POINT") {
        // Remove the placeholder paragraph
        doc.remove_content(idx);

        // Insert deliverables list
        doc.insert_paragraph(idx, "The following deliverables are included:");

        // Insert a deliverables table
        let mut tbl = doc.insert_table(idx + 1, 5, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("E2EFDA");
        }
        tbl.cell(0, 0).unwrap().set_text("Phase");
        tbl.cell(0, 1).unwrap().set_text("Description");
        tbl.cell(0, 2).unwrap().set_text("Timeline");

        tbl.cell(1, 0).unwrap().set_text("1. Discovery");
        tbl.cell(1, 1)
            .unwrap()
            .set_text("Network assessment and asset inventory");
        tbl.cell(1, 2).unwrap().set_text("Weeks 1-3");

        tbl.cell(2, 0).unwrap().set_text("2. Design");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Security architecture and policy design");
        tbl.cell(2, 2).unwrap().set_text("Weeks 4-6");

        tbl.cell(3, 0).unwrap().set_text("3. Implementation");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("Deploy monitoring and access controls");
        tbl.cell(3, 2).unwrap().set_text("Weeks 7-10");

        tbl.cell(4, 0).unwrap().set_text("4. Validation");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Testing, training, and handover");
        tbl.cell(4, 2).unwrap().set_text("Weeks 11-12");

        println!("  Inserted deliverables table at position {}", idx);
    }

    // ── Update metadata ──
    doc.set_title("Riverside Medical Center — Network Security Upgrade Proposal");
    doc.set_author("James Wilson");
    doc.set_subject("Project Proposal");
    doc.set_keywords("security, network, medical, proposal");

    doc.save(output_path).unwrap();
}

pub fn find_content_index(&self, text: &str) -> Option<usize>

Find the body content index of the first paragraph containing the given text.

Examples found in repository

examples/template_replace.rs (line 193)

fn fill_template(template_path: &Path, output_path: &Path) {
    let mut doc = Document::open(template_path).unwrap();

    // ── Batch replacement ──
    let mut replacements = HashMap::new();
    replacements.insert("{{company_name}}", "Riverside Medical Center");
    replacements.insert("{{project_name}}", "Network Security Upgrade");
    replacements.insert("{{contact_name}}", "Dr. Sarah Chen");
    replacements.insert("{{contact_email}}", "s.chen@riverside.org");
    replacements.insert("{{start_date}}", "March 1, 2026");
    replacements.insert("{{duration}}", "12 weeks");
    replacements.insert("{{budget}}", "$185,000");
    replacements.insert("{{status}}", "Pending Approval");
    replacements.insert("{{author_name}}", "James Wilson");
    replacements.insert("{{date}}", "February 22, 2026");

    // Team members
    replacements.insert("{{member1_name}}", "James Wilson");
    replacements.insert("{{member1_role}}", "Project Lead");
    replacements.insert("{{member1_email}}", "j.wilson@provider.com");
    replacements.insert("{{member2_name}}", "Maria Garcia");
    replacements.insert("{{member2_role}}", "Security Architect");
    replacements.insert("{{member2_email}}", "m.garcia@provider.com");
    replacements.insert("{{member3_name}}", "David Park");
    replacements.insert("{{member3_role}}", "Network Engineer");
    replacements.insert("{{member3_email}}", "d.park@provider.com");

    let count = doc.replace_all(&replacements);
    println!("  Replaced {} placeholders", count);

    // ── Insert deliverables at the insertion point ──
    if let Some(idx) = doc.find_content_index("INSERTION_POINT") {
        // Remove the placeholder paragraph
        doc.remove_content(idx);

        // Insert deliverables list
        doc.insert_paragraph(idx, "The following deliverables are included:");

        // Insert a deliverables table
        let mut tbl = doc.insert_table(idx + 1, 5, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("E2EFDA");
        }
        tbl.cell(0, 0).unwrap().set_text("Phase");
        tbl.cell(0, 1).unwrap().set_text("Description");
        tbl.cell(0, 2).unwrap().set_text("Timeline");

        tbl.cell(1, 0).unwrap().set_text("1. Discovery");
        tbl.cell(1, 1)
            .unwrap()
            .set_text("Network assessment and asset inventory");
        tbl.cell(1, 2).unwrap().set_text("Weeks 1-3");

        tbl.cell(2, 0).unwrap().set_text("2. Design");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Security architecture and policy design");
        tbl.cell(2, 2).unwrap().set_text("Weeks 4-6");

        tbl.cell(3, 0).unwrap().set_text("3. Implementation");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("Deploy monitoring and access controls");
        tbl.cell(3, 2).unwrap().set_text("Weeks 7-10");

        tbl.cell(4, 0).unwrap().set_text("4. Validation");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Testing, training, and handover");
        tbl.cell(4, 2).unwrap().set_text("Weeks 11-12");

        println!("  Inserted deliverables table at position {}", idx);
    }

    // ── Update metadata ──
    doc.set_title("Riverside Medical Center — Network Security Upgrade Proposal");
    doc.set_author("James Wilson");
    doc.set_subject("Project Proposal");
    doc.set_keywords("security, network, medical, proposal");

    doc.save(output_path).unwrap();
}

examples/generate_all_samples.rs (line 555)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

pub fn remove_content(&mut self, index: usize) -> bool

Remove the content at the given body index.

Returns true if an element was removed, false if the index was out of bounds.

Examples found in repository

examples/template_replace.rs (line 195)

fn fill_template(template_path: &Path, output_path: &Path) {
    let mut doc = Document::open(template_path).unwrap();

    // ── Batch replacement ──
    let mut replacements = HashMap::new();
    replacements.insert("{{company_name}}", "Riverside Medical Center");
    replacements.insert("{{project_name}}", "Network Security Upgrade");
    replacements.insert("{{contact_name}}", "Dr. Sarah Chen");
    replacements.insert("{{contact_email}}", "s.chen@riverside.org");
    replacements.insert("{{start_date}}", "March 1, 2026");
    replacements.insert("{{duration}}", "12 weeks");
    replacements.insert("{{budget}}", "$185,000");
    replacements.insert("{{status}}", "Pending Approval");
    replacements.insert("{{author_name}}", "James Wilson");
    replacements.insert("{{date}}", "February 22, 2026");

    // Team members
    replacements.insert("{{member1_name}}", "James Wilson");
    replacements.insert("{{member1_role}}", "Project Lead");
    replacements.insert("{{member1_email}}", "j.wilson@provider.com");
    replacements.insert("{{member2_name}}", "Maria Garcia");
    replacements.insert("{{member2_role}}", "Security Architect");
    replacements.insert("{{member2_email}}", "m.garcia@provider.com");
    replacements.insert("{{member3_name}}", "David Park");
    replacements.insert("{{member3_role}}", "Network Engineer");
    replacements.insert("{{member3_email}}", "d.park@provider.com");

    let count = doc.replace_all(&replacements);
    println!("  Replaced {} placeholders", count);

    // ── Insert deliverables at the insertion point ──
    if let Some(idx) = doc.find_content_index("INSERTION_POINT") {
        // Remove the placeholder paragraph
        doc.remove_content(idx);

        // Insert deliverables list
        doc.insert_paragraph(idx, "The following deliverables are included:");

        // Insert a deliverables table
        let mut tbl = doc.insert_table(idx + 1, 5, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("E2EFDA");
        }
        tbl.cell(0, 0).unwrap().set_text("Phase");
        tbl.cell(0, 1).unwrap().set_text("Description");
        tbl.cell(0, 2).unwrap().set_text("Timeline");

        tbl.cell(1, 0).unwrap().set_text("1. Discovery");
        tbl.cell(1, 1)
            .unwrap()
            .set_text("Network assessment and asset inventory");
        tbl.cell(1, 2).unwrap().set_text("Weeks 1-3");

        tbl.cell(2, 0).unwrap().set_text("2. Design");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Security architecture and policy design");
        tbl.cell(2, 2).unwrap().set_text("Weeks 4-6");

        tbl.cell(3, 0).unwrap().set_text("3. Implementation");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("Deploy monitoring and access controls");
        tbl.cell(3, 2).unwrap().set_text("Weeks 7-10");

        tbl.cell(4, 0).unwrap().set_text("4. Validation");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Testing, training, and handover");
        tbl.cell(4, 2).unwrap().set_text("Weeks 11-12");

        println!("  Inserted deliverables table at position {}", idx);
    }

    // ── Update metadata ──
    doc.set_title("Riverside Medical Center — Network Security Upgrade Proposal");
    doc.set_author("James Wilson");
    doc.set_subject("Project Proposal");
    doc.set_keywords("security, network, medical, proposal");

    doc.save(output_path).unwrap();
}

pub fn add_picture( &mut self, image_data: &[u8], image_filename: &str, width: Length, height: Length, ) -> Paragraph<'_>

Add an inline image to the document.

Embeds the image data (PNG, JPEG, etc.) into the package and adds a paragraph containing the image. Returns a mutable reference to the paragraph for further configuration.

width and height specify the display size.

Examples found in repository

examples/generate_all_samples.rs (line 496)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

pub fn add_picture_auto( &mut self, image_data: &[u8], image_filename: &str, ) -> Result<Paragraph<'_>>

Add an inline image at its native size using 72 DPI when none is declared.

Returns an error without changing the document when the image dimensions cannot be determined.

pub fn add_background_image( &mut self, image_data: &[u8], image_filename: &str, ) -> Paragraph<'_>

Add a full-page background image behind text.

The image is placed at position (0,0) relative to the page with dimensions matching the page size from section properties. It is inserted at the beginning of the document body so it renders behind all other content.

Examples found in repository

examples/generate_all_samples.rs (line 124)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

pub fn add_anchored_image( &mut self, image_data: &[u8], image_filename: &str, width: Length, height: Length, behind_text: bool, ) -> Paragraph<'_>

Add an anchored (floating) image to the document.

If behind_text is true, the image renders behind text content. The image is inserted at the beginning of the document body.

pub fn embed_image(&mut self, image_data: &[u8], filename: &str) -> String

Embed an image into the OPC package and return the relationship ID.

Public so callers can pre-embed an image and then pass the returned rel_id to crate::Cell::add_picture for inline cell images.

pub fn numbering_is_bullet(&self, num_id: u32) -> Option<bool>

Whether the given numbering definition renders as bullets (true) or numbers (false). None if the id is unknown.

pub fn append_hyperlink(&mut self, text: &str, url: &str)

Append an external hyperlink to the last paragraph (creating one if the document is empty): adds the External relationship and wraps the new run in a hyperlink span.

pub fn add_hyperlink_relationship(&mut self, url: &str) -> String

Add an external hyperlink relationship and return its relationship ID.

Use this with crate::Paragraph::add_hyperlink when the target paragraph is not the last body paragraph, such as a paragraph inside a table cell.

pub fn last_paragraph_mut(&mut self) -> Option<Paragraph<'_>>

Get a builder for the last paragraph in the body, if any. Lets callers interleave plain runs with append_hyperlink calls.

pub fn image_data(&self, rel_id: &str) -> Option<Vec<u8>>

Fetch the raw bytes of an embedded image by its relationship ID.

pub fn hyperlink_url(&self, rel_id: &str) -> Option<String>

Resolve a hyperlink relationship ID to its external URL.

pub fn set_header(&mut self, text: &str)

Set the default header text.

Creates a header part with the given text and references it from the section properties.

Examples found in repository

examples/template_replace.rs (line 53)

fn create_template(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );

    doc.set_header("{{company_name}} — Confidential");
    doc.set_footer("Prepared by {{author_name}} on {{date}}");

    // ── Title ──
    doc.add_paragraph("{{company_name}}")
        .style("Heading1")
        .alignment(Alignment::Center);

    doc.add_paragraph("Project Proposal")
        .alignment(Alignment::Center);

    doc.add_paragraph("");

    // ── Summary section ──
    doc.add_paragraph("Executive Summary").style("Heading2");

    doc.add_paragraph(
        "This proposal outlines the {{project_name}} project for {{company_name}}. \
         The primary contact is {{contact_name}} ({{contact_email}}). \
         The proposed start date is {{start_date}} with an estimated duration of {{duration}}.",
    );

    doc.add_paragraph("");

    // ── Cross-run placeholder (bold label + normal value) ──
    doc.add_paragraph("Key Details").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Project: ").bold(true);
        p.add_run("{{project_name}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Budget: ").bold(true);
        p.add_run("{{budget}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Status: ").bold(true);
        p.add_run("{{status}}");
    }

    doc.add_paragraph("");

    // ── Table with placeholders ──
    doc.add_paragraph("Team Members").style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        // Header row
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Email");

        tbl.cell(1, 0).unwrap().set_text("{{member1_name}}");
        tbl.cell(1, 1).unwrap().set_text("{{member1_role}}");
        tbl.cell(1, 2).unwrap().set_text("{{member1_email}}");

        tbl.cell(2, 0).unwrap().set_text("{{member2_name}}");
        tbl.cell(2, 1).unwrap().set_text("{{member2_role}}");
        tbl.cell(2, 2).unwrap().set_text("{{member2_email}}");

        tbl.cell(3, 0).unwrap().set_text("{{member3_name}}");
        tbl.cell(3, 1).unwrap().set_text("{{member3_role}}");
        tbl.cell(3, 2).unwrap().set_text("{{member3_email}}");
    }

    doc.add_paragraph("");

    // ── Deliverables section ──
    doc.add_paragraph("Deliverables").style("Heading2");

    doc.add_paragraph("INSERTION_POINT");

    doc.add_paragraph("");

    // ── Signature block ──
    doc.add_paragraph("Acceptance").style("Heading2");

    doc.add_paragraph(
        "By signing below, {{company_name}} agrees to the terms outlined in this proposal.",
    );

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer: ___________________");
        tbl.cell(0, 1)
            .unwrap()
            .set_text("Provider: ___________________");
        tbl.cell(1, 0).unwrap().set_text("Date: {{date}}");
        tbl.cell(1, 1).unwrap().set_text("Date: {{date}}");
    }

    doc.set_title("{{company_name}} — Project Proposal Template");
    doc.set_author("Template Generator");

    doc.save(path).unwrap();
}

examples/generate_all_samples.rs (line 119)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

// =============================================================================
// 6. LETTER — Slate blue + silver scheme
// =============================================================================
fn generate_letter(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Slate #4A5568, Blue accent #3182CE
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
    );
    doc.set_title("Business Letter");
    doc.set_author("Walter White");

    // Banner header using raw XML
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "4A5568",
            banner_width: 7772400,
            banner_height: 731520, // ~0.8"
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 146304,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_margins(
        Length::twips(2000),
        Length::twips(1800),
        Length::twips(1440),
        Length::twips(1800),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Footer with contact
    doc.set_footer(
        "Tensorbee | 123 Innovation Drive, Suite 400 | San Francisco, CA 94105 | tensorbee.com",
    );

    // ── Sender Address ──
    doc.add_paragraph("Walter White");
    doc.add_paragraph("Chief Executive Officer");
    doc.add_paragraph("Tensorbee");
    doc.add_paragraph("123 Innovation Drive, Suite 400");
    doc.add_paragraph("San Francisco, CA 94105");
    doc.add_paragraph("");
    doc.add_paragraph("February 22, 2026");

    doc.add_paragraph("");

    // ── Recipient ──
    doc.add_paragraph("Ms. Sarah Chen");
    doc.add_paragraph("VP of Engineering");
    doc.add_paragraph("Meridian Dynamics LLC");
    doc.add_paragraph("456 Enterprise Boulevard");
    doc.add_paragraph("Austin, TX 78701");

    doc.add_paragraph("");

    // ── Subject ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Re: Strategic Technology Partnership — Phase 2 Expansion")
            .bold(true);
    }

    doc.add_paragraph("");

    // ── Body ──
    doc.add_paragraph("Dear Ms. Chen,");
    doc.add_paragraph("");

    doc.add_paragraph(
        "I am writing to express Tensorbee's enthusiasm for expanding our strategic technology \
         partnership with Meridian Dynamics. Following the successful completion of Phase 1, \
         which delivered a 40% improvement in your ML inference pipeline throughput, we believe \
         the foundation is firmly established for an ambitious Phase 2 engagement.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "During our recent executive review, your team highlighted three priority areas for \
         the next phase of collaboration:",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_numbered_list_item(
        "Real-time anomaly detection for your financial transaction monitoring system, \
         targeting sub-100ms latency at 50,000 transactions per second.",
        0,
    );
    doc.add_numbered_list_item(
        "Federated learning infrastructure to enable model training across your distributed \
         data centers without centralizing sensitive financial data.",
        0,
    );
    doc.add_numbered_list_item(
        "MLOps automation to reduce your model deployment cycle from the current 5 days \
         to under 4 hours.",
        0,
    );

    doc.add_paragraph(
        "Our engineering team has prepared a detailed technical proposal addressing each of \
         these areas. We have allocated a dedicated team of eight senior engineers, led by \
         our CTO, to ensure continuity with the Phase 1 team your organization has already \
         built a productive working relationship with.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "I would welcome the opportunity to present our Phase 2 proposal in person. My \
         assistant will reach out to coordinate a meeting at your convenience during the \
         first week of March.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("");

    doc.add_paragraph("Warm regards,");
    doc.add_paragraph("");
    doc.add_paragraph("");

    // Signature line
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "4A5568");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Walter White").bold(true).size(12.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Chief Executive Officer, Tensorbee")
            .italic(true)
            .size(10.0)
            .color("666666");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("walter@tensorbee.com | +1 (415) 555-0199")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 7. EMPLOYMENT CONTRACT — Purple + charcoal scheme
// =============================================================================
fn generate_contract(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Purple #5B2C6F, Plum #8E44AD, Gray #2C3E50
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Employment Agreement");
    doc.set_author("Tensorbee HR Department");
    doc.set_subject("Employment Contract — Walter White");
    doc.set_keywords("employment, contract, agreement, Tensorbee");

    doc.set_header("TENSORBEE — Employment Agreement");
    doc.set_footer("Employment Agreement — Walter White — Page");

    // ── Title Block ──
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("EMPLOYMENT AGREEMENT")
            .bold(true)
            .size(24.0)
            .color("5B2C6F")
            .font("Georgia");
    }
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    doc.add_paragraph("");

    // ── Parties ──
    doc.add_paragraph(
        "This Employment Agreement (\"Agreement\") is entered into as of February 22, 2026 \
         (\"Effective Date\"), by and between:",
    );

    doc.add_paragraph("");

    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYER: ").bold(true);
        p.add_run(
            "Tensorbee, Inc., a Delaware corporation with its principal place of business at \
                   123 Innovation Drive, Suite 400, San Francisco, CA 94105 (\"Company\")",
        );
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYEE: ").bold(true);
        p.add_run(
            "Walter White, residing at 308 Negra Arroyo Lane, Albuquerque, NM 87104 (\"Employee\")",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph("The Company and Employee are collectively referred to as the \"Parties.\"");
    doc.add_paragraph("");

    // ── Article 1: Position and Duties ──
    doc.add_paragraph("Article 1 — Position and Duties")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.1 ").bold(true);
        p.add_run("The Company hereby employs the Employee as ");
        p.add_run("Chief Executive Officer (CEO)")
            .bold(true)
            .italic(true);
        p.add_run(", reporting directly to the Board of Directors.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.2 ").bold(true);
        p.add_run("The Employee shall devote full working time, attention, and best efforts to \
                   the performance of duties as reasonably assigned by the Board, including but not limited to:");
    }
    doc.add_bullet_list_item(
        "Setting and executing the Company's strategic vision and business plan",
        0,
    );
    doc.add_bullet_list_item(
        "Overseeing all operations, engineering, and commercial activities",
        0,
    );
    doc.add_bullet_list_item(
        "Representing the Company to investors, customers, and the public",
        0,
    );
    doc.add_bullet_list_item("Recruiting, developing, and retaining key talent", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.3 ").bold(true);
        p.add_run(
            "The Employee's primary work location shall be the Company's San Francisco \
                   headquarters, with reasonable travel as required by business needs.",
        );
    }

    // ── Article 2: Compensation ──
    doc.add_paragraph("Article 2 — Compensation and Benefits")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.1 Base Salary. ").bold(true);
        p.add_run("The Company shall pay the Employee an annual base salary of ");
        p.add_run("$375,000.00").bold(true);
        p.add_run(" (Three Hundred Seventy-Five Thousand Dollars), payable in accordance with the \
                   Company's standard payroll schedule, less applicable withholdings and deductions.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.2 Annual Bonus. ").bold(true);
        p.add_run("The Employee shall be eligible for an annual performance bonus of up to ");
        p.add_run("40%").bold(true);
        p.add_run(
            " of base salary, based on achievement of mutually agreed performance objectives.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.3 Equity. ").bold(true);
        p.add_run("Subject to Board approval, the Employee shall receive a stock option grant of ");
        p.add_run("500,000 shares").bold(true);
        p.add_run(
            " of the Company's common stock, vesting over four (4) years with a one-year cliff, \
                   at an exercise price equal to the fair market value on the date of grant.",
        );
    }

    // Compensation summary table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "5B2C6F")
            .width_pct(70.0)
            .alignment(Alignment::Center);
        tbl.cell(0, 0).unwrap().set_text("Compensation Element");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");
        let items = [
            ("Base Salary", "$375,000/year"),
            ("Target Bonus", "Up to 40% ($150,000)"),
            ("Equity Grant", "500,000 shares (4yr vest)"),
            ("Total Target Comp", "$525,000 + equity"),
        ];
        for (i, (elem, val)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(elem);
            tbl.cell(i + 1, 1).unwrap().set_text(val);
            if i == 3 {
                tbl.cell(i + 1, 0).unwrap().shading("E8DAEF");
                tbl.cell(i + 1, 1).unwrap().shading("E8DAEF");
            }
        }
    }

    // ── Article 3: Benefits ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Article 3 — Benefits").style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.1 ").bold(true);
        p.add_run(
            "The Employee shall be entitled to participate in all benefit programs \
                   generally available to senior executives, including:",
        );
    }
    doc.add_bullet_list_item(
        "Medical, dental, and vision insurance (100% premium coverage for employee and dependents)",
        0,
    );
    doc.add_bullet_list_item("401(k) retirement plan with 6% company match", 0);
    doc.add_bullet_list_item("Life insurance and long-term disability coverage", 0);
    doc.add_bullet_list_item("Annual professional development allowance of $10,000", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.2 Paid Time Off. ").bold(true);
        p.add_run(
            "The Employee shall receive 25 days of paid vacation per year, plus Company holidays, \
                   accruing on a monthly basis.",
        );
    }

    // ── Article 4: Term and Termination ──
    doc.add_paragraph("Article 4 — Term and Termination")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.1 At-Will Employment. ").bold(true);
        p.add_run(
            "This Agreement is for at-will employment and may be terminated by either Party \
                   at any time, with or without cause, subject to the notice provisions herein.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.2 Notice Period. ").bold(true);
        p.add_run("Either Party shall provide ");
        p.add_run("ninety (90) days").bold(true);
        p.add_run(" written notice of termination, or pay in lieu thereof.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.3 Severance. ").bold(true);
        p.add_run("In the event of termination by the Company without Cause, the Employee shall \
                   receive (a) twelve (12) months of base salary continuation, (b) pro-rata bonus \
                   for the year of termination, and (c) twelve (12) months of COBRA premium coverage.");
    }

    // ── Article 5: Confidentiality ──
    doc.add_paragraph("Article 5 — Confidentiality and IP")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.1 ").bold(true);
        p.add_run(
            "The Employee agrees to maintain strict confidentiality of all proprietary \
                   information, trade secrets, and business plans of the Company during and after \
                   employment.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.2 ").bold(true);
        p.add_run(
            "All intellectual property, inventions, and works of authorship created by the \
                   Employee during the term of employment and within the scope of duties shall be \
                   the sole and exclusive property of the Company.",
        );
    }

    // ── Article 6: Non-Compete ──
    doc.add_paragraph("Article 6 — Non-Competition")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("6.1 ").bold(true);
        p.add_run("For a period of twelve (12) months following termination, the Employee agrees \
                   not to engage in any business that directly competes with the Company's core \
                   business of AI infrastructure and ML operations services, within the United States.");
    }

    // ── Article 7: General Provisions ──
    doc.add_paragraph("Article 7 — General Provisions")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.1 Governing Law. ").bold(true);
        p.add_run(
            "This Agreement shall be governed by and construed in accordance with the laws of \
                   the State of California.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.2 Entire Agreement. ").bold(true);
        p.add_run(
            "This Agreement constitutes the entire agreement between the Parties and supersedes \
                   all prior negotiations, representations, and agreements.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.3 Amendment. ").bold(true);
        p.add_run(
            "This Agreement may only be amended by a written instrument signed by both Parties.",
        );
    }

    // ── Signature Block ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("IN WITNESS WHEREOF, the Parties have executed this Employment Agreement as of the Effective Date.")
        .space_after(Length::pt(24.0));

    // Signature table
    {
        let mut tbl = doc.add_table(6, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("FOR THE COMPANY:");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("EMPLOYEE:");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");

        tbl.cell(1, 0).unwrap().set_text("");
        tbl.cell(1, 1).unwrap().set_text("");
        tbl.row(1).unwrap().height(Length::pt(40.0));

        tbl.cell(2, 0)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(3, 0)
            .unwrap()
            .set_text("Name: Board Representative");
        tbl.cell(3, 1).unwrap().set_text("Name: Walter White");
        tbl.cell(4, 0)
            .unwrap()
            .set_text("Title: Chair, Board of Directors");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Title: Chief Executive Officer");
        tbl.cell(5, 0).unwrap().set_text("Date: _______________");
        tbl.cell(5, 1).unwrap().set_text("Date: _______________");
    }

    doc
}

pub fn set_footer(&mut self, text: &str)

Set the default footer text.

Examples found in repository

examples/template_replace.rs (line 54)

fn create_template(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );

    doc.set_header("{{company_name}} — Confidential");
    doc.set_footer("Prepared by {{author_name}} on {{date}}");

    // ── Title ──
    doc.add_paragraph("{{company_name}}")
        .style("Heading1")
        .alignment(Alignment::Center);

    doc.add_paragraph("Project Proposal")
        .alignment(Alignment::Center);

    doc.add_paragraph("");

    // ── Summary section ──
    doc.add_paragraph("Executive Summary").style("Heading2");

    doc.add_paragraph(
        "This proposal outlines the {{project_name}} project for {{company_name}}. \
         The primary contact is {{contact_name}} ({{contact_email}}). \
         The proposed start date is {{start_date}} with an estimated duration of {{duration}}.",
    );

    doc.add_paragraph("");

    // ── Cross-run placeholder (bold label + normal value) ──
    doc.add_paragraph("Key Details").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Project: ").bold(true);
        p.add_run("{{project_name}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Budget: ").bold(true);
        p.add_run("{{budget}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Status: ").bold(true);
        p.add_run("{{status}}");
    }

    doc.add_paragraph("");

    // ── Table with placeholders ──
    doc.add_paragraph("Team Members").style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        // Header row
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Email");

        tbl.cell(1, 0).unwrap().set_text("{{member1_name}}");
        tbl.cell(1, 1).unwrap().set_text("{{member1_role}}");
        tbl.cell(1, 2).unwrap().set_text("{{member1_email}}");

        tbl.cell(2, 0).unwrap().set_text("{{member2_name}}");
        tbl.cell(2, 1).unwrap().set_text("{{member2_role}}");
        tbl.cell(2, 2).unwrap().set_text("{{member2_email}}");

        tbl.cell(3, 0).unwrap().set_text("{{member3_name}}");
        tbl.cell(3, 1).unwrap().set_text("{{member3_role}}");
        tbl.cell(3, 2).unwrap().set_text("{{member3_email}}");
    }

    doc.add_paragraph("");

    // ── Deliverables section ──
    doc.add_paragraph("Deliverables").style("Heading2");

    doc.add_paragraph("INSERTION_POINT");

    doc.add_paragraph("");

    // ── Signature block ──
    doc.add_paragraph("Acceptance").style("Heading2");

    doc.add_paragraph(
        "By signing below, {{company_name}} agrees to the terms outlined in this proposal.",
    );

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer: ___________________");
        tbl.cell(0, 1)
            .unwrap()
            .set_text("Provider: ___________________");
        tbl.cell(1, 0).unwrap().set_text("Date: {{date}}");
        tbl.cell(1, 1).unwrap().set_text("Date: {{date}}");
    }

    doc.set_title("{{company_name}} — Project Proposal Template");
    doc.set_author("Template Generator");

    doc.save(path).unwrap();
}

examples/header_banner.rs (line 86)

fn generate_header_banner_doc(path: &Path) {
    let mut doc = Document::new();

    // Page setup with extra top margin for the banner
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::twips(2292), // top — extra tall for header banner
        Length::twips(1440), // right
        Length::twips(1440), // bottom
        Length::twips(1440), // left
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Generate a simple logo image (white text on transparent background)
    let logo_img = create_logo_png(220, 48);

    // ── Dark blue banner ──
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1A3C6E",
            banner_width: 7772400, // full page width in EMU (~8.5")
            banner_height: 969026, // banner height in EMU (~1.06")
            logo_width: 2011680,   // logo display width (~2.2")
            logo_height: 438912,   // logo display height (~0.48")
            logo_x_offset: 295125, // left padding
            logo_y_offset: 265057, // vertical centering
        },
    );

    doc.set_raw_header_with_images(
        banner.clone(),
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );

    // Use a different first page header (same banner, different color)
    doc.set_different_first_page(true);
    let first_page_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "2E75B6", // lighter blue for cover
            banner_width: 7772400,
            banner_height: 969026,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 265057,
        },
    );
    doc.set_raw_header_with_images(
        first_page_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );

    // Footer
    doc.set_footer("Confidential — Internal Use Only");

    // ── Page 1: Cover ──
    doc.add_paragraph("Company Report").style("Heading1");

    doc.add_paragraph(
        "This document demonstrates a custom header banner built with DrawingML \
         group shapes. The banner uses a colored rectangle with a logo image overlaid, \
         positioned at the top of each page.",
    );

    doc.add_paragraph("");

    doc.add_paragraph("How the Header Banner Works")
        .style("Heading2");

    doc.add_paragraph(
        "The header banner is built using set_raw_header_with_images(), which \
         accepts raw XML and a list of (rel_id, image_data, filename) tuples. \
         The XML uses a DrawingML group shape (wpg:wgp) containing:",
    );

    doc.add_bullet_list_item(
        "A wps:wsp rectangle shape with a solid color fill (the background bar)",
        0,
    );
    doc.add_bullet_list_item(
        "A pic:pic image element positioned within the group (the logo)",
        0,
    );
    doc.add_bullet_list_item(
        "The group is wrapped in a wp:anchor element for absolute page positioning",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Customization").style("Heading2");

    doc.add_paragraph(
        "All dimensions are in EMU (English Metric Units) where 914400 EMU = 1 inch. \
         You can customize:",
    );

    doc.add_bullet_list_item("bg_color — any hex color for the rectangle background", 0);
    doc.add_bullet_list_item("banner_width / banner_height — size of the full banner", 0);
    doc.add_bullet_list_item("logo_width / logo_height — display size of the logo", 0);
    doc.add_bullet_list_item(
        "logo_x_offset / logo_y_offset — logo position within the banner",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Different First Page").style("Heading2");

    doc.add_paragraph(
        "This page uses a lighter blue banner (first page header). \
         Subsequent pages use a darker blue banner (default header). \
         Use set_different_first_page(true) to enable this.",
    );

    // ── Page 2 ──
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("Second Page").style("Heading1");

    doc.add_paragraph(
        "This page shows the default header banner (dark blue). The first page \
         had a lighter blue banner because we set a different first-page header.",
    );

    doc.add_paragraph("");

    doc.add_paragraph(
        "The banner repeats on every page because it is placed in the header part. \
         You can have different banners for default, first-page, and even-page headers.",
    );

    doc.set_title("Header Banner Example");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/generate_all_samples.rs (line 120)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

// =============================================================================
// 6. LETTER — Slate blue + silver scheme
// =============================================================================
fn generate_letter(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Slate #4A5568, Blue accent #3182CE
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
    );
    doc.set_title("Business Letter");
    doc.set_author("Walter White");

    // Banner header using raw XML
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "4A5568",
            banner_width: 7772400,
            banner_height: 731520, // ~0.8"
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 146304,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_margins(
        Length::twips(2000),
        Length::twips(1800),
        Length::twips(1440),
        Length::twips(1800),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Footer with contact
    doc.set_footer(
        "Tensorbee | 123 Innovation Drive, Suite 400 | San Francisco, CA 94105 | tensorbee.com",
    );

    // ── Sender Address ──
    doc.add_paragraph("Walter White");
    doc.add_paragraph("Chief Executive Officer");
    doc.add_paragraph("Tensorbee");
    doc.add_paragraph("123 Innovation Drive, Suite 400");
    doc.add_paragraph("San Francisco, CA 94105");
    doc.add_paragraph("");
    doc.add_paragraph("February 22, 2026");

    doc.add_paragraph("");

    // ── Recipient ──
    doc.add_paragraph("Ms. Sarah Chen");
    doc.add_paragraph("VP of Engineering");
    doc.add_paragraph("Meridian Dynamics LLC");
    doc.add_paragraph("456 Enterprise Boulevard");
    doc.add_paragraph("Austin, TX 78701");

    doc.add_paragraph("");

    // ── Subject ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Re: Strategic Technology Partnership — Phase 2 Expansion")
            .bold(true);
    }

    doc.add_paragraph("");

    // ── Body ──
    doc.add_paragraph("Dear Ms. Chen,");
    doc.add_paragraph("");

    doc.add_paragraph(
        "I am writing to express Tensorbee's enthusiasm for expanding our strategic technology \
         partnership with Meridian Dynamics. Following the successful completion of Phase 1, \
         which delivered a 40% improvement in your ML inference pipeline throughput, we believe \
         the foundation is firmly established for an ambitious Phase 2 engagement.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "During our recent executive review, your team highlighted three priority areas for \
         the next phase of collaboration:",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_numbered_list_item(
        "Real-time anomaly detection for your financial transaction monitoring system, \
         targeting sub-100ms latency at 50,000 transactions per second.",
        0,
    );
    doc.add_numbered_list_item(
        "Federated learning infrastructure to enable model training across your distributed \
         data centers without centralizing sensitive financial data.",
        0,
    );
    doc.add_numbered_list_item(
        "MLOps automation to reduce your model deployment cycle from the current 5 days \
         to under 4 hours.",
        0,
    );

    doc.add_paragraph(
        "Our engineering team has prepared a detailed technical proposal addressing each of \
         these areas. We have allocated a dedicated team of eight senior engineers, led by \
         our CTO, to ensure continuity with the Phase 1 team your organization has already \
         built a productive working relationship with.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "I would welcome the opportunity to present our Phase 2 proposal in person. My \
         assistant will reach out to coordinate a meeting at your convenience during the \
         first week of March.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("");

    doc.add_paragraph("Warm regards,");
    doc.add_paragraph("");
    doc.add_paragraph("");

    // Signature line
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "4A5568");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Walter White").bold(true).size(12.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Chief Executive Officer, Tensorbee")
            .italic(true)
            .size(10.0)
            .color("666666");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("walter@tensorbee.com | +1 (415) 555-0199")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 7. EMPLOYMENT CONTRACT — Purple + charcoal scheme
// =============================================================================
fn generate_contract(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Purple #5B2C6F, Plum #8E44AD, Gray #2C3E50
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Employment Agreement");
    doc.set_author("Tensorbee HR Department");
    doc.set_subject("Employment Contract — Walter White");
    doc.set_keywords("employment, contract, agreement, Tensorbee");

    doc.set_header("TENSORBEE — Employment Agreement");
    doc.set_footer("Employment Agreement — Walter White — Page");

    // ── Title Block ──
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("EMPLOYMENT AGREEMENT")
            .bold(true)
            .size(24.0)
            .color("5B2C6F")
            .font("Georgia");
    }
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    doc.add_paragraph("");

    // ── Parties ──
    doc.add_paragraph(
        "This Employment Agreement (\"Agreement\") is entered into as of February 22, 2026 \
         (\"Effective Date\"), by and between:",
    );

    doc.add_paragraph("");

    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYER: ").bold(true);
        p.add_run(
            "Tensorbee, Inc., a Delaware corporation with its principal place of business at \
                   123 Innovation Drive, Suite 400, San Francisco, CA 94105 (\"Company\")",
        );
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYEE: ").bold(true);
        p.add_run(
            "Walter White, residing at 308 Negra Arroyo Lane, Albuquerque, NM 87104 (\"Employee\")",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph("The Company and Employee are collectively referred to as the \"Parties.\"");
    doc.add_paragraph("");

    // ── Article 1: Position and Duties ──
    doc.add_paragraph("Article 1 — Position and Duties")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.1 ").bold(true);
        p.add_run("The Company hereby employs the Employee as ");
        p.add_run("Chief Executive Officer (CEO)")
            .bold(true)
            .italic(true);
        p.add_run(", reporting directly to the Board of Directors.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.2 ").bold(true);
        p.add_run("The Employee shall devote full working time, attention, and best efforts to \
                   the performance of duties as reasonably assigned by the Board, including but not limited to:");
    }
    doc.add_bullet_list_item(
        "Setting and executing the Company's strategic vision and business plan",
        0,
    );
    doc.add_bullet_list_item(
        "Overseeing all operations, engineering, and commercial activities",
        0,
    );
    doc.add_bullet_list_item(
        "Representing the Company to investors, customers, and the public",
        0,
    );
    doc.add_bullet_list_item("Recruiting, developing, and retaining key talent", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.3 ").bold(true);
        p.add_run(
            "The Employee's primary work location shall be the Company's San Francisco \
                   headquarters, with reasonable travel as required by business needs.",
        );
    }

    // ── Article 2: Compensation ──
    doc.add_paragraph("Article 2 — Compensation and Benefits")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.1 Base Salary. ").bold(true);
        p.add_run("The Company shall pay the Employee an annual base salary of ");
        p.add_run("$375,000.00").bold(true);
        p.add_run(" (Three Hundred Seventy-Five Thousand Dollars), payable in accordance with the \
                   Company's standard payroll schedule, less applicable withholdings and deductions.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.2 Annual Bonus. ").bold(true);
        p.add_run("The Employee shall be eligible for an annual performance bonus of up to ");
        p.add_run("40%").bold(true);
        p.add_run(
            " of base salary, based on achievement of mutually agreed performance objectives.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.3 Equity. ").bold(true);
        p.add_run("Subject to Board approval, the Employee shall receive a stock option grant of ");
        p.add_run("500,000 shares").bold(true);
        p.add_run(
            " of the Company's common stock, vesting over four (4) years with a one-year cliff, \
                   at an exercise price equal to the fair market value on the date of grant.",
        );
    }

    // Compensation summary table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "5B2C6F")
            .width_pct(70.0)
            .alignment(Alignment::Center);
        tbl.cell(0, 0).unwrap().set_text("Compensation Element");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");
        let items = [
            ("Base Salary", "$375,000/year"),
            ("Target Bonus", "Up to 40% ($150,000)"),
            ("Equity Grant", "500,000 shares (4yr vest)"),
            ("Total Target Comp", "$525,000 + equity"),
        ];
        for (i, (elem, val)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(elem);
            tbl.cell(i + 1, 1).unwrap().set_text(val);
            if i == 3 {
                tbl.cell(i + 1, 0).unwrap().shading("E8DAEF");
                tbl.cell(i + 1, 1).unwrap().shading("E8DAEF");
            }
        }
    }

    // ── Article 3: Benefits ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Article 3 — Benefits").style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.1 ").bold(true);
        p.add_run(
            "The Employee shall be entitled to participate in all benefit programs \
                   generally available to senior executives, including:",
        );
    }
    doc.add_bullet_list_item(
        "Medical, dental, and vision insurance (100% premium coverage for employee and dependents)",
        0,
    );
    doc.add_bullet_list_item("401(k) retirement plan with 6% company match", 0);
    doc.add_bullet_list_item("Life insurance and long-term disability coverage", 0);
    doc.add_bullet_list_item("Annual professional development allowance of $10,000", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.2 Paid Time Off. ").bold(true);
        p.add_run(
            "The Employee shall receive 25 days of paid vacation per year, plus Company holidays, \
                   accruing on a monthly basis.",
        );
    }

    // ── Article 4: Term and Termination ──
    doc.add_paragraph("Article 4 — Term and Termination")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.1 At-Will Employment. ").bold(true);
        p.add_run(
            "This Agreement is for at-will employment and may be terminated by either Party \
                   at any time, with or without cause, subject to the notice provisions herein.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.2 Notice Period. ").bold(true);
        p.add_run("Either Party shall provide ");
        p.add_run("ninety (90) days").bold(true);
        p.add_run(" written notice of termination, or pay in lieu thereof.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.3 Severance. ").bold(true);
        p.add_run("In the event of termination by the Company without Cause, the Employee shall \
                   receive (a) twelve (12) months of base salary continuation, (b) pro-rata bonus \
                   for the year of termination, and (c) twelve (12) months of COBRA premium coverage.");
    }

    // ── Article 5: Confidentiality ──
    doc.add_paragraph("Article 5 — Confidentiality and IP")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.1 ").bold(true);
        p.add_run(
            "The Employee agrees to maintain strict confidentiality of all proprietary \
                   information, trade secrets, and business plans of the Company during and after \
                   employment.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.2 ").bold(true);
        p.add_run(
            "All intellectual property, inventions, and works of authorship created by the \
                   Employee during the term of employment and within the scope of duties shall be \
                   the sole and exclusive property of the Company.",
        );
    }

    // ── Article 6: Non-Compete ──
    doc.add_paragraph("Article 6 — Non-Competition")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("6.1 ").bold(true);
        p.add_run("For a period of twelve (12) months following termination, the Employee agrees \
                   not to engage in any business that directly competes with the Company's core \
                   business of AI infrastructure and ML operations services, within the United States.");
    }

    // ── Article 7: General Provisions ──
    doc.add_paragraph("Article 7 — General Provisions")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.1 Governing Law. ").bold(true);
        p.add_run(
            "This Agreement shall be governed by and construed in accordance with the laws of \
                   the State of California.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.2 Entire Agreement. ").bold(true);
        p.add_run(
            "This Agreement constitutes the entire agreement between the Parties and supersedes \
                   all prior negotiations, representations, and agreements.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.3 Amendment. ").bold(true);
        p.add_run(
            "This Agreement may only be amended by a written instrument signed by both Parties.",
        );
    }

    // ── Signature Block ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("IN WITNESS WHEREOF, the Parties have executed this Employment Agreement as of the Effective Date.")
        .space_after(Length::pt(24.0));

    // Signature table
    {
        let mut tbl = doc.add_table(6, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("FOR THE COMPANY:");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("EMPLOYEE:");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");

        tbl.cell(1, 0).unwrap().set_text("");
        tbl.cell(1, 1).unwrap().set_text("");
        tbl.row(1).unwrap().height(Length::pt(40.0));

        tbl.cell(2, 0)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(3, 0)
            .unwrap()
            .set_text("Name: Board Representative");
        tbl.cell(3, 1).unwrap().set_text("Name: Walter White");
        tbl.cell(4, 0)
            .unwrap()
            .set_text("Title: Chair, Board of Directors");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Title: Chief Executive Officer");
        tbl.cell(5, 0).unwrap().set_text("Date: _______________");
        tbl.cell(5, 1).unwrap().set_text("Date: _______________");
    }

    doc
}

pub fn set_first_page_header(&mut self, text: &str)

Set the first-page header text.

Examples found in repository

examples/generate_all_samples.rs (line 117)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

pub fn set_first_page_footer(&mut self, text: &str)

Set the first-page footer text.

Examples found in repository

examples/generate_all_samples.rs (line 118)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

pub fn header_text(&self) -> Option<String>

Get the default header text, if set.

pub fn footer_text(&self) -> Option<String>

Get the default footer text, if set.

pub fn set_header_image( &mut self, image_data: &[u8], image_filename: &str, width: Length, height: Length, )

Set the default header to an inline image.

Creates a header part with an image paragraph. The image is embedded in the header part’s relationships.

Examples found in repository

examples/generate_all_samples.rs (lines 501-506)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

pub fn set_footer_image( &mut self, image_data: &[u8], image_filename: &str, width: Length, height: Length, )

Set the default footer to an inline image.

pub fn set_raw_header_with_images( &mut self, header_xml: Vec<u8>, images: &[(&str, &[u8], &str)], hdr_type: HdrFtrType, )

Set a header from raw XML bytes with associated images.

This is useful for copying complex headers from template documents that contain grouped shapes, VML, or other elements not easily recreated through the high-level API.

Each entry in images is (rel_id, image_data, image_filename):

• rel_id: the relationship ID referenced in the header XML (e.g. “rId1”)
• image_data: the raw image bytes
• image_filename: used to derive the part name and content type (e.g. “image5.png”)

Examples found in repository

examples/header_banner.rs (lines 59-63)

fn generate_header_banner_doc(path: &Path) {
    let mut doc = Document::new();

    // Page setup with extra top margin for the banner
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::twips(2292), // top — extra tall for header banner
        Length::twips(1440), // right
        Length::twips(1440), // bottom
        Length::twips(1440), // left
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Generate a simple logo image (white text on transparent background)
    let logo_img = create_logo_png(220, 48);

    // ── Dark blue banner ──
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1A3C6E",
            banner_width: 7772400, // full page width in EMU (~8.5")
            banner_height: 969026, // banner height in EMU (~1.06")
            logo_width: 2011680,   // logo display width (~2.2")
            logo_height: 438912,   // logo display height (~0.48")
            logo_x_offset: 295125, // left padding
            logo_y_offset: 265057, // vertical centering
        },
    );

    doc.set_raw_header_with_images(
        banner.clone(),
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );

    // Use a different first page header (same banner, different color)
    doc.set_different_first_page(true);
    let first_page_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "2E75B6", // lighter blue for cover
            banner_width: 7772400,
            banner_height: 969026,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 265057,
        },
    );
    doc.set_raw_header_with_images(
        first_page_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );

    // Footer
    doc.set_footer("Confidential — Internal Use Only");

    // ── Page 1: Cover ──
    doc.add_paragraph("Company Report").style("Heading1");

    doc.add_paragraph(
        "This document demonstrates a custom header banner built with DrawingML \
         group shapes. The banner uses a colored rectangle with a logo image overlaid, \
         positioned at the top of each page.",
    );

    doc.add_paragraph("");

    doc.add_paragraph("How the Header Banner Works")
        .style("Heading2");

    doc.add_paragraph(
        "The header banner is built using set_raw_header_with_images(), which \
         accepts raw XML and a list of (rel_id, image_data, filename) tuples. \
         The XML uses a DrawingML group shape (wpg:wgp) containing:",
    );

    doc.add_bullet_list_item(
        "A wps:wsp rectangle shape with a solid color fill (the background bar)",
        0,
    );
    doc.add_bullet_list_item(
        "A pic:pic image element positioned within the group (the logo)",
        0,
    );
    doc.add_bullet_list_item(
        "The group is wrapped in a wp:anchor element for absolute page positioning",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Customization").style("Heading2");

    doc.add_paragraph(
        "All dimensions are in EMU (English Metric Units) where 914400 EMU = 1 inch. \
         You can customize:",
    );

    doc.add_bullet_list_item("bg_color — any hex color for the rectangle background", 0);
    doc.add_bullet_list_item("banner_width / banner_height — size of the full banner", 0);
    doc.add_bullet_list_item("logo_width / logo_height — display size of the logo", 0);
    doc.add_bullet_list_item(
        "logo_x_offset / logo_y_offset — logo position within the banner",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Different First Page").style("Heading2");

    doc.add_paragraph(
        "This page uses a lighter blue banner (first page header). \
         Subsequent pages use a darker blue banner (default header). \
         Use set_different_first_page(true) to enable this.",
    );

    // ── Page 2 ──
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("Second Page").style("Heading1");

    doc.add_paragraph(
        "This page shows the default header banner (dark blue). The first page \
         had a lighter blue banner because we set a different first-page header.",
    );

    doc.add_paragraph("");

    doc.add_paragraph(
        "The banner repeats on every page because it is placed in the header part. \
         You can have different banners for default, first-page, and even-page headers.",
    );

    doc.set_title("Header Banner Example");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/generate_all_samples.rs (lines 727-731)

fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

// =============================================================================
// 6. LETTER — Slate blue + silver scheme
// =============================================================================
fn generate_letter(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Slate #4A5568, Blue accent #3182CE
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
    );
    doc.set_title("Business Letter");
    doc.set_author("Walter White");

    // Banner header using raw XML
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "4A5568",
            banner_width: 7772400,
            banner_height: 731520, // ~0.8"
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 146304,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_margins(
        Length::twips(2000),
        Length::twips(1800),
        Length::twips(1440),
        Length::twips(1800),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Footer with contact
    doc.set_footer(
        "Tensorbee | 123 Innovation Drive, Suite 400 | San Francisco, CA 94105 | tensorbee.com",
    );

    // ── Sender Address ──
    doc.add_paragraph("Walter White");
    doc.add_paragraph("Chief Executive Officer");
    doc.add_paragraph("Tensorbee");
    doc.add_paragraph("123 Innovation Drive, Suite 400");
    doc.add_paragraph("San Francisco, CA 94105");
    doc.add_paragraph("");
    doc.add_paragraph("February 22, 2026");

    doc.add_paragraph("");

    // ── Recipient ──
    doc.add_paragraph("Ms. Sarah Chen");
    doc.add_paragraph("VP of Engineering");
    doc.add_paragraph("Meridian Dynamics LLC");
    doc.add_paragraph("456 Enterprise Boulevard");
    doc.add_paragraph("Austin, TX 78701");

    doc.add_paragraph("");

    // ── Subject ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Re: Strategic Technology Partnership — Phase 2 Expansion")
            .bold(true);
    }

    doc.add_paragraph("");

    // ── Body ──
    doc.add_paragraph("Dear Ms. Chen,");
    doc.add_paragraph("");

    doc.add_paragraph(
        "I am writing to express Tensorbee's enthusiasm for expanding our strategic technology \
         partnership with Meridian Dynamics. Following the successful completion of Phase 1, \
         which delivered a 40% improvement in your ML inference pipeline throughput, we believe \
         the foundation is firmly established for an ambitious Phase 2 engagement.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "During our recent executive review, your team highlighted three priority areas for \
         the next phase of collaboration:",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_numbered_list_item(
        "Real-time anomaly detection for your financial transaction monitoring system, \
         targeting sub-100ms latency at 50,000 transactions per second.",
        0,
    );
    doc.add_numbered_list_item(
        "Federated learning infrastructure to enable model training across your distributed \
         data centers without centralizing sensitive financial data.",
        0,
    );
    doc.add_numbered_list_item(
        "MLOps automation to reduce your model deployment cycle from the current 5 days \
         to under 4 hours.",
        0,
    );

    doc.add_paragraph(
        "Our engineering team has prepared a detailed technical proposal addressing each of \
         these areas. We have allocated a dedicated team of eight senior engineers, led by \
         our CTO, to ensure continuity with the Phase 1 team your organization has already \
         built a productive working relationship with.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "I would welcome the opportunity to present our Phase 2 proposal in person. My \
         assistant will reach out to coordinate a meeting at your convenience during the \
         first week of March.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("");

    doc.add_paragraph("Warm regards,");
    doc.add_paragraph("");
    doc.add_paragraph("");

    // Signature line
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "4A5568");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Walter White").bold(true).size(12.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Chief Executive Officer, Tensorbee")
            .italic(true)
            .size(10.0)
            .color("666666");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("walter@tensorbee.com | +1 (415) 555-0199")
            .size(10.0)
            .color("888888");
    }

    doc
}

pub fn set_raw_footer_with_images( &mut self, footer_xml: Vec<u8>, images: &[(&str, &[u8], &str)], hdr_type: HdrFtrType, )

Set a footer from raw XML bytes with associated images.

pub fn set_header_image_with_background( &mut self, image_data: &[u8], image_filename: &str, width: Length, height: Length, bg_color: &str, )

Set the default header to an inline image with a colored background.

Creates a header part where the paragraph has shading fill set to bg_color (hex string, e.g. “000000” for black) and contains the inline image.

pub fn set_first_page_header_image( &mut self, image_data: &[u8], image_filename: &str, width: Length, height: Length, )

Set the first-page header to an inline image.

pub fn add_bullet_list_item(&mut self, text: &str, level: u32) -> Paragraph<'_>

Add a bullet list item at the given indentation level (0-based).

If no bullet list definition exists yet, one is created automatically. Returns a mutable Paragraph for further configuration.

Examples found in repository

examples/header_banner.rs (lines 108-111)

fn generate_header_banner_doc(path: &Path) {
    let mut doc = Document::new();

    // Page setup with extra top margin for the banner
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::twips(2292), // top — extra tall for header banner
        Length::twips(1440), // right
        Length::twips(1440), // bottom
        Length::twips(1440), // left
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Generate a simple logo image (white text on transparent background)
    let logo_img = create_logo_png(220, 48);

    // ── Dark blue banner ──
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1A3C6E",
            banner_width: 7772400, // full page width in EMU (~8.5")
            banner_height: 969026, // banner height in EMU (~1.06")
            logo_width: 2011680,   // logo display width (~2.2")
            logo_height: 438912,   // logo display height (~0.48")
            logo_x_offset: 295125, // left padding
            logo_y_offset: 265057, // vertical centering
        },
    );

    doc.set_raw_header_with_images(
        banner.clone(),
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );

    // Use a different first page header (same banner, different color)
    doc.set_different_first_page(true);
    let first_page_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "2E75B6", // lighter blue for cover
            banner_width: 7772400,
            banner_height: 969026,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 265057,
        },
    );
    doc.set_raw_header_with_images(
        first_page_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );

    // Footer
    doc.set_footer("Confidential — Internal Use Only");

    // ── Page 1: Cover ──
    doc.add_paragraph("Company Report").style("Heading1");

    doc.add_paragraph(
        "This document demonstrates a custom header banner built with DrawingML \
         group shapes. The banner uses a colored rectangle with a logo image overlaid, \
         positioned at the top of each page.",
    );

    doc.add_paragraph("");

    doc.add_paragraph("How the Header Banner Works")
        .style("Heading2");

    doc.add_paragraph(
        "The header banner is built using set_raw_header_with_images(), which \
         accepts raw XML and a list of (rel_id, image_data, filename) tuples. \
         The XML uses a DrawingML group shape (wpg:wgp) containing:",
    );

    doc.add_bullet_list_item(
        "A wps:wsp rectangle shape with a solid color fill (the background bar)",
        0,
    );
    doc.add_bullet_list_item(
        "A pic:pic image element positioned within the group (the logo)",
        0,
    );
    doc.add_bullet_list_item(
        "The group is wrapped in a wp:anchor element for absolute page positioning",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Customization").style("Heading2");

    doc.add_paragraph(
        "All dimensions are in EMU (English Metric Units) where 914400 EMU = 1 inch. \
         You can customize:",
    );

    doc.add_bullet_list_item("bg_color — any hex color for the rectangle background", 0);
    doc.add_bullet_list_item("banner_width / banner_height — size of the full banner", 0);
    doc.add_bullet_list_item("logo_width / logo_height — display size of the logo", 0);
    doc.add_bullet_list_item(
        "logo_x_offset / logo_y_offset — logo position within the banner",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Different First Page").style("Heading2");

    doc.add_paragraph(
        "This page uses a lighter blue banner (first page header). \
         Subsequent pages use a darker blue banner (default header). \
         Use set_different_first_page(true) to enable this.",
    );

    // ── Page 2 ──
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("Second Page").style("Heading1");

    doc.add_paragraph(
        "This page shows the default header banner (dark blue). The first page \
         had a lighter blue banner because we set a different first-page header.",
    );

    doc.add_paragraph("");

    doc.add_paragraph(
        "The banner repeats on every page because it is placed in the header part. \
         You can have different banners for default, first-page, and even-page headers.",
    );

    doc.set_title("Header Banner Example");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/generate_all_samples.rs (line 313)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

// =============================================================================
// 6. LETTER — Slate blue + silver scheme
// =============================================================================
fn generate_letter(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Slate #4A5568, Blue accent #3182CE
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
    );
    doc.set_title("Business Letter");
    doc.set_author("Walter White");

    // Banner header using raw XML
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "4A5568",
            banner_width: 7772400,
            banner_height: 731520, // ~0.8"
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 146304,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_margins(
        Length::twips(2000),
        Length::twips(1800),
        Length::twips(1440),
        Length::twips(1800),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Footer with contact
    doc.set_footer(
        "Tensorbee | 123 Innovation Drive, Suite 400 | San Francisco, CA 94105 | tensorbee.com",
    );

    // ── Sender Address ──
    doc.add_paragraph("Walter White");
    doc.add_paragraph("Chief Executive Officer");
    doc.add_paragraph("Tensorbee");
    doc.add_paragraph("123 Innovation Drive, Suite 400");
    doc.add_paragraph("San Francisco, CA 94105");
    doc.add_paragraph("");
    doc.add_paragraph("February 22, 2026");

    doc.add_paragraph("");

    // ── Recipient ──
    doc.add_paragraph("Ms. Sarah Chen");
    doc.add_paragraph("VP of Engineering");
    doc.add_paragraph("Meridian Dynamics LLC");
    doc.add_paragraph("456 Enterprise Boulevard");
    doc.add_paragraph("Austin, TX 78701");

    doc.add_paragraph("");

    // ── Subject ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Re: Strategic Technology Partnership — Phase 2 Expansion")
            .bold(true);
    }

    doc.add_paragraph("");

    // ── Body ──
    doc.add_paragraph("Dear Ms. Chen,");
    doc.add_paragraph("");

    doc.add_paragraph(
        "I am writing to express Tensorbee's enthusiasm for expanding our strategic technology \
         partnership with Meridian Dynamics. Following the successful completion of Phase 1, \
         which delivered a 40% improvement in your ML inference pipeline throughput, we believe \
         the foundation is firmly established for an ambitious Phase 2 engagement.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "During our recent executive review, your team highlighted three priority areas for \
         the next phase of collaboration:",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_numbered_list_item(
        "Real-time anomaly detection for your financial transaction monitoring system, \
         targeting sub-100ms latency at 50,000 transactions per second.",
        0,
    );
    doc.add_numbered_list_item(
        "Federated learning infrastructure to enable model training across your distributed \
         data centers without centralizing sensitive financial data.",
        0,
    );
    doc.add_numbered_list_item(
        "MLOps automation to reduce your model deployment cycle from the current 5 days \
         to under 4 hours.",
        0,
    );

    doc.add_paragraph(
        "Our engineering team has prepared a detailed technical proposal addressing each of \
         these areas. We have allocated a dedicated team of eight senior engineers, led by \
         our CTO, to ensure continuity with the Phase 1 team your organization has already \
         built a productive working relationship with.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "I would welcome the opportunity to present our Phase 2 proposal in person. My \
         assistant will reach out to coordinate a meeting at your convenience during the \
         first week of March.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("");

    doc.add_paragraph("Warm regards,");
    doc.add_paragraph("");
    doc.add_paragraph("");

    // Signature line
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "4A5568");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Walter White").bold(true).size(12.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Chief Executive Officer, Tensorbee")
            .italic(true)
            .size(10.0)
            .color("666666");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("walter@tensorbee.com | +1 (415) 555-0199")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 7. EMPLOYMENT CONTRACT — Purple + charcoal scheme
// =============================================================================
fn generate_contract(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Purple #5B2C6F, Plum #8E44AD, Gray #2C3E50
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Employment Agreement");
    doc.set_author("Tensorbee HR Department");
    doc.set_subject("Employment Contract — Walter White");
    doc.set_keywords("employment, contract, agreement, Tensorbee");

    doc.set_header("TENSORBEE — Employment Agreement");
    doc.set_footer("Employment Agreement — Walter White — Page");

    // ── Title Block ──
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("EMPLOYMENT AGREEMENT")
            .bold(true)
            .size(24.0)
            .color("5B2C6F")
            .font("Georgia");
    }
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    doc.add_paragraph("");

    // ── Parties ──
    doc.add_paragraph(
        "This Employment Agreement (\"Agreement\") is entered into as of February 22, 2026 \
         (\"Effective Date\"), by and between:",
    );

    doc.add_paragraph("");

    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYER: ").bold(true);
        p.add_run(
            "Tensorbee, Inc., a Delaware corporation with its principal place of business at \
                   123 Innovation Drive, Suite 400, San Francisco, CA 94105 (\"Company\")",
        );
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYEE: ").bold(true);
        p.add_run(
            "Walter White, residing at 308 Negra Arroyo Lane, Albuquerque, NM 87104 (\"Employee\")",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph("The Company and Employee are collectively referred to as the \"Parties.\"");
    doc.add_paragraph("");

    // ── Article 1: Position and Duties ──
    doc.add_paragraph("Article 1 — Position and Duties")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.1 ").bold(true);
        p.add_run("The Company hereby employs the Employee as ");
        p.add_run("Chief Executive Officer (CEO)")
            .bold(true)
            .italic(true);
        p.add_run(", reporting directly to the Board of Directors.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.2 ").bold(true);
        p.add_run("The Employee shall devote full working time, attention, and best efforts to \
                   the performance of duties as reasonably assigned by the Board, including but not limited to:");
    }
    doc.add_bullet_list_item(
        "Setting and executing the Company's strategic vision and business plan",
        0,
    );
    doc.add_bullet_list_item(
        "Overseeing all operations, engineering, and commercial activities",
        0,
    );
    doc.add_bullet_list_item(
        "Representing the Company to investors, customers, and the public",
        0,
    );
    doc.add_bullet_list_item("Recruiting, developing, and retaining key talent", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.3 ").bold(true);
        p.add_run(
            "The Employee's primary work location shall be the Company's San Francisco \
                   headquarters, with reasonable travel as required by business needs.",
        );
    }

    // ── Article 2: Compensation ──
    doc.add_paragraph("Article 2 — Compensation and Benefits")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.1 Base Salary. ").bold(true);
        p.add_run("The Company shall pay the Employee an annual base salary of ");
        p.add_run("$375,000.00").bold(true);
        p.add_run(" (Three Hundred Seventy-Five Thousand Dollars), payable in accordance with the \
                   Company's standard payroll schedule, less applicable withholdings and deductions.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.2 Annual Bonus. ").bold(true);
        p.add_run("The Employee shall be eligible for an annual performance bonus of up to ");
        p.add_run("40%").bold(true);
        p.add_run(
            " of base salary, based on achievement of mutually agreed performance objectives.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.3 Equity. ").bold(true);
        p.add_run("Subject to Board approval, the Employee shall receive a stock option grant of ");
        p.add_run("500,000 shares").bold(true);
        p.add_run(
            " of the Company's common stock, vesting over four (4) years with a one-year cliff, \
                   at an exercise price equal to the fair market value on the date of grant.",
        );
    }

    // Compensation summary table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "5B2C6F")
            .width_pct(70.0)
            .alignment(Alignment::Center);
        tbl.cell(0, 0).unwrap().set_text("Compensation Element");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");
        let items = [
            ("Base Salary", "$375,000/year"),
            ("Target Bonus", "Up to 40% ($150,000)"),
            ("Equity Grant", "500,000 shares (4yr vest)"),
            ("Total Target Comp", "$525,000 + equity"),
        ];
        for (i, (elem, val)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(elem);
            tbl.cell(i + 1, 1).unwrap().set_text(val);
            if i == 3 {
                tbl.cell(i + 1, 0).unwrap().shading("E8DAEF");
                tbl.cell(i + 1, 1).unwrap().shading("E8DAEF");
            }
        }
    }

    // ── Article 3: Benefits ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Article 3 — Benefits").style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.1 ").bold(true);
        p.add_run(
            "The Employee shall be entitled to participate in all benefit programs \
                   generally available to senior executives, including:",
        );
    }
    doc.add_bullet_list_item(
        "Medical, dental, and vision insurance (100% premium coverage for employee and dependents)",
        0,
    );
    doc.add_bullet_list_item("401(k) retirement plan with 6% company match", 0);
    doc.add_bullet_list_item("Life insurance and long-term disability coverage", 0);
    doc.add_bullet_list_item("Annual professional development allowance of $10,000", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.2 Paid Time Off. ").bold(true);
        p.add_run(
            "The Employee shall receive 25 days of paid vacation per year, plus Company holidays, \
                   accruing on a monthly basis.",
        );
    }

    // ── Article 4: Term and Termination ──
    doc.add_paragraph("Article 4 — Term and Termination")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.1 At-Will Employment. ").bold(true);
        p.add_run(
            "This Agreement is for at-will employment and may be terminated by either Party \
                   at any time, with or without cause, subject to the notice provisions herein.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.2 Notice Period. ").bold(true);
        p.add_run("Either Party shall provide ");
        p.add_run("ninety (90) days").bold(true);
        p.add_run(" written notice of termination, or pay in lieu thereof.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.3 Severance. ").bold(true);
        p.add_run("In the event of termination by the Company without Cause, the Employee shall \
                   receive (a) twelve (12) months of base salary continuation, (b) pro-rata bonus \
                   for the year of termination, and (c) twelve (12) months of COBRA premium coverage.");
    }

    // ── Article 5: Confidentiality ──
    doc.add_paragraph("Article 5 — Confidentiality and IP")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.1 ").bold(true);
        p.add_run(
            "The Employee agrees to maintain strict confidentiality of all proprietary \
                   information, trade secrets, and business plans of the Company during and after \
                   employment.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.2 ").bold(true);
        p.add_run(
            "All intellectual property, inventions, and works of authorship created by the \
                   Employee during the term of employment and within the scope of duties shall be \
                   the sole and exclusive property of the Company.",
        );
    }

    // ── Article 6: Non-Compete ──
    doc.add_paragraph("Article 6 — Non-Competition")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("6.1 ").bold(true);
        p.add_run("For a period of twelve (12) months following termination, the Employee agrees \
                   not to engage in any business that directly competes with the Company's core \
                   business of AI infrastructure and ML operations services, within the United States.");
    }

    // ── Article 7: General Provisions ──
    doc.add_paragraph("Article 7 — General Provisions")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.1 Governing Law. ").bold(true);
        p.add_run(
            "This Agreement shall be governed by and construed in accordance with the laws of \
                   the State of California.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.2 Entire Agreement. ").bold(true);
        p.add_run(
            "This Agreement constitutes the entire agreement between the Parties and supersedes \
                   all prior negotiations, representations, and agreements.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.3 Amendment. ").bold(true);
        p.add_run(
            "This Agreement may only be amended by a written instrument signed by both Parties.",
        );
    }

    // ── Signature Block ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("IN WITNESS WHEREOF, the Parties have executed this Employment Agreement as of the Effective Date.")
        .space_after(Length::pt(24.0));

    // Signature table
    {
        let mut tbl = doc.add_table(6, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("FOR THE COMPANY:");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("EMPLOYEE:");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");

        tbl.cell(1, 0).unwrap().set_text("");
        tbl.cell(1, 1).unwrap().set_text("");
        tbl.row(1).unwrap().height(Length::pt(40.0));

        tbl.cell(2, 0)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(3, 0)
            .unwrap()
            .set_text("Name: Board Representative");
        tbl.cell(3, 1).unwrap().set_text("Name: Walter White");
        tbl.cell(4, 0)
            .unwrap()
            .set_text("Title: Chair, Board of Directors");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Title: Chief Executive Officer");
        tbl.cell(5, 0).unwrap().set_text("Date: _______________");
        tbl.cell(5, 1).unwrap().set_text("Date: _______________");
    }

    doc
}

pub fn add_numbered_list_item( &mut self, text: &str, level: u32, ) -> Paragraph<'_>

Add a numbered list item at the given indentation level (0-based).

If no numbered list definition exists yet, one is created automatically. Returns a mutable Paragraph for further configuration.

Examples found in repository

examples/generate_all_samples.rs (line 323)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

// =============================================================================
// 6. LETTER — Slate blue + silver scheme
// =============================================================================
fn generate_letter(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Slate #4A5568, Blue accent #3182CE
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
    );
    doc.set_title("Business Letter");
    doc.set_author("Walter White");

    // Banner header using raw XML
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "4A5568",
            banner_width: 7772400,
            banner_height: 731520, // ~0.8"
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 146304,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_margins(
        Length::twips(2000),
        Length::twips(1800),
        Length::twips(1440),
        Length::twips(1800),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Footer with contact
    doc.set_footer(
        "Tensorbee | 123 Innovation Drive, Suite 400 | San Francisco, CA 94105 | tensorbee.com",
    );

    // ── Sender Address ──
    doc.add_paragraph("Walter White");
    doc.add_paragraph("Chief Executive Officer");
    doc.add_paragraph("Tensorbee");
    doc.add_paragraph("123 Innovation Drive, Suite 400");
    doc.add_paragraph("San Francisco, CA 94105");
    doc.add_paragraph("");
    doc.add_paragraph("February 22, 2026");

    doc.add_paragraph("");

    // ── Recipient ──
    doc.add_paragraph("Ms. Sarah Chen");
    doc.add_paragraph("VP of Engineering");
    doc.add_paragraph("Meridian Dynamics LLC");
    doc.add_paragraph("456 Enterprise Boulevard");
    doc.add_paragraph("Austin, TX 78701");

    doc.add_paragraph("");

    // ── Subject ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Re: Strategic Technology Partnership — Phase 2 Expansion")
            .bold(true);
    }

    doc.add_paragraph("");

    // ── Body ──
    doc.add_paragraph("Dear Ms. Chen,");
    doc.add_paragraph("");

    doc.add_paragraph(
        "I am writing to express Tensorbee's enthusiasm for expanding our strategic technology \
         partnership with Meridian Dynamics. Following the successful completion of Phase 1, \
         which delivered a 40% improvement in your ML inference pipeline throughput, we believe \
         the foundation is firmly established for an ambitious Phase 2 engagement.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "During our recent executive review, your team highlighted three priority areas for \
         the next phase of collaboration:",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_numbered_list_item(
        "Real-time anomaly detection for your financial transaction monitoring system, \
         targeting sub-100ms latency at 50,000 transactions per second.",
        0,
    );
    doc.add_numbered_list_item(
        "Federated learning infrastructure to enable model training across your distributed \
         data centers without centralizing sensitive financial data.",
        0,
    );
    doc.add_numbered_list_item(
        "MLOps automation to reduce your model deployment cycle from the current 5 days \
         to under 4 hours.",
        0,
    );

    doc.add_paragraph(
        "Our engineering team has prepared a detailed technical proposal addressing each of \
         these areas. We have allocated a dedicated team of eight senior engineers, led by \
         our CTO, to ensure continuity with the Phase 1 team your organization has already \
         built a productive working relationship with.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "I would welcome the opportunity to present our Phase 2 proposal in person. My \
         assistant will reach out to coordinate a meeting at your convenience during the \
         first week of March.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("");

    doc.add_paragraph("Warm regards,");
    doc.add_paragraph("");
    doc.add_paragraph("");

    // Signature line
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "4A5568");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Walter White").bold(true).size(12.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Chief Executive Officer, Tensorbee")
            .italic(true)
            .size(10.0)
            .color("666666");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("walter@tensorbee.com | +1 (415) 555-0199")
            .size(10.0)
            .color("888888");
    }

    doc
}

pub fn add_list_definition(&mut self, levels: &[ListLevel]) -> u32

Create a list definition with explicit per-level formats and return its numId.

Unlike Self::add_bullet_list_item / Self::add_numbered_list_item, which share one bullet and one numbered definition per document, every call creates a fresh definition — so separate lists restart their numbering, and one definition can mix formats across levels (e.g. a bullet list whose nested level is decimal). Attach paragraphs with crate::Paragraph::set_numbering.

levels[i] configures level i; deeper unspecified levels fall back to the standard template rotation for the last specified format’s family. An empty slice produces the standard numbered template. Word supports nine levels, so entries after index eight are ignored.

use rdocx::{Document, ListLevel};

let mut doc = Document::new();
let num_id = doc.add_list_definition(&[
    ListLevel::bullet(),
    ListLevel::decimal().start(3),
]);
doc.add_paragraph("first bullet").set_numbering(num_id, 0);
doc.add_paragraph("third decimal").set_numbering(num_id, 1);

pub fn set_list_level( &mut self, num_id: u32, level: u32, spec: ListLevel, ) -> bool

Redefine one level (0–8) of an existing list definition, for callers that only learn a deeper level’s format when content first reaches it.

Returns false when num_id is unknown or level is out of range.

pub fn styles(&self) -> Vec<Style<'_>>

Get all styles.

pub fn style(&self, style_id: &str) -> Option<Style<'_>>

Find a style by its ID.

pub fn add_style(&mut self, builder: StyleBuilder)

Add a custom style to the document.

Examples found in repository

examples/generate_all_samples.rs (lines 598-614)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

pub fn resolve_paragraph_properties(&self, style_id: Option<&str>) -> CT_PPr

Resolve the effective paragraph properties for a given style ID, walking the full inheritance chain (docDefaults → basedOn → …).

pub fn resolve_run_properties( &self, para_style_id: Option<&str>, run_style_id: Option<&str>, ) -> CT_RPr

Resolve the effective run properties for the given paragraph and character styles, walking the full inheritance chain.

pub fn section_properties(&self) -> Option<&CT_SectPr>

Get the section properties (page size, margins).

pub fn section_properties_mut(&mut self) -> &mut CT_SectPr

Get a mutable reference to section properties, creating defaults if needed.

pub fn set_page_size(&mut self, width: Length, height: Length)

Set page size.

Examples found in repository

examples/template_replace.rs (line 45)

fn create_template(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );

    doc.set_header("{{company_name}} — Confidential");
    doc.set_footer("Prepared by {{author_name}} on {{date}}");

    // ── Title ──
    doc.add_paragraph("{{company_name}}")
        .style("Heading1")
        .alignment(Alignment::Center);

    doc.add_paragraph("Project Proposal")
        .alignment(Alignment::Center);

    doc.add_paragraph("");

    // ── Summary section ──
    doc.add_paragraph("Executive Summary").style("Heading2");

    doc.add_paragraph(
        "This proposal outlines the {{project_name}} project for {{company_name}}. \
         The primary contact is {{contact_name}} ({{contact_email}}). \
         The proposed start date is {{start_date}} with an estimated duration of {{duration}}.",
    );

    doc.add_paragraph("");

    // ── Cross-run placeholder (bold label + normal value) ──
    doc.add_paragraph("Key Details").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Project: ").bold(true);
        p.add_run("{{project_name}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Budget: ").bold(true);
        p.add_run("{{budget}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Status: ").bold(true);
        p.add_run("{{status}}");
    }

    doc.add_paragraph("");

    // ── Table with placeholders ──
    doc.add_paragraph("Team Members").style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        // Header row
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Email");

        tbl.cell(1, 0).unwrap().set_text("{{member1_name}}");
        tbl.cell(1, 1).unwrap().set_text("{{member1_role}}");
        tbl.cell(1, 2).unwrap().set_text("{{member1_email}}");

        tbl.cell(2, 0).unwrap().set_text("{{member2_name}}");
        tbl.cell(2, 1).unwrap().set_text("{{member2_role}}");
        tbl.cell(2, 2).unwrap().set_text("{{member2_email}}");

        tbl.cell(3, 0).unwrap().set_text("{{member3_name}}");
        tbl.cell(3, 1).unwrap().set_text("{{member3_role}}");
        tbl.cell(3, 2).unwrap().set_text("{{member3_email}}");
    }

    doc.add_paragraph("");

    // ── Deliverables section ──
    doc.add_paragraph("Deliverables").style("Heading2");

    doc.add_paragraph("INSERTION_POINT");

    doc.add_paragraph("");

    // ── Signature block ──
    doc.add_paragraph("Acceptance").style("Heading2");

    doc.add_paragraph(
        "By signing below, {{company_name}} agrees to the terms outlined in this proposal.",
    );

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer: ___________________");
        tbl.cell(0, 1)
            .unwrap()
            .set_text("Provider: ___________________");
        tbl.cell(1, 0).unwrap().set_text("Date: {{date}}");
        tbl.cell(1, 1).unwrap().set_text("Date: {{date}}");
    }

    doc.set_title("{{company_name}} — Project Proposal Template");
    doc.set_author("Template Generator");

    doc.save(path).unwrap();
}

examples/header_banner.rs (line 33)

fn generate_header_banner_doc(path: &Path) {
    let mut doc = Document::new();

    // Page setup with extra top margin for the banner
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::twips(2292), // top — extra tall for header banner
        Length::twips(1440), // right
        Length::twips(1440), // bottom
        Length::twips(1440), // left
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Generate a simple logo image (white text on transparent background)
    let logo_img = create_logo_png(220, 48);

    // ── Dark blue banner ──
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1A3C6E",
            banner_width: 7772400, // full page width in EMU (~8.5")
            banner_height: 969026, // banner height in EMU (~1.06")
            logo_width: 2011680,   // logo display width (~2.2")
            logo_height: 438912,   // logo display height (~0.48")
            logo_x_offset: 295125, // left padding
            logo_y_offset: 265057, // vertical centering
        },
    );

    doc.set_raw_header_with_images(
        banner.clone(),
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );

    // Use a different first page header (same banner, different color)
    doc.set_different_first_page(true);
    let first_page_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "2E75B6", // lighter blue for cover
            banner_width: 7772400,
            banner_height: 969026,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 265057,
        },
    );
    doc.set_raw_header_with_images(
        first_page_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );

    // Footer
    doc.set_footer("Confidential — Internal Use Only");

    // ── Page 1: Cover ──
    doc.add_paragraph("Company Report").style("Heading1");

    doc.add_paragraph(
        "This document demonstrates a custom header banner built with DrawingML \
         group shapes. The banner uses a colored rectangle with a logo image overlaid, \
         positioned at the top of each page.",
    );

    doc.add_paragraph("");

    doc.add_paragraph("How the Header Banner Works")
        .style("Heading2");

    doc.add_paragraph(
        "The header banner is built using set_raw_header_with_images(), which \
         accepts raw XML and a list of (rel_id, image_data, filename) tuples. \
         The XML uses a DrawingML group shape (wpg:wgp) containing:",
    );

    doc.add_bullet_list_item(
        "A wps:wsp rectangle shape with a solid color fill (the background bar)",
        0,
    );
    doc.add_bullet_list_item(
        "A pic:pic image element positioned within the group (the logo)",
        0,
    );
    doc.add_bullet_list_item(
        "The group is wrapped in a wp:anchor element for absolute page positioning",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Customization").style("Heading2");

    doc.add_paragraph(
        "All dimensions are in EMU (English Metric Units) where 914400 EMU = 1 inch. \
         You can customize:",
    );

    doc.add_bullet_list_item("bg_color — any hex color for the rectangle background", 0);
    doc.add_bullet_list_item("banner_width / banner_height — size of the full banner", 0);
    doc.add_bullet_list_item("logo_width / logo_height — display size of the logo", 0);
    doc.add_bullet_list_item(
        "logo_x_offset / logo_y_offset — logo position within the banner",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Different First Page").style("Heading2");

    doc.add_paragraph(
        "This page uses a lighter blue banner (first page header). \
         Subsequent pages use a darker blue banner (default header). \
         Use set_different_first_page(true) to enable this.",
    );

    // ── Page 2 ──
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("Second Page").style("Heading1");

    doc.add_paragraph(
        "This page shows the default header banner (dark blue). The first page \
         had a lighter blue banner because we set a different first-page header.",
    );

    doc.add_paragraph("");

    doc.add_paragraph(
        "The banner repeats on every page because it is placed in the header part. \
         You can have different banners for default, first-page, and even-page headers.",
    );

    doc.set_title("Header Banner Example");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/styled_tables.rs (line 26)

fn generate_styled_tables(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );

    doc.add_paragraph("Styled Tables Showcase")
        .style("Heading1");

    doc.add_paragraph("");

    // =========================================================================
    // 1. Professional report table with alternating rows
    // =========================================================================
    doc.add_paragraph("1. Report Table with Alternating Row Colors")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 4);
        tbl = tbl.borders(BorderStyle::Single, 2, "BFBFBF");
        tbl = tbl.width_pct(100.0);

        // Header row
        let headers = ["Product", "Q1 Sales", "Q2 Sales", "Growth"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().shading("2E75B6");
            tbl.cell(0, col).unwrap().set_text(h);
        }
        tbl.row(0).unwrap().header();

        // Data with alternating shading
        let data = [
            ["Enterprise Suite", "$245,000", "$312,000", "+27.3%"],
            ["Professional", "$189,000", "$201,000", "+6.3%"],
            ["Starter Pack", "$67,000", "$84,500", "+26.1%"],
            ["Add-ons", "$34,000", "$41,200", "+21.2%"],
            ["Training", "$22,000", "$28,900", "+31.4%"],
            ["Support Plans", "$56,000", "$62,300", "+11.3%"],
        ];

        for (i, row) in data.iter().enumerate() {
            let row_idx = i + 1;
            for (col, val) in row.iter().enumerate() {
                tbl.cell(row_idx, col).unwrap().set_text(val);
                // Alternate row colors
                if i % 2 == 0 {
                    tbl.cell(row_idx, col).unwrap().shading("F2F7FB");
                }
            }
        }

        // Total row
        tbl.cell(7, 0).unwrap().set_text("TOTAL");
        tbl.cell(7, 0).unwrap().shading("D6E4F0");
        tbl.cell(7, 1).unwrap().set_text("$613,000");
        tbl.cell(7, 1).unwrap().shading("D6E4F0");
        tbl.cell(7, 2).unwrap().set_text("$729,900");
        tbl.cell(7, 2).unwrap().shading("D6E4F0");
        tbl.cell(7, 3).unwrap().set_text("+19.1%");
        tbl.cell(7, 3).unwrap().shading("D6E4F0");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 2. Invoice-style table with merged header
    // =========================================================================
    doc.add_paragraph("2. Invoice Table with Merged Header & Row Spans")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(7, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Merged title row
        tbl.cell(0, 0).unwrap().set_text("INVOICE #2026-0042");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("1F4E79");

        // Column headers
        let headers = ["Item", "Description", "Qty", "Amount"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(1, col).unwrap().set_text(h);
            tbl.cell(1, col).unwrap().shading("D6E4F0");
        }

        // Line items
        tbl.cell(2, 0).unwrap().set_text("LIC-ENT-500");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Enterprise License (500 seats)");
        tbl.cell(2, 2).unwrap().set_text("1");
        tbl.cell(2, 3).unwrap().set_text("$60,000");

        tbl.cell(3, 0).unwrap().set_text("SVC-IMPL");
        tbl.cell(3, 1).unwrap().set_text("Implementation Services");
        tbl.cell(3, 2).unwrap().set_text("1");
        tbl.cell(3, 3).unwrap().set_text("$25,000");

        tbl.cell(4, 0).unwrap().set_text("SVC-TRAIN");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("On-site Training (3 days)");
        tbl.cell(4, 2).unwrap().set_text("1");
        tbl.cell(4, 3).unwrap().set_text("$4,500");

        // Subtotal
        tbl.cell(5, 0).unwrap().set_text("Subtotal");
        tbl.cell(5, 0).unwrap().grid_span(3);
        tbl.cell(5, 0).unwrap().shading("F2F2F2");
        tbl.cell(5, 3).unwrap().set_text("$89,500");
        tbl.cell(5, 3).unwrap().shading("F2F2F2");

        // Total
        tbl.cell(6, 0).unwrap().set_text("TOTAL DUE");
        tbl.cell(6, 0).unwrap().grid_span(3);
        tbl.cell(6, 0).unwrap().shading("1F4E79");
        tbl.cell(6, 3).unwrap().set_text("$89,500");
        tbl.cell(6, 3).unwrap().shading("1F4E79");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 3. Specification table with vertical merge
    // =========================================================================
    doc.add_paragraph("3. Specification Table with Vertical Merges")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Specification");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Value");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        // "Hardware" spans 3 rows
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 0).unwrap().shading("E2EFDA");
        tbl.cell(1, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(1, 1).unwrap().set_text("Processor");
        tbl.cell(1, 2).unwrap().set_text("Intel Xeon E-2388G");

        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Memory");
        tbl.cell(2, 2).unwrap().set_text("64 GB DDR4 ECC");

        tbl.cell(3, 0).unwrap().v_merge_continue();
        tbl.cell(3, 1).unwrap().set_text("Storage");
        tbl.cell(3, 2).unwrap().set_text("2x 1TB NVMe SSD (RAID 1)");

        // "Network" spans 2 rows
        tbl.cell(4, 0).unwrap().set_text("Network");
        tbl.cell(4, 0).unwrap().v_merge_restart();
        tbl.cell(4, 0).unwrap().shading("FCE4D6");
        tbl.cell(4, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(4, 1).unwrap().set_text("Ethernet");
        tbl.cell(4, 2).unwrap().set_text("4x 10GbE SFP+");

        tbl.cell(5, 0).unwrap().v_merge_continue();
        tbl.cell(5, 1).unwrap().set_text("Management");
        tbl.cell(5, 2).unwrap().set_text("1x 1GbE IPMI");

        // "Software" spans 2 rows
        tbl.cell(6, 0).unwrap().set_text("Software");
        tbl.cell(6, 0).unwrap().v_merge_restart();
        tbl.cell(6, 0).unwrap().shading("D6E4F0");
        tbl.cell(6, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(6, 1).unwrap().set_text("Operating System");
        tbl.cell(6, 2).unwrap().set_text("Ubuntu 24.04 LTS");

        tbl.cell(7, 0).unwrap().v_merge_continue();
        tbl.cell(7, 1).unwrap().set_text("Monitoring");
        tbl.cell(7, 2).unwrap().set_text("Prometheus + Grafana");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 4. Nested table (table inside a cell)
    // =========================================================================
    doc.add_paragraph("4. Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");
        tbl = tbl.width_pct(100.0);
        tbl = tbl.cell_margins(
            Length::twips(72),
            Length::twips(108),
            Length::twips(72),
            Length::twips(108),
        );

        tbl.cell(0, 0).unwrap().set_text("Project Alpha");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Project Beta");
        tbl.cell(0, 1).unwrap().shading("2E75B6");

        // Nested table in cell (1,0)
        {
            let mut cell = tbl.cell(1, 0).unwrap();
            cell.set_text("Milestones:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "70AD47");
            inner.cell(0, 0).unwrap().set_text("Phase");
            inner.cell(0, 0).unwrap().shading("E2EFDA");
            inner.cell(0, 1).unwrap().set_text("Status");
            inner.cell(0, 1).unwrap().shading("E2EFDA");
            inner.cell(1, 0).unwrap().set_text("Design");
            inner.cell(1, 1).unwrap().set_text("Complete");
            inner.cell(2, 0).unwrap().set_text("Build");
            inner.cell(2, 1).unwrap().set_text("In Progress");
        }

        // Nested table in cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Budget:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "ED7D31");
            inner.cell(0, 0).unwrap().set_text("Category");
            inner.cell(0, 0).unwrap().shading("FCE4D6");
            inner.cell(0, 1).unwrap().set_text("Amount");
            inner.cell(0, 1).unwrap().shading("FCE4D6");
            inner.cell(1, 0).unwrap().set_text("Development");
            inner.cell(1, 1).unwrap().set_text("$120,000");
            inner.cell(2, 0).unwrap().set_text("Testing");
            inner.cell(2, 1).unwrap().set_text("$35,000");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 5. Form-style table with labels
    // =========================================================================
    doc.add_paragraph("5. Form-Style Table").style("Heading2");

    {
        let mut tbl = doc.add_table(6, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "808080");
        tbl = tbl.width_pct(100.0);

        // Row 0: Full-width title
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer Registration Form");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("404040");

        // Row 1: Name fields
        tbl.cell(1, 0).unwrap().set_text("First Name");
        tbl.cell(1, 0).unwrap().shading("E8E8E8");
        tbl.cell(1, 1).unwrap().set_text("John");
        tbl.cell(1, 2).unwrap().set_text("Last Name");
        tbl.cell(1, 2).unwrap().shading("E8E8E8");
        tbl.cell(1, 3).unwrap().set_text("Smith");

        // Row 2: Contact
        tbl.cell(2, 0).unwrap().set_text("Email");
        tbl.cell(2, 0).unwrap().shading("E8E8E8");
        tbl.cell(2, 1).unwrap().set_text("john.smith@example.com");
        tbl.cell(2, 1).unwrap().grid_span(3);

        // Row 3: Phone
        tbl.cell(3, 0).unwrap().set_text("Phone");
        tbl.cell(3, 0).unwrap().shading("E8E8E8");
        tbl.cell(3, 1).unwrap().set_text("+1 (555) 123-4567");
        tbl.cell(3, 2).unwrap().set_text("Company");
        tbl.cell(3, 2).unwrap().shading("E8E8E8");
        tbl.cell(3, 3).unwrap().set_text("Acme Corp");

        // Row 4: Address (spanning)
        tbl.cell(4, 0).unwrap().set_text("Address");
        tbl.cell(4, 0).unwrap().shading("E8E8E8");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("123 Business Ave, Suite 400, Portland, OR 97201");
        tbl.cell(4, 1).unwrap().grid_span(3);

        // Row 5: Notes
        tbl.cell(5, 0).unwrap().set_text("Notes");
        tbl.cell(5, 0).unwrap().shading("E8E8E8");
        tbl.cell(5, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top);
        {
            let mut cell = tbl.cell(5, 1).unwrap().grid_span(3);
            cell.set_text("Premium customer since 2020. Preferred contact method: email.");
            cell.add_paragraph("Annual review scheduled for March 2026.");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 6. Comparison table with border styles
    // =========================================================================
    doc.add_paragraph("6. Comparison Table with Custom Borders")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(5, 3);
        tbl = tbl.borders(BorderStyle::Double, 4, "2E75B6");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Feature");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Basic Plan");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Enterprise Plan");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        tbl.cell(1, 0).unwrap().set_text("Users");
        tbl.cell(1, 1).unwrap().set_text("Up to 10");
        tbl.cell(1, 2).unwrap().set_text("Unlimited");
        tbl.cell(1, 2).unwrap().shading("E2EFDA");

        tbl.cell(2, 0).unwrap().set_text("Storage");
        tbl.cell(2, 1).unwrap().set_text("50 GB");
        tbl.cell(2, 2).unwrap().set_text("5 TB");
        tbl.cell(2, 2).unwrap().shading("E2EFDA");

        tbl.cell(3, 0).unwrap().set_text("Support");
        tbl.cell(3, 1).unwrap().set_text("Email only");
        tbl.cell(3, 2).unwrap().set_text("24/7 Phone + Email");
        tbl.cell(3, 2).unwrap().shading("E2EFDA");

        tbl.cell(4, 0).unwrap().set_text("Price");
        tbl.cell(4, 0).unwrap().shading("F2F2F2");
        tbl.cell(4, 1).unwrap().set_text("$29/month");
        tbl.cell(4, 1).unwrap().shading("F2F2F2");
        tbl.cell(4, 2).unwrap().set_text("$199/month");
        tbl.cell(4, 2).unwrap().shading("C6EFCE");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 7. Wide table with fixed layout and row height
    // =========================================================================
    doc.add_paragraph("7. Fixed Layout Table with Row Height Control")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 5);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width(Length::inches(7.0));
        tbl = tbl.layout_fixed();

        // Set column widths
        for col in 0..5 {
            tbl.cell(0, col).unwrap().width(Length::inches(1.4));
        }

        // Header with exact height
        tbl.row(0).unwrap().height_exact(Length::twips(480));
        tbl.row(0).unwrap().header();
        tbl.row(0).unwrap().cant_split();

        let headers = ["Mon", "Tue", "Wed", "Thu", "Fri"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("404040");
            tbl.cell(0, col)
                .unwrap()
                .vertical_alignment(VerticalAlignment::Center);
        }

        // Schedule rows with minimum height
        tbl.row(1).unwrap().height(Length::twips(600));
        tbl.cell(1, 0).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 1).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 2).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 3).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 4).unwrap().set_text("9:00 Standup");

        tbl.row(2).unwrap().height(Length::twips(600));
        tbl.cell(2, 0).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 0).unwrap().shading("D6E4F0");
        tbl.cell(2, 1).unwrap().set_text("10:00 Design Review");
        tbl.cell(2, 1).unwrap().shading("FCE4D6");
        tbl.cell(2, 2).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 2).unwrap().shading("D6E4F0");
        tbl.cell(2, 3).unwrap().set_text("10:00 Sprint Planning");
        tbl.cell(2, 3).unwrap().shading("E2EFDA");
        tbl.cell(2, 4).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 4).unwrap().shading("D6E4F0");

        tbl.row(3).unwrap().height(Length::twips(600));
        tbl.cell(3, 0).unwrap().set_text("14:00 Code Review");
        tbl.cell(3, 1).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 1).unwrap().shading("D6E4F0");
        tbl.cell(3, 2).unwrap().set_text("14:00 Demo");
        tbl.cell(3, 2).unwrap().shading("FCE4D6");
        tbl.cell(3, 3).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 3).unwrap().shading("D6E4F0");
        tbl.cell(3, 4).unwrap().set_text("14:00 Retro");
        tbl.cell(3, 4).unwrap().shading("E2EFDA");
    }

    doc.set_title("Styled Tables Showcase");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/generate_all_samples.rs (line 101)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

// =============================================================================
// 6. LETTER — Slate blue + silver scheme
// =============================================================================
fn generate_letter(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Slate #4A5568, Blue accent #3182CE
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
    );
    doc.set_title("Business Letter");
    doc.set_author("Walter White");

    // Banner header using raw XML
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "4A5568",
            banner_width: 7772400,
            banner_height: 731520, // ~0.8"
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 146304,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_margins(
        Length::twips(2000),
        Length::twips(1800),
        Length::twips(1440),
        Length::twips(1800),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Footer with contact
    doc.set_footer(
        "Tensorbee | 123 Innovation Drive, Suite 400 | San Francisco, CA 94105 | tensorbee.com",
    );

    // ── Sender Address ──
    doc.add_paragraph("Walter White");
    doc.add_paragraph("Chief Executive Officer");
    doc.add_paragraph("Tensorbee");
    doc.add_paragraph("123 Innovation Drive, Suite 400");
    doc.add_paragraph("San Francisco, CA 94105");
    doc.add_paragraph("");
    doc.add_paragraph("February 22, 2026");

    doc.add_paragraph("");

    // ── Recipient ──
    doc.add_paragraph("Ms. Sarah Chen");
    doc.add_paragraph("VP of Engineering");
    doc.add_paragraph("Meridian Dynamics LLC");
    doc.add_paragraph("456 Enterprise Boulevard");
    doc.add_paragraph("Austin, TX 78701");

    doc.add_paragraph("");

    // ── Subject ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Re: Strategic Technology Partnership — Phase 2 Expansion")
            .bold(true);
    }

    doc.add_paragraph("");

    // ── Body ──
    doc.add_paragraph("Dear Ms. Chen,");
    doc.add_paragraph("");

    doc.add_paragraph(
        "I am writing to express Tensorbee's enthusiasm for expanding our strategic technology \
         partnership with Meridian Dynamics. Following the successful completion of Phase 1, \
         which delivered a 40% improvement in your ML inference pipeline throughput, we believe \
         the foundation is firmly established for an ambitious Phase 2 engagement.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "During our recent executive review, your team highlighted three priority areas for \
         the next phase of collaboration:",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_numbered_list_item(
        "Real-time anomaly detection for your financial transaction monitoring system, \
         targeting sub-100ms latency at 50,000 transactions per second.",
        0,
    );
    doc.add_numbered_list_item(
        "Federated learning infrastructure to enable model training across your distributed \
         data centers without centralizing sensitive financial data.",
        0,
    );
    doc.add_numbered_list_item(
        "MLOps automation to reduce your model deployment cycle from the current 5 days \
         to under 4 hours.",
        0,
    );

    doc.add_paragraph(
        "Our engineering team has prepared a detailed technical proposal addressing each of \
         these areas. We have allocated a dedicated team of eight senior engineers, led by \
         our CTO, to ensure continuity with the Phase 1 team your organization has already \
         built a productive working relationship with.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "I would welcome the opportunity to present our Phase 2 proposal in person. My \
         assistant will reach out to coordinate a meeting at your convenience during the \
         first week of March.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("");

    doc.add_paragraph("Warm regards,");
    doc.add_paragraph("");
    doc.add_paragraph("");

    // Signature line
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "4A5568");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Walter White").bold(true).size(12.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Chief Executive Officer, Tensorbee")
            .italic(true)
            .size(10.0)
            .color("666666");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("walter@tensorbee.com | +1 (415) 555-0199")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 7. EMPLOYMENT CONTRACT — Purple + charcoal scheme
// =============================================================================
fn generate_contract(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Purple #5B2C6F, Plum #8E44AD, Gray #2C3E50
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Employment Agreement");
    doc.set_author("Tensorbee HR Department");
    doc.set_subject("Employment Contract — Walter White");
    doc.set_keywords("employment, contract, agreement, Tensorbee");

    doc.set_header("TENSORBEE — Employment Agreement");
    doc.set_footer("Employment Agreement — Walter White — Page");

    // ── Title Block ──
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("EMPLOYMENT AGREEMENT")
            .bold(true)
            .size(24.0)
            .color("5B2C6F")
            .font("Georgia");
    }
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    doc.add_paragraph("");

    // ── Parties ──
    doc.add_paragraph(
        "This Employment Agreement (\"Agreement\") is entered into as of February 22, 2026 \
         (\"Effective Date\"), by and between:",
    );

    doc.add_paragraph("");

    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYER: ").bold(true);
        p.add_run(
            "Tensorbee, Inc., a Delaware corporation with its principal place of business at \
                   123 Innovation Drive, Suite 400, San Francisco, CA 94105 (\"Company\")",
        );
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYEE: ").bold(true);
        p.add_run(
            "Walter White, residing at 308 Negra Arroyo Lane, Albuquerque, NM 87104 (\"Employee\")",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph("The Company and Employee are collectively referred to as the \"Parties.\"");
    doc.add_paragraph("");

    // ── Article 1: Position and Duties ──
    doc.add_paragraph("Article 1 — Position and Duties")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.1 ").bold(true);
        p.add_run("The Company hereby employs the Employee as ");
        p.add_run("Chief Executive Officer (CEO)")
            .bold(true)
            .italic(true);
        p.add_run(", reporting directly to the Board of Directors.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.2 ").bold(true);
        p.add_run("The Employee shall devote full working time, attention, and best efforts to \
                   the performance of duties as reasonably assigned by the Board, including but not limited to:");
    }
    doc.add_bullet_list_item(
        "Setting and executing the Company's strategic vision and business plan",
        0,
    );
    doc.add_bullet_list_item(
        "Overseeing all operations, engineering, and commercial activities",
        0,
    );
    doc.add_bullet_list_item(
        "Representing the Company to investors, customers, and the public",
        0,
    );
    doc.add_bullet_list_item("Recruiting, developing, and retaining key talent", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.3 ").bold(true);
        p.add_run(
            "The Employee's primary work location shall be the Company's San Francisco \
                   headquarters, with reasonable travel as required by business needs.",
        );
    }

    // ── Article 2: Compensation ──
    doc.add_paragraph("Article 2 — Compensation and Benefits")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.1 Base Salary. ").bold(true);
        p.add_run("The Company shall pay the Employee an annual base salary of ");
        p.add_run("$375,000.00").bold(true);
        p.add_run(" (Three Hundred Seventy-Five Thousand Dollars), payable in accordance with the \
                   Company's standard payroll schedule, less applicable withholdings and deductions.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.2 Annual Bonus. ").bold(true);
        p.add_run("The Employee shall be eligible for an annual performance bonus of up to ");
        p.add_run("40%").bold(true);
        p.add_run(
            " of base salary, based on achievement of mutually agreed performance objectives.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.3 Equity. ").bold(true);
        p.add_run("Subject to Board approval, the Employee shall receive a stock option grant of ");
        p.add_run("500,000 shares").bold(true);
        p.add_run(
            " of the Company's common stock, vesting over four (4) years with a one-year cliff, \
                   at an exercise price equal to the fair market value on the date of grant.",
        );
    }

    // Compensation summary table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "5B2C6F")
            .width_pct(70.0)
            .alignment(Alignment::Center);
        tbl.cell(0, 0).unwrap().set_text("Compensation Element");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");
        let items = [
            ("Base Salary", "$375,000/year"),
            ("Target Bonus", "Up to 40% ($150,000)"),
            ("Equity Grant", "500,000 shares (4yr vest)"),
            ("Total Target Comp", "$525,000 + equity"),
        ];
        for (i, (elem, val)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(elem);
            tbl.cell(i + 1, 1).unwrap().set_text(val);
            if i == 3 {
                tbl.cell(i + 1, 0).unwrap().shading("E8DAEF");
                tbl.cell(i + 1, 1).unwrap().shading("E8DAEF");
            }
        }
    }

    // ── Article 3: Benefits ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Article 3 — Benefits").style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.1 ").bold(true);
        p.add_run(
            "The Employee shall be entitled to participate in all benefit programs \
                   generally available to senior executives, including:",
        );
    }
    doc.add_bullet_list_item(
        "Medical, dental, and vision insurance (100% premium coverage for employee and dependents)",
        0,
    );
    doc.add_bullet_list_item("401(k) retirement plan with 6% company match", 0);
    doc.add_bullet_list_item("Life insurance and long-term disability coverage", 0);
    doc.add_bullet_list_item("Annual professional development allowance of $10,000", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.2 Paid Time Off. ").bold(true);
        p.add_run(
            "The Employee shall receive 25 days of paid vacation per year, plus Company holidays, \
                   accruing on a monthly basis.",
        );
    }

    // ── Article 4: Term and Termination ──
    doc.add_paragraph("Article 4 — Term and Termination")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.1 At-Will Employment. ").bold(true);
        p.add_run(
            "This Agreement is for at-will employment and may be terminated by either Party \
                   at any time, with or without cause, subject to the notice provisions herein.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.2 Notice Period. ").bold(true);
        p.add_run("Either Party shall provide ");
        p.add_run("ninety (90) days").bold(true);
        p.add_run(" written notice of termination, or pay in lieu thereof.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.3 Severance. ").bold(true);
        p.add_run("In the event of termination by the Company without Cause, the Employee shall \
                   receive (a) twelve (12) months of base salary continuation, (b) pro-rata bonus \
                   for the year of termination, and (c) twelve (12) months of COBRA premium coverage.");
    }

    // ── Article 5: Confidentiality ──
    doc.add_paragraph("Article 5 — Confidentiality and IP")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.1 ").bold(true);
        p.add_run(
            "The Employee agrees to maintain strict confidentiality of all proprietary \
                   information, trade secrets, and business plans of the Company during and after \
                   employment.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.2 ").bold(true);
        p.add_run(
            "All intellectual property, inventions, and works of authorship created by the \
                   Employee during the term of employment and within the scope of duties shall be \
                   the sole and exclusive property of the Company.",
        );
    }

    // ── Article 6: Non-Compete ──
    doc.add_paragraph("Article 6 — Non-Competition")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("6.1 ").bold(true);
        p.add_run("For a period of twelve (12) months following termination, the Employee agrees \
                   not to engage in any business that directly competes with the Company's core \
                   business of AI infrastructure and ML operations services, within the United States.");
    }

    // ── Article 7: General Provisions ──
    doc.add_paragraph("Article 7 — General Provisions")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.1 Governing Law. ").bold(true);
        p.add_run(
            "This Agreement shall be governed by and construed in accordance with the laws of \
                   the State of California.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.2 Entire Agreement. ").bold(true);
        p.add_run(
            "This Agreement constitutes the entire agreement between the Parties and supersedes \
                   all prior negotiations, representations, and agreements.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.3 Amendment. ").bold(true);
        p.add_run(
            "This Agreement may only be amended by a written instrument signed by both Parties.",
        );
    }

    // ── Signature Block ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("IN WITNESS WHEREOF, the Parties have executed this Employment Agreement as of the Effective Date.")
        .space_after(Length::pt(24.0));

    // Signature table
    {
        let mut tbl = doc.add_table(6, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("FOR THE COMPANY:");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("EMPLOYEE:");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");

        tbl.cell(1, 0).unwrap().set_text("");
        tbl.cell(1, 1).unwrap().set_text("");
        tbl.row(1).unwrap().height(Length::pt(40.0));

        tbl.cell(2, 0)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(3, 0)
            .unwrap()
            .set_text("Name: Board Representative");
        tbl.cell(3, 1).unwrap().set_text("Name: Walter White");
        tbl.cell(4, 0)
            .unwrap()
            .set_text("Title: Chair, Board of Directors");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Title: Chief Executive Officer");
        tbl.cell(5, 0).unwrap().set_text("Date: _______________");
        tbl.cell(5, 1).unwrap().set_text("Date: _______________");
    }

    doc
}

pub fn set_landscape(&mut self)

Set page orientation to landscape (swaps width and height if needed).

pub fn set_portrait(&mut self)

Set page orientation to portrait (swaps width and height if needed).

pub fn set_margins( &mut self, top: Length, right: Length, bottom: Length, left: Length, )

Set all page margins.

Examples found in repository

examples/template_replace.rs (lines 46-51)

fn create_template(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );

    doc.set_header("{{company_name}} — Confidential");
    doc.set_footer("Prepared by {{author_name}} on {{date}}");

    // ── Title ──
    doc.add_paragraph("{{company_name}}")
        .style("Heading1")
        .alignment(Alignment::Center);

    doc.add_paragraph("Project Proposal")
        .alignment(Alignment::Center);

    doc.add_paragraph("");

    // ── Summary section ──
    doc.add_paragraph("Executive Summary").style("Heading2");

    doc.add_paragraph(
        "This proposal outlines the {{project_name}} project for {{company_name}}. \
         The primary contact is {{contact_name}} ({{contact_email}}). \
         The proposed start date is {{start_date}} with an estimated duration of {{duration}}.",
    );

    doc.add_paragraph("");

    // ── Cross-run placeholder (bold label + normal value) ──
    doc.add_paragraph("Key Details").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Project: ").bold(true);
        p.add_run("{{project_name}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Budget: ").bold(true);
        p.add_run("{{budget}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Status: ").bold(true);
        p.add_run("{{status}}");
    }

    doc.add_paragraph("");

    // ── Table with placeholders ──
    doc.add_paragraph("Team Members").style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        // Header row
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Email");

        tbl.cell(1, 0).unwrap().set_text("{{member1_name}}");
        tbl.cell(1, 1).unwrap().set_text("{{member1_role}}");
        tbl.cell(1, 2).unwrap().set_text("{{member1_email}}");

        tbl.cell(2, 0).unwrap().set_text("{{member2_name}}");
        tbl.cell(2, 1).unwrap().set_text("{{member2_role}}");
        tbl.cell(2, 2).unwrap().set_text("{{member2_email}}");

        tbl.cell(3, 0).unwrap().set_text("{{member3_name}}");
        tbl.cell(3, 1).unwrap().set_text("{{member3_role}}");
        tbl.cell(3, 2).unwrap().set_text("{{member3_email}}");
    }

    doc.add_paragraph("");

    // ── Deliverables section ──
    doc.add_paragraph("Deliverables").style("Heading2");

    doc.add_paragraph("INSERTION_POINT");

    doc.add_paragraph("");

    // ── Signature block ──
    doc.add_paragraph("Acceptance").style("Heading2");

    doc.add_paragraph(
        "By signing below, {{company_name}} agrees to the terms outlined in this proposal.",
    );

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer: ___________________");
        tbl.cell(0, 1)
            .unwrap()
            .set_text("Provider: ___________________");
        tbl.cell(1, 0).unwrap().set_text("Date: {{date}}");
        tbl.cell(1, 1).unwrap().set_text("Date: {{date}}");
    }

    doc.set_title("{{company_name}} — Project Proposal Template");
    doc.set_author("Template Generator");

    doc.save(path).unwrap();
}

examples/header_banner.rs (lines 34-39)

fn generate_header_banner_doc(path: &Path) {
    let mut doc = Document::new();

    // Page setup with extra top margin for the banner
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::twips(2292), // top — extra tall for header banner
        Length::twips(1440), // right
        Length::twips(1440), // bottom
        Length::twips(1440), // left
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Generate a simple logo image (white text on transparent background)
    let logo_img = create_logo_png(220, 48);

    // ── Dark blue banner ──
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1A3C6E",
            banner_width: 7772400, // full page width in EMU (~8.5")
            banner_height: 969026, // banner height in EMU (~1.06")
            logo_width: 2011680,   // logo display width (~2.2")
            logo_height: 438912,   // logo display height (~0.48")
            logo_x_offset: 295125, // left padding
            logo_y_offset: 265057, // vertical centering
        },
    );

    doc.set_raw_header_with_images(
        banner.clone(),
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );

    // Use a different first page header (same banner, different color)
    doc.set_different_first_page(true);
    let first_page_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "2E75B6", // lighter blue for cover
            banner_width: 7772400,
            banner_height: 969026,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 265057,
        },
    );
    doc.set_raw_header_with_images(
        first_page_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );

    // Footer
    doc.set_footer("Confidential — Internal Use Only");

    // ── Page 1: Cover ──
    doc.add_paragraph("Company Report").style("Heading1");

    doc.add_paragraph(
        "This document demonstrates a custom header banner built with DrawingML \
         group shapes. The banner uses a colored rectangle with a logo image overlaid, \
         positioned at the top of each page.",
    );

    doc.add_paragraph("");

    doc.add_paragraph("How the Header Banner Works")
        .style("Heading2");

    doc.add_paragraph(
        "The header banner is built using set_raw_header_with_images(), which \
         accepts raw XML and a list of (rel_id, image_data, filename) tuples. \
         The XML uses a DrawingML group shape (wpg:wgp) containing:",
    );

    doc.add_bullet_list_item(
        "A wps:wsp rectangle shape with a solid color fill (the background bar)",
        0,
    );
    doc.add_bullet_list_item(
        "A pic:pic image element positioned within the group (the logo)",
        0,
    );
    doc.add_bullet_list_item(
        "The group is wrapped in a wp:anchor element for absolute page positioning",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Customization").style("Heading2");

    doc.add_paragraph(
        "All dimensions are in EMU (English Metric Units) where 914400 EMU = 1 inch. \
         You can customize:",
    );

    doc.add_bullet_list_item("bg_color — any hex color for the rectangle background", 0);
    doc.add_bullet_list_item("banner_width / banner_height — size of the full banner", 0);
    doc.add_bullet_list_item("logo_width / logo_height — display size of the logo", 0);
    doc.add_bullet_list_item(
        "logo_x_offset / logo_y_offset — logo position within the banner",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Different First Page").style("Heading2");

    doc.add_paragraph(
        "This page uses a lighter blue banner (first page header). \
         Subsequent pages use a darker blue banner (default header). \
         Use set_different_first_page(true) to enable this.",
    );

    // ── Page 2 ──
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("Second Page").style("Heading1");

    doc.add_paragraph(
        "This page shows the default header banner (dark blue). The first page \
         had a lighter blue banner because we set a different first-page header.",
    );

    doc.add_paragraph("");

    doc.add_paragraph(
        "The banner repeats on every page because it is placed in the header part. \
         You can have different banners for default, first-page, and even-page headers.",
    );

    doc.set_title("Header Banner Example");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/styled_tables.rs (lines 27-32)

fn generate_styled_tables(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );

    doc.add_paragraph("Styled Tables Showcase")
        .style("Heading1");

    doc.add_paragraph("");

    // =========================================================================
    // 1. Professional report table with alternating rows
    // =========================================================================
    doc.add_paragraph("1. Report Table with Alternating Row Colors")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 4);
        tbl = tbl.borders(BorderStyle::Single, 2, "BFBFBF");
        tbl = tbl.width_pct(100.0);

        // Header row
        let headers = ["Product", "Q1 Sales", "Q2 Sales", "Growth"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().shading("2E75B6");
            tbl.cell(0, col).unwrap().set_text(h);
        }
        tbl.row(0).unwrap().header();

        // Data with alternating shading
        let data = [
            ["Enterprise Suite", "$245,000", "$312,000", "+27.3%"],
            ["Professional", "$189,000", "$201,000", "+6.3%"],
            ["Starter Pack", "$67,000", "$84,500", "+26.1%"],
            ["Add-ons", "$34,000", "$41,200", "+21.2%"],
            ["Training", "$22,000", "$28,900", "+31.4%"],
            ["Support Plans", "$56,000", "$62,300", "+11.3%"],
        ];

        for (i, row) in data.iter().enumerate() {
            let row_idx = i + 1;
            for (col, val) in row.iter().enumerate() {
                tbl.cell(row_idx, col).unwrap().set_text(val);
                // Alternate row colors
                if i % 2 == 0 {
                    tbl.cell(row_idx, col).unwrap().shading("F2F7FB");
                }
            }
        }

        // Total row
        tbl.cell(7, 0).unwrap().set_text("TOTAL");
        tbl.cell(7, 0).unwrap().shading("D6E4F0");
        tbl.cell(7, 1).unwrap().set_text("$613,000");
        tbl.cell(7, 1).unwrap().shading("D6E4F0");
        tbl.cell(7, 2).unwrap().set_text("$729,900");
        tbl.cell(7, 2).unwrap().shading("D6E4F0");
        tbl.cell(7, 3).unwrap().set_text("+19.1%");
        tbl.cell(7, 3).unwrap().shading("D6E4F0");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 2. Invoice-style table with merged header
    // =========================================================================
    doc.add_paragraph("2. Invoice Table with Merged Header & Row Spans")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(7, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Merged title row
        tbl.cell(0, 0).unwrap().set_text("INVOICE #2026-0042");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("1F4E79");

        // Column headers
        let headers = ["Item", "Description", "Qty", "Amount"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(1, col).unwrap().set_text(h);
            tbl.cell(1, col).unwrap().shading("D6E4F0");
        }

        // Line items
        tbl.cell(2, 0).unwrap().set_text("LIC-ENT-500");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Enterprise License (500 seats)");
        tbl.cell(2, 2).unwrap().set_text("1");
        tbl.cell(2, 3).unwrap().set_text("$60,000");

        tbl.cell(3, 0).unwrap().set_text("SVC-IMPL");
        tbl.cell(3, 1).unwrap().set_text("Implementation Services");
        tbl.cell(3, 2).unwrap().set_text("1");
        tbl.cell(3, 3).unwrap().set_text("$25,000");

        tbl.cell(4, 0).unwrap().set_text("SVC-TRAIN");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("On-site Training (3 days)");
        tbl.cell(4, 2).unwrap().set_text("1");
        tbl.cell(4, 3).unwrap().set_text("$4,500");

        // Subtotal
        tbl.cell(5, 0).unwrap().set_text("Subtotal");
        tbl.cell(5, 0).unwrap().grid_span(3);
        tbl.cell(5, 0).unwrap().shading("F2F2F2");
        tbl.cell(5, 3).unwrap().set_text("$89,500");
        tbl.cell(5, 3).unwrap().shading("F2F2F2");

        // Total
        tbl.cell(6, 0).unwrap().set_text("TOTAL DUE");
        tbl.cell(6, 0).unwrap().grid_span(3);
        tbl.cell(6, 0).unwrap().shading("1F4E79");
        tbl.cell(6, 3).unwrap().set_text("$89,500");
        tbl.cell(6, 3).unwrap().shading("1F4E79");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 3. Specification table with vertical merge
    // =========================================================================
    doc.add_paragraph("3. Specification Table with Vertical Merges")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Specification");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Value");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        // "Hardware" spans 3 rows
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 0).unwrap().shading("E2EFDA");
        tbl.cell(1, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(1, 1).unwrap().set_text("Processor");
        tbl.cell(1, 2).unwrap().set_text("Intel Xeon E-2388G");

        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Memory");
        tbl.cell(2, 2).unwrap().set_text("64 GB DDR4 ECC");

        tbl.cell(3, 0).unwrap().v_merge_continue();
        tbl.cell(3, 1).unwrap().set_text("Storage");
        tbl.cell(3, 2).unwrap().set_text("2x 1TB NVMe SSD (RAID 1)");

        // "Network" spans 2 rows
        tbl.cell(4, 0).unwrap().set_text("Network");
        tbl.cell(4, 0).unwrap().v_merge_restart();
        tbl.cell(4, 0).unwrap().shading("FCE4D6");
        tbl.cell(4, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(4, 1).unwrap().set_text("Ethernet");
        tbl.cell(4, 2).unwrap().set_text("4x 10GbE SFP+");

        tbl.cell(5, 0).unwrap().v_merge_continue();
        tbl.cell(5, 1).unwrap().set_text("Management");
        tbl.cell(5, 2).unwrap().set_text("1x 1GbE IPMI");

        // "Software" spans 2 rows
        tbl.cell(6, 0).unwrap().set_text("Software");
        tbl.cell(6, 0).unwrap().v_merge_restart();
        tbl.cell(6, 0).unwrap().shading("D6E4F0");
        tbl.cell(6, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(6, 1).unwrap().set_text("Operating System");
        tbl.cell(6, 2).unwrap().set_text("Ubuntu 24.04 LTS");

        tbl.cell(7, 0).unwrap().v_merge_continue();
        tbl.cell(7, 1).unwrap().set_text("Monitoring");
        tbl.cell(7, 2).unwrap().set_text("Prometheus + Grafana");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 4. Nested table (table inside a cell)
    // =========================================================================
    doc.add_paragraph("4. Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");
        tbl = tbl.width_pct(100.0);
        tbl = tbl.cell_margins(
            Length::twips(72),
            Length::twips(108),
            Length::twips(72),
            Length::twips(108),
        );

        tbl.cell(0, 0).unwrap().set_text("Project Alpha");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Project Beta");
        tbl.cell(0, 1).unwrap().shading("2E75B6");

        // Nested table in cell (1,0)
        {
            let mut cell = tbl.cell(1, 0).unwrap();
            cell.set_text("Milestones:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "70AD47");
            inner.cell(0, 0).unwrap().set_text("Phase");
            inner.cell(0, 0).unwrap().shading("E2EFDA");
            inner.cell(0, 1).unwrap().set_text("Status");
            inner.cell(0, 1).unwrap().shading("E2EFDA");
            inner.cell(1, 0).unwrap().set_text("Design");
            inner.cell(1, 1).unwrap().set_text("Complete");
            inner.cell(2, 0).unwrap().set_text("Build");
            inner.cell(2, 1).unwrap().set_text("In Progress");
        }

        // Nested table in cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Budget:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "ED7D31");
            inner.cell(0, 0).unwrap().set_text("Category");
            inner.cell(0, 0).unwrap().shading("FCE4D6");
            inner.cell(0, 1).unwrap().set_text("Amount");
            inner.cell(0, 1).unwrap().shading("FCE4D6");
            inner.cell(1, 0).unwrap().set_text("Development");
            inner.cell(1, 1).unwrap().set_text("$120,000");
            inner.cell(2, 0).unwrap().set_text("Testing");
            inner.cell(2, 1).unwrap().set_text("$35,000");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 5. Form-style table with labels
    // =========================================================================
    doc.add_paragraph("5. Form-Style Table").style("Heading2");

    {
        let mut tbl = doc.add_table(6, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "808080");
        tbl = tbl.width_pct(100.0);

        // Row 0: Full-width title
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer Registration Form");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("404040");

        // Row 1: Name fields
        tbl.cell(1, 0).unwrap().set_text("First Name");
        tbl.cell(1, 0).unwrap().shading("E8E8E8");
        tbl.cell(1, 1).unwrap().set_text("John");
        tbl.cell(1, 2).unwrap().set_text("Last Name");
        tbl.cell(1, 2).unwrap().shading("E8E8E8");
        tbl.cell(1, 3).unwrap().set_text("Smith");

        // Row 2: Contact
        tbl.cell(2, 0).unwrap().set_text("Email");
        tbl.cell(2, 0).unwrap().shading("E8E8E8");
        tbl.cell(2, 1).unwrap().set_text("john.smith@example.com");
        tbl.cell(2, 1).unwrap().grid_span(3);

        // Row 3: Phone
        tbl.cell(3, 0).unwrap().set_text("Phone");
        tbl.cell(3, 0).unwrap().shading("E8E8E8");
        tbl.cell(3, 1).unwrap().set_text("+1 (555) 123-4567");
        tbl.cell(3, 2).unwrap().set_text("Company");
        tbl.cell(3, 2).unwrap().shading("E8E8E8");
        tbl.cell(3, 3).unwrap().set_text("Acme Corp");

        // Row 4: Address (spanning)
        tbl.cell(4, 0).unwrap().set_text("Address");
        tbl.cell(4, 0).unwrap().shading("E8E8E8");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("123 Business Ave, Suite 400, Portland, OR 97201");
        tbl.cell(4, 1).unwrap().grid_span(3);

        // Row 5: Notes
        tbl.cell(5, 0).unwrap().set_text("Notes");
        tbl.cell(5, 0).unwrap().shading("E8E8E8");
        tbl.cell(5, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top);
        {
            let mut cell = tbl.cell(5, 1).unwrap().grid_span(3);
            cell.set_text("Premium customer since 2020. Preferred contact method: email.");
            cell.add_paragraph("Annual review scheduled for March 2026.");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 6. Comparison table with border styles
    // =========================================================================
    doc.add_paragraph("6. Comparison Table with Custom Borders")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(5, 3);
        tbl = tbl.borders(BorderStyle::Double, 4, "2E75B6");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Feature");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Basic Plan");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Enterprise Plan");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        tbl.cell(1, 0).unwrap().set_text("Users");
        tbl.cell(1, 1).unwrap().set_text("Up to 10");
        tbl.cell(1, 2).unwrap().set_text("Unlimited");
        tbl.cell(1, 2).unwrap().shading("E2EFDA");

        tbl.cell(2, 0).unwrap().set_text("Storage");
        tbl.cell(2, 1).unwrap().set_text("50 GB");
        tbl.cell(2, 2).unwrap().set_text("5 TB");
        tbl.cell(2, 2).unwrap().shading("E2EFDA");

        tbl.cell(3, 0).unwrap().set_text("Support");
        tbl.cell(3, 1).unwrap().set_text("Email only");
        tbl.cell(3, 2).unwrap().set_text("24/7 Phone + Email");
        tbl.cell(3, 2).unwrap().shading("E2EFDA");

        tbl.cell(4, 0).unwrap().set_text("Price");
        tbl.cell(4, 0).unwrap().shading("F2F2F2");
        tbl.cell(4, 1).unwrap().set_text("$29/month");
        tbl.cell(4, 1).unwrap().shading("F2F2F2");
        tbl.cell(4, 2).unwrap().set_text("$199/month");
        tbl.cell(4, 2).unwrap().shading("C6EFCE");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 7. Wide table with fixed layout and row height
    // =========================================================================
    doc.add_paragraph("7. Fixed Layout Table with Row Height Control")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 5);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width(Length::inches(7.0));
        tbl = tbl.layout_fixed();

        // Set column widths
        for col in 0..5 {
            tbl.cell(0, col).unwrap().width(Length::inches(1.4));
        }

        // Header with exact height
        tbl.row(0).unwrap().height_exact(Length::twips(480));
        tbl.row(0).unwrap().header();
        tbl.row(0).unwrap().cant_split();

        let headers = ["Mon", "Tue", "Wed", "Thu", "Fri"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("404040");
            tbl.cell(0, col)
                .unwrap()
                .vertical_alignment(VerticalAlignment::Center);
        }

        // Schedule rows with minimum height
        tbl.row(1).unwrap().height(Length::twips(600));
        tbl.cell(1, 0).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 1).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 2).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 3).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 4).unwrap().set_text("9:00 Standup");

        tbl.row(2).unwrap().height(Length::twips(600));
        tbl.cell(2, 0).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 0).unwrap().shading("D6E4F0");
        tbl.cell(2, 1).unwrap().set_text("10:00 Design Review");
        tbl.cell(2, 1).unwrap().shading("FCE4D6");
        tbl.cell(2, 2).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 2).unwrap().shading("D6E4F0");
        tbl.cell(2, 3).unwrap().set_text("10:00 Sprint Planning");
        tbl.cell(2, 3).unwrap().shading("E2EFDA");
        tbl.cell(2, 4).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 4).unwrap().shading("D6E4F0");

        tbl.row(3).unwrap().height(Length::twips(600));
        tbl.cell(3, 0).unwrap().set_text("14:00 Code Review");
        tbl.cell(3, 1).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 1).unwrap().shading("D6E4F0");
        tbl.cell(3, 2).unwrap().set_text("14:00 Demo");
        tbl.cell(3, 2).unwrap().shading("FCE4D6");
        tbl.cell(3, 3).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 3).unwrap().shading("D6E4F0");
        tbl.cell(3, 4).unwrap().set_text("14:00 Retro");
        tbl.cell(3, 4).unwrap().shading("E2EFDA");
    }

    doc.set_title("Styled Tables Showcase");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/generate_all_samples.rs (lines 102-107)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

// =============================================================================
// 6. LETTER — Slate blue + silver scheme
// =============================================================================
fn generate_letter(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Slate #4A5568, Blue accent #3182CE
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
    );
    doc.set_title("Business Letter");
    doc.set_author("Walter White");

    // Banner header using raw XML
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "4A5568",
            banner_width: 7772400,
            banner_height: 731520, // ~0.8"
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 146304,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_margins(
        Length::twips(2000),
        Length::twips(1800),
        Length::twips(1440),
        Length::twips(1800),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Footer with contact
    doc.set_footer(
        "Tensorbee | 123 Innovation Drive, Suite 400 | San Francisco, CA 94105 | tensorbee.com",
    );

    // ── Sender Address ──
    doc.add_paragraph("Walter White");
    doc.add_paragraph("Chief Executive Officer");
    doc.add_paragraph("Tensorbee");
    doc.add_paragraph("123 Innovation Drive, Suite 400");
    doc.add_paragraph("San Francisco, CA 94105");
    doc.add_paragraph("");
    doc.add_paragraph("February 22, 2026");

    doc.add_paragraph("");

    // ── Recipient ──
    doc.add_paragraph("Ms. Sarah Chen");
    doc.add_paragraph("VP of Engineering");
    doc.add_paragraph("Meridian Dynamics LLC");
    doc.add_paragraph("456 Enterprise Boulevard");
    doc.add_paragraph("Austin, TX 78701");

    doc.add_paragraph("");

    // ── Subject ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Re: Strategic Technology Partnership — Phase 2 Expansion")
            .bold(true);
    }

    doc.add_paragraph("");

    // ── Body ──
    doc.add_paragraph("Dear Ms. Chen,");
    doc.add_paragraph("");

    doc.add_paragraph(
        "I am writing to express Tensorbee's enthusiasm for expanding our strategic technology \
         partnership with Meridian Dynamics. Following the successful completion of Phase 1, \
         which delivered a 40% improvement in your ML inference pipeline throughput, we believe \
         the foundation is firmly established for an ambitious Phase 2 engagement.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "During our recent executive review, your team highlighted three priority areas for \
         the next phase of collaboration:",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_numbered_list_item(
        "Real-time anomaly detection for your financial transaction monitoring system, \
         targeting sub-100ms latency at 50,000 transactions per second.",
        0,
    );
    doc.add_numbered_list_item(
        "Federated learning infrastructure to enable model training across your distributed \
         data centers without centralizing sensitive financial data.",
        0,
    );
    doc.add_numbered_list_item(
        "MLOps automation to reduce your model deployment cycle from the current 5 days \
         to under 4 hours.",
        0,
    );

    doc.add_paragraph(
        "Our engineering team has prepared a detailed technical proposal addressing each of \
         these areas. We have allocated a dedicated team of eight senior engineers, led by \
         our CTO, to ensure continuity with the Phase 1 team your organization has already \
         built a productive working relationship with.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "I would welcome the opportunity to present our Phase 2 proposal in person. My \
         assistant will reach out to coordinate a meeting at your convenience during the \
         first week of March.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("");

    doc.add_paragraph("Warm regards,");
    doc.add_paragraph("");
    doc.add_paragraph("");

    // Signature line
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "4A5568");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Walter White").bold(true).size(12.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Chief Executive Officer, Tensorbee")
            .italic(true)
            .size(10.0)
            .color("666666");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("walter@tensorbee.com | +1 (415) 555-0199")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 7. EMPLOYMENT CONTRACT — Purple + charcoal scheme
// =============================================================================
fn generate_contract(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Purple #5B2C6F, Plum #8E44AD, Gray #2C3E50
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Employment Agreement");
    doc.set_author("Tensorbee HR Department");
    doc.set_subject("Employment Contract — Walter White");
    doc.set_keywords("employment, contract, agreement, Tensorbee");

    doc.set_header("TENSORBEE — Employment Agreement");
    doc.set_footer("Employment Agreement — Walter White — Page");

    // ── Title Block ──
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("EMPLOYMENT AGREEMENT")
            .bold(true)
            .size(24.0)
            .color("5B2C6F")
            .font("Georgia");
    }
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    doc.add_paragraph("");

    // ── Parties ──
    doc.add_paragraph(
        "This Employment Agreement (\"Agreement\") is entered into as of February 22, 2026 \
         (\"Effective Date\"), by and between:",
    );

    doc.add_paragraph("");

    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYER: ").bold(true);
        p.add_run(
            "Tensorbee, Inc., a Delaware corporation with its principal place of business at \
                   123 Innovation Drive, Suite 400, San Francisco, CA 94105 (\"Company\")",
        );
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYEE: ").bold(true);
        p.add_run(
            "Walter White, residing at 308 Negra Arroyo Lane, Albuquerque, NM 87104 (\"Employee\")",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph("The Company and Employee are collectively referred to as the \"Parties.\"");
    doc.add_paragraph("");

    // ── Article 1: Position and Duties ──
    doc.add_paragraph("Article 1 — Position and Duties")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.1 ").bold(true);
        p.add_run("The Company hereby employs the Employee as ");
        p.add_run("Chief Executive Officer (CEO)")
            .bold(true)
            .italic(true);
        p.add_run(", reporting directly to the Board of Directors.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.2 ").bold(true);
        p.add_run("The Employee shall devote full working time, attention, and best efforts to \
                   the performance of duties as reasonably assigned by the Board, including but not limited to:");
    }
    doc.add_bullet_list_item(
        "Setting and executing the Company's strategic vision and business plan",
        0,
    );
    doc.add_bullet_list_item(
        "Overseeing all operations, engineering, and commercial activities",
        0,
    );
    doc.add_bullet_list_item(
        "Representing the Company to investors, customers, and the public",
        0,
    );
    doc.add_bullet_list_item("Recruiting, developing, and retaining key talent", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.3 ").bold(true);
        p.add_run(
            "The Employee's primary work location shall be the Company's San Francisco \
                   headquarters, with reasonable travel as required by business needs.",
        );
    }

    // ── Article 2: Compensation ──
    doc.add_paragraph("Article 2 — Compensation and Benefits")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.1 Base Salary. ").bold(true);
        p.add_run("The Company shall pay the Employee an annual base salary of ");
        p.add_run("$375,000.00").bold(true);
        p.add_run(" (Three Hundred Seventy-Five Thousand Dollars), payable in accordance with the \
                   Company's standard payroll schedule, less applicable withholdings and deductions.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.2 Annual Bonus. ").bold(true);
        p.add_run("The Employee shall be eligible for an annual performance bonus of up to ");
        p.add_run("40%").bold(true);
        p.add_run(
            " of base salary, based on achievement of mutually agreed performance objectives.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.3 Equity. ").bold(true);
        p.add_run("Subject to Board approval, the Employee shall receive a stock option grant of ");
        p.add_run("500,000 shares").bold(true);
        p.add_run(
            " of the Company's common stock, vesting over four (4) years with a one-year cliff, \
                   at an exercise price equal to the fair market value on the date of grant.",
        );
    }

    // Compensation summary table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "5B2C6F")
            .width_pct(70.0)
            .alignment(Alignment::Center);
        tbl.cell(0, 0).unwrap().set_text("Compensation Element");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");
        let items = [
            ("Base Salary", "$375,000/year"),
            ("Target Bonus", "Up to 40% ($150,000)"),
            ("Equity Grant", "500,000 shares (4yr vest)"),
            ("Total Target Comp", "$525,000 + equity"),
        ];
        for (i, (elem, val)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(elem);
            tbl.cell(i + 1, 1).unwrap().set_text(val);
            if i == 3 {
                tbl.cell(i + 1, 0).unwrap().shading("E8DAEF");
                tbl.cell(i + 1, 1).unwrap().shading("E8DAEF");
            }
        }
    }

    // ── Article 3: Benefits ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Article 3 — Benefits").style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.1 ").bold(true);
        p.add_run(
            "The Employee shall be entitled to participate in all benefit programs \
                   generally available to senior executives, including:",
        );
    }
    doc.add_bullet_list_item(
        "Medical, dental, and vision insurance (100% premium coverage for employee and dependents)",
        0,
    );
    doc.add_bullet_list_item("401(k) retirement plan with 6% company match", 0);
    doc.add_bullet_list_item("Life insurance and long-term disability coverage", 0);
    doc.add_bullet_list_item("Annual professional development allowance of $10,000", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.2 Paid Time Off. ").bold(true);
        p.add_run(
            "The Employee shall receive 25 days of paid vacation per year, plus Company holidays, \
                   accruing on a monthly basis.",
        );
    }

    // ── Article 4: Term and Termination ──
    doc.add_paragraph("Article 4 — Term and Termination")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.1 At-Will Employment. ").bold(true);
        p.add_run(
            "This Agreement is for at-will employment and may be terminated by either Party \
                   at any time, with or without cause, subject to the notice provisions herein.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.2 Notice Period. ").bold(true);
        p.add_run("Either Party shall provide ");
        p.add_run("ninety (90) days").bold(true);
        p.add_run(" written notice of termination, or pay in lieu thereof.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.3 Severance. ").bold(true);
        p.add_run("In the event of termination by the Company without Cause, the Employee shall \
                   receive (a) twelve (12) months of base salary continuation, (b) pro-rata bonus \
                   for the year of termination, and (c) twelve (12) months of COBRA premium coverage.");
    }

    // ── Article 5: Confidentiality ──
    doc.add_paragraph("Article 5 — Confidentiality and IP")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.1 ").bold(true);
        p.add_run(
            "The Employee agrees to maintain strict confidentiality of all proprietary \
                   information, trade secrets, and business plans of the Company during and after \
                   employment.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.2 ").bold(true);
        p.add_run(
            "All intellectual property, inventions, and works of authorship created by the \
                   Employee during the term of employment and within the scope of duties shall be \
                   the sole and exclusive property of the Company.",
        );
    }

    // ── Article 6: Non-Compete ──
    doc.add_paragraph("Article 6 — Non-Competition")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("6.1 ").bold(true);
        p.add_run("For a period of twelve (12) months following termination, the Employee agrees \
                   not to engage in any business that directly competes with the Company's core \
                   business of AI infrastructure and ML operations services, within the United States.");
    }

    // ── Article 7: General Provisions ──
    doc.add_paragraph("Article 7 — General Provisions")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.1 Governing Law. ").bold(true);
        p.add_run(
            "This Agreement shall be governed by and construed in accordance with the laws of \
                   the State of California.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.2 Entire Agreement. ").bold(true);
        p.add_run(
            "This Agreement constitutes the entire agreement between the Parties and supersedes \
                   all prior negotiations, representations, and agreements.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.3 Amendment. ").bold(true);
        p.add_run(
            "This Agreement may only be amended by a written instrument signed by both Parties.",
        );
    }

    // ── Signature Block ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("IN WITNESS WHEREOF, the Parties have executed this Employment Agreement as of the Effective Date.")
        .space_after(Length::pt(24.0));

    // Signature table
    {
        let mut tbl = doc.add_table(6, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("FOR THE COMPANY:");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("EMPLOYEE:");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");

        tbl.cell(1, 0).unwrap().set_text("");
        tbl.cell(1, 1).unwrap().set_text("");
        tbl.row(1).unwrap().height(Length::pt(40.0));

        tbl.cell(2, 0)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(3, 0)
            .unwrap()
            .set_text("Name: Board Representative");
        tbl.cell(3, 1).unwrap().set_text("Name: Walter White");
        tbl.cell(4, 0)
            .unwrap()
            .set_text("Title: Chair, Board of Directors");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Title: Chief Executive Officer");
        tbl.cell(5, 0).unwrap().set_text("Date: _______________");
        tbl.cell(5, 1).unwrap().set_text("Date: _______________");
    }

    doc
}

pub fn set_columns(&mut self, num: u32, spacing: Length)

Set equal-width column layout.

pub fn set_header_footer_distance(&mut self, header: Length, footer: Length)

Set header and footer distances from page edges.

Examples found in repository

examples/header_banner.rs (line 40)

fn generate_header_banner_doc(path: &Path) {
    let mut doc = Document::new();

    // Page setup with extra top margin for the banner
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::twips(2292), // top — extra tall for header banner
        Length::twips(1440), // right
        Length::twips(1440), // bottom
        Length::twips(1440), // left
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Generate a simple logo image (white text on transparent background)
    let logo_img = create_logo_png(220, 48);

    // ── Dark blue banner ──
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1A3C6E",
            banner_width: 7772400, // full page width in EMU (~8.5")
            banner_height: 969026, // banner height in EMU (~1.06")
            logo_width: 2011680,   // logo display width (~2.2")
            logo_height: 438912,   // logo display height (~0.48")
            logo_x_offset: 295125, // left padding
            logo_y_offset: 265057, // vertical centering
        },
    );

    doc.set_raw_header_with_images(
        banner.clone(),
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );

    // Use a different first page header (same banner, different color)
    doc.set_different_first_page(true);
    let first_page_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "2E75B6", // lighter blue for cover
            banner_width: 7772400,
            banner_height: 969026,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 265057,
        },
    );
    doc.set_raw_header_with_images(
        first_page_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );

    // Footer
    doc.set_footer("Confidential — Internal Use Only");

    // ── Page 1: Cover ──
    doc.add_paragraph("Company Report").style("Heading1");

    doc.add_paragraph(
        "This document demonstrates a custom header banner built with DrawingML \
         group shapes. The banner uses a colored rectangle with a logo image overlaid, \
         positioned at the top of each page.",
    );

    doc.add_paragraph("");

    doc.add_paragraph("How the Header Banner Works")
        .style("Heading2");

    doc.add_paragraph(
        "The header banner is built using set_raw_header_with_images(), which \
         accepts raw XML and a list of (rel_id, image_data, filename) tuples. \
         The XML uses a DrawingML group shape (wpg:wgp) containing:",
    );

    doc.add_bullet_list_item(
        "A wps:wsp rectangle shape with a solid color fill (the background bar)",
        0,
    );
    doc.add_bullet_list_item(
        "A pic:pic image element positioned within the group (the logo)",
        0,
    );
    doc.add_bullet_list_item(
        "The group is wrapped in a wp:anchor element for absolute page positioning",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Customization").style("Heading2");

    doc.add_paragraph(
        "All dimensions are in EMU (English Metric Units) where 914400 EMU = 1 inch. \
         You can customize:",
    );

    doc.add_bullet_list_item("bg_color — any hex color for the rectangle background", 0);
    doc.add_bullet_list_item("banner_width / banner_height — size of the full banner", 0);
    doc.add_bullet_list_item("logo_width / logo_height — display size of the logo", 0);
    doc.add_bullet_list_item(
        "logo_x_offset / logo_y_offset — logo position within the banner",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Different First Page").style("Heading2");

    doc.add_paragraph(
        "This page uses a lighter blue banner (first page header). \
         Subsequent pages use a darker blue banner (default header). \
         Use set_different_first_page(true) to enable this.",
    );

    // ── Page 2 ──
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("Second Page").style("Heading1");

    doc.add_paragraph(
        "This page shows the default header banner (dark blue). The first page \
         had a lighter blue banner because we set a different first-page header.",
    );

    doc.add_paragraph("");

    doc.add_paragraph(
        "The banner repeats on every page because it is placed in the header part. \
         You can have different banners for default, first-page, and even-page headers.",
    );

    doc.set_title("Header Banner Example");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/generate_all_samples.rs (line 108)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

// =============================================================================
// 6. LETTER — Slate blue + silver scheme
// =============================================================================
fn generate_letter(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Slate #4A5568, Blue accent #3182CE
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
    );
    doc.set_title("Business Letter");
    doc.set_author("Walter White");

    // Banner header using raw XML
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "4A5568",
            banner_width: 7772400,
            banner_height: 731520, // ~0.8"
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 146304,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_margins(
        Length::twips(2000),
        Length::twips(1800),
        Length::twips(1440),
        Length::twips(1800),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Footer with contact
    doc.set_footer(
        "Tensorbee | 123 Innovation Drive, Suite 400 | San Francisco, CA 94105 | tensorbee.com",
    );

    // ── Sender Address ──
    doc.add_paragraph("Walter White");
    doc.add_paragraph("Chief Executive Officer");
    doc.add_paragraph("Tensorbee");
    doc.add_paragraph("123 Innovation Drive, Suite 400");
    doc.add_paragraph("San Francisco, CA 94105");
    doc.add_paragraph("");
    doc.add_paragraph("February 22, 2026");

    doc.add_paragraph("");

    // ── Recipient ──
    doc.add_paragraph("Ms. Sarah Chen");
    doc.add_paragraph("VP of Engineering");
    doc.add_paragraph("Meridian Dynamics LLC");
    doc.add_paragraph("456 Enterprise Boulevard");
    doc.add_paragraph("Austin, TX 78701");

    doc.add_paragraph("");

    // ── Subject ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Re: Strategic Technology Partnership — Phase 2 Expansion")
            .bold(true);
    }

    doc.add_paragraph("");

    // ── Body ──
    doc.add_paragraph("Dear Ms. Chen,");
    doc.add_paragraph("");

    doc.add_paragraph(
        "I am writing to express Tensorbee's enthusiasm for expanding our strategic technology \
         partnership with Meridian Dynamics. Following the successful completion of Phase 1, \
         which delivered a 40% improvement in your ML inference pipeline throughput, we believe \
         the foundation is firmly established for an ambitious Phase 2 engagement.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "During our recent executive review, your team highlighted three priority areas for \
         the next phase of collaboration:",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_numbered_list_item(
        "Real-time anomaly detection for your financial transaction monitoring system, \
         targeting sub-100ms latency at 50,000 transactions per second.",
        0,
    );
    doc.add_numbered_list_item(
        "Federated learning infrastructure to enable model training across your distributed \
         data centers without centralizing sensitive financial data.",
        0,
    );
    doc.add_numbered_list_item(
        "MLOps automation to reduce your model deployment cycle from the current 5 days \
         to under 4 hours.",
        0,
    );

    doc.add_paragraph(
        "Our engineering team has prepared a detailed technical proposal addressing each of \
         these areas. We have allocated a dedicated team of eight senior engineers, led by \
         our CTO, to ensure continuity with the Phase 1 team your organization has already \
         built a productive working relationship with.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "I would welcome the opportunity to present our Phase 2 proposal in person. My \
         assistant will reach out to coordinate a meeting at your convenience during the \
         first week of March.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("");

    doc.add_paragraph("Warm regards,");
    doc.add_paragraph("");
    doc.add_paragraph("");

    // Signature line
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "4A5568");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Walter White").bold(true).size(12.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Chief Executive Officer, Tensorbee")
            .italic(true)
            .size(10.0)
            .color("666666");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("walter@tensorbee.com | +1 (415) 555-0199")
            .size(10.0)
            .color("888888");
    }

    doc
}

pub fn set_gutter(&mut self, gutter: Length)

Set the gutter margin.

Examples found in repository

examples/generate_all_samples.rs (line 109)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

pub fn set_different_first_page(&mut self, val: bool)

Enable or disable different first page header/footer.

Examples found in repository

examples/header_banner.rs (line 66)

fn generate_header_banner_doc(path: &Path) {
    let mut doc = Document::new();

    // Page setup with extra top margin for the banner
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::twips(2292), // top — extra tall for header banner
        Length::twips(1440), // right
        Length::twips(1440), // bottom
        Length::twips(1440), // left
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Generate a simple logo image (white text on transparent background)
    let logo_img = create_logo_png(220, 48);

    // ── Dark blue banner ──
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1A3C6E",
            banner_width: 7772400, // full page width in EMU (~8.5")
            banner_height: 969026, // banner height in EMU (~1.06")
            logo_width: 2011680,   // logo display width (~2.2")
            logo_height: 438912,   // logo display height (~0.48")
            logo_x_offset: 295125, // left padding
            logo_y_offset: 265057, // vertical centering
        },
    );

    doc.set_raw_header_with_images(
        banner.clone(),
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );

    // Use a different first page header (same banner, different color)
    doc.set_different_first_page(true);
    let first_page_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "2E75B6", // lighter blue for cover
            banner_width: 7772400,
            banner_height: 969026,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 265057,
        },
    );
    doc.set_raw_header_with_images(
        first_page_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );

    // Footer
    doc.set_footer("Confidential — Internal Use Only");

    // ── Page 1: Cover ──
    doc.add_paragraph("Company Report").style("Heading1");

    doc.add_paragraph(
        "This document demonstrates a custom header banner built with DrawingML \
         group shapes. The banner uses a colored rectangle with a logo image overlaid, \
         positioned at the top of each page.",
    );

    doc.add_paragraph("");

    doc.add_paragraph("How the Header Banner Works")
        .style("Heading2");

    doc.add_paragraph(
        "The header banner is built using set_raw_header_with_images(), which \
         accepts raw XML and a list of (rel_id, image_data, filename) tuples. \
         The XML uses a DrawingML group shape (wpg:wgp) containing:",
    );

    doc.add_bullet_list_item(
        "A wps:wsp rectangle shape with a solid color fill (the background bar)",
        0,
    );
    doc.add_bullet_list_item(
        "A pic:pic image element positioned within the group (the logo)",
        0,
    );
    doc.add_bullet_list_item(
        "The group is wrapped in a wp:anchor element for absolute page positioning",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Customization").style("Heading2");

    doc.add_paragraph(
        "All dimensions are in EMU (English Metric Units) where 914400 EMU = 1 inch. \
         You can customize:",
    );

    doc.add_bullet_list_item("bg_color — any hex color for the rectangle background", 0);
    doc.add_bullet_list_item("banner_width / banner_height — size of the full banner", 0);
    doc.add_bullet_list_item("logo_width / logo_height — display size of the logo", 0);
    doc.add_bullet_list_item(
        "logo_x_offset / logo_y_offset — logo position within the banner",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Different First Page").style("Heading2");

    doc.add_paragraph(
        "This page uses a lighter blue banner (first page header). \
         Subsequent pages use a darker blue banner (default header). \
         Use set_different_first_page(true) to enable this.",
    );

    // ── Page 2 ──
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("Second Page").style("Heading1");

    doc.add_paragraph(
        "This page shows the default header banner (dark blue). The first page \
         had a lighter blue banner because we set a different first-page header.",
    );

    doc.add_paragraph("");

    doc.add_paragraph(
        "The banner repeats on every page because it is placed in the header part. \
         You can have different banners for default, first-page, and even-page headers.",
    );

    doc.set_title("Header Banner Example");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/generate_all_samples.rs (line 116)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

pub fn title(&self) -> Option<&str>

Get the document title.

pub fn set_title(&mut self, title: &str)

Set the document title.

Examples found in repository

examples/generate_pdf.rs (line 20)

fn main() {
    // Test 1: Simple document
    let doc = Document::new();
    match doc.to_pdf() {
        Ok(bytes) => {
            std::fs::write("/tmp/rdocx_simple.pdf", &bytes).unwrap();
            println!("Simple PDF: {} bytes -> /tmp/rdocx_simple.pdf", bytes.len());
        }
        Err(e) => println!("Simple PDF failed: {e}"),
    }

    // Test 2: Document with content
    let mut doc = Document::new();
    doc.set_title("Test PDF Document");
    doc.set_author("rdocx-pdf");
    doc.add_paragraph("Chapter 1: Introduction")
        .style("Heading1");
    doc.add_paragraph(
        "This is a test document generated by rdocx and rendered to PDF. \
         It demonstrates text rendering with proper font shaping and pagination.",
    );
    doc.add_paragraph("Section 1.1").style("Heading2");
    doc.add_paragraph("More content in a sub-section.");

    {
        let mut table = doc.add_table(2, 3);
        for r in 0..2 {
            for c in 0..3 {
                if let Some(mut cell) = table.cell(r, c) {
                    cell.set_text(&format!("R{}C{}", r + 1, c + 1));
                }
            }
        }
    }

    doc.add_paragraph("After the table.");

    match doc.to_pdf() {
        Ok(bytes) => {
            std::fs::write("/tmp/rdocx_content.pdf", &bytes).unwrap();
            println!(
                "Content PDF: {} bytes -> /tmp/rdocx_content.pdf",
                bytes.len()
            );
        }
        Err(e) => println!("Content PDF failed: {e}"),
    }

    // Test 3: From feature_showcase.docx
    let showcase_path = concat!(
        env!("CARGO_MANIFEST_DIR"),
        "/../../samples/feature_showcase.docx"
    );
    match Document::open(showcase_path) {
        Ok(doc) => match doc.to_pdf() {
            Ok(bytes) => {
                std::fs::write("/tmp/rdocx_showcase.pdf", &bytes).unwrap();
                println!(
                    "Showcase PDF: {} bytes -> /tmp/rdocx_showcase.pdf",
                    bytes.len()
                );
            }
            Err(e) => println!("Showcase PDF failed: {e}"),
        },
        Err(e) => println!("Failed to open showcase: {e}"),
    }
}

examples/template_replace.rs (line 155)

fn create_template(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );

    doc.set_header("{{company_name}} — Confidential");
    doc.set_footer("Prepared by {{author_name}} on {{date}}");

    // ── Title ──
    doc.add_paragraph("{{company_name}}")
        .style("Heading1")
        .alignment(Alignment::Center);

    doc.add_paragraph("Project Proposal")
        .alignment(Alignment::Center);

    doc.add_paragraph("");

    // ── Summary section ──
    doc.add_paragraph("Executive Summary").style("Heading2");

    doc.add_paragraph(
        "This proposal outlines the {{project_name}} project for {{company_name}}. \
         The primary contact is {{contact_name}} ({{contact_email}}). \
         The proposed start date is {{start_date}} with an estimated duration of {{duration}}.",
    );

    doc.add_paragraph("");

    // ── Cross-run placeholder (bold label + normal value) ──
    doc.add_paragraph("Key Details").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Project: ").bold(true);
        p.add_run("{{project_name}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Budget: ").bold(true);
        p.add_run("{{budget}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Status: ").bold(true);
        p.add_run("{{status}}");
    }

    doc.add_paragraph("");

    // ── Table with placeholders ──
    doc.add_paragraph("Team Members").style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        // Header row
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Email");

        tbl.cell(1, 0).unwrap().set_text("{{member1_name}}");
        tbl.cell(1, 1).unwrap().set_text("{{member1_role}}");
        tbl.cell(1, 2).unwrap().set_text("{{member1_email}}");

        tbl.cell(2, 0).unwrap().set_text("{{member2_name}}");
        tbl.cell(2, 1).unwrap().set_text("{{member2_role}}");
        tbl.cell(2, 2).unwrap().set_text("{{member2_email}}");

        tbl.cell(3, 0).unwrap().set_text("{{member3_name}}");
        tbl.cell(3, 1).unwrap().set_text("{{member3_role}}");
        tbl.cell(3, 2).unwrap().set_text("{{member3_email}}");
    }

    doc.add_paragraph("");

    // ── Deliverables section ──
    doc.add_paragraph("Deliverables").style("Heading2");

    doc.add_paragraph("INSERTION_POINT");

    doc.add_paragraph("");

    // ── Signature block ──
    doc.add_paragraph("Acceptance").style("Heading2");

    doc.add_paragraph(
        "By signing below, {{company_name}} agrees to the terms outlined in this proposal.",
    );

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer: ___________________");
        tbl.cell(0, 1)
            .unwrap()
            .set_text("Provider: ___________________");
        tbl.cell(1, 0).unwrap().set_text("Date: {{date}}");
        tbl.cell(1, 1).unwrap().set_text("Date: {{date}}");
    }

    doc.set_title("{{company_name}} — Project Proposal Template");
    doc.set_author("Template Generator");

    doc.save(path).unwrap();
}

/// Open the template, replace all placeholders, insert content, and save.
fn fill_template(template_path: &Path, output_path: &Path) {
    let mut doc = Document::open(template_path).unwrap();

    // ── Batch replacement ──
    let mut replacements = HashMap::new();
    replacements.insert("{{company_name}}", "Riverside Medical Center");
    replacements.insert("{{project_name}}", "Network Security Upgrade");
    replacements.insert("{{contact_name}}", "Dr. Sarah Chen");
    replacements.insert("{{contact_email}}", "s.chen@riverside.org");
    replacements.insert("{{start_date}}", "March 1, 2026");
    replacements.insert("{{duration}}", "12 weeks");
    replacements.insert("{{budget}}", "$185,000");
    replacements.insert("{{status}}", "Pending Approval");
    replacements.insert("{{author_name}}", "James Wilson");
    replacements.insert("{{date}}", "February 22, 2026");

    // Team members
    replacements.insert("{{member1_name}}", "James Wilson");
    replacements.insert("{{member1_role}}", "Project Lead");
    replacements.insert("{{member1_email}}", "j.wilson@provider.com");
    replacements.insert("{{member2_name}}", "Maria Garcia");
    replacements.insert("{{member2_role}}", "Security Architect");
    replacements.insert("{{member2_email}}", "m.garcia@provider.com");
    replacements.insert("{{member3_name}}", "David Park");
    replacements.insert("{{member3_role}}", "Network Engineer");
    replacements.insert("{{member3_email}}", "d.park@provider.com");

    let count = doc.replace_all(&replacements);
    println!("  Replaced {} placeholders", count);

    // ── Insert deliverables at the insertion point ──
    if let Some(idx) = doc.find_content_index("INSERTION_POINT") {
        // Remove the placeholder paragraph
        doc.remove_content(idx);

        // Insert deliverables list
        doc.insert_paragraph(idx, "The following deliverables are included:");

        // Insert a deliverables table
        let mut tbl = doc.insert_table(idx + 1, 5, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("E2EFDA");
        }
        tbl.cell(0, 0).unwrap().set_text("Phase");
        tbl.cell(0, 1).unwrap().set_text("Description");
        tbl.cell(0, 2).unwrap().set_text("Timeline");

        tbl.cell(1, 0).unwrap().set_text("1. Discovery");
        tbl.cell(1, 1)
            .unwrap()
            .set_text("Network assessment and asset inventory");
        tbl.cell(1, 2).unwrap().set_text("Weeks 1-3");

        tbl.cell(2, 0).unwrap().set_text("2. Design");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Security architecture and policy design");
        tbl.cell(2, 2).unwrap().set_text("Weeks 4-6");

        tbl.cell(3, 0).unwrap().set_text("3. Implementation");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("Deploy monitoring and access controls");
        tbl.cell(3, 2).unwrap().set_text("Weeks 7-10");

        tbl.cell(4, 0).unwrap().set_text("4. Validation");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Testing, training, and handover");
        tbl.cell(4, 2).unwrap().set_text("Weeks 11-12");

        println!("  Inserted deliverables table at position {}", idx);
    }

    // ── Update metadata ──
    doc.set_title("Riverside Medical Center — Network Security Upgrade Proposal");
    doc.set_author("James Wilson");
    doc.set_subject("Project Proposal");
    doc.set_keywords("security, network, medical, proposal");

    doc.save(output_path).unwrap();
}

examples/header_banner.rs (line 165)

fn generate_header_banner_doc(path: &Path) {
    let mut doc = Document::new();

    // Page setup with extra top margin for the banner
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::twips(2292), // top — extra tall for header banner
        Length::twips(1440), // right
        Length::twips(1440), // bottom
        Length::twips(1440), // left
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Generate a simple logo image (white text on transparent background)
    let logo_img = create_logo_png(220, 48);

    // ── Dark blue banner ──
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1A3C6E",
            banner_width: 7772400, // full page width in EMU (~8.5")
            banner_height: 969026, // banner height in EMU (~1.06")
            logo_width: 2011680,   // logo display width (~2.2")
            logo_height: 438912,   // logo display height (~0.48")
            logo_x_offset: 295125, // left padding
            logo_y_offset: 265057, // vertical centering
        },
    );

    doc.set_raw_header_with_images(
        banner.clone(),
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );

    // Use a different first page header (same banner, different color)
    doc.set_different_first_page(true);
    let first_page_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "2E75B6", // lighter blue for cover
            banner_width: 7772400,
            banner_height: 969026,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 265057,
        },
    );
    doc.set_raw_header_with_images(
        first_page_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );

    // Footer
    doc.set_footer("Confidential — Internal Use Only");

    // ── Page 1: Cover ──
    doc.add_paragraph("Company Report").style("Heading1");

    doc.add_paragraph(
        "This document demonstrates a custom header banner built with DrawingML \
         group shapes. The banner uses a colored rectangle with a logo image overlaid, \
         positioned at the top of each page.",
    );

    doc.add_paragraph("");

    doc.add_paragraph("How the Header Banner Works")
        .style("Heading2");

    doc.add_paragraph(
        "The header banner is built using set_raw_header_with_images(), which \
         accepts raw XML and a list of (rel_id, image_data, filename) tuples. \
         The XML uses a DrawingML group shape (wpg:wgp) containing:",
    );

    doc.add_bullet_list_item(
        "A wps:wsp rectangle shape with a solid color fill (the background bar)",
        0,
    );
    doc.add_bullet_list_item(
        "A pic:pic image element positioned within the group (the logo)",
        0,
    );
    doc.add_bullet_list_item(
        "The group is wrapped in a wp:anchor element for absolute page positioning",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Customization").style("Heading2");

    doc.add_paragraph(
        "All dimensions are in EMU (English Metric Units) where 914400 EMU = 1 inch. \
         You can customize:",
    );

    doc.add_bullet_list_item("bg_color — any hex color for the rectangle background", 0);
    doc.add_bullet_list_item("banner_width / banner_height — size of the full banner", 0);
    doc.add_bullet_list_item("logo_width / logo_height — display size of the logo", 0);
    doc.add_bullet_list_item(
        "logo_x_offset / logo_y_offset — logo position within the banner",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Different First Page").style("Heading2");

    doc.add_paragraph(
        "This page uses a lighter blue banner (first page header). \
         Subsequent pages use a darker blue banner (default header). \
         Use set_different_first_page(true) to enable this.",
    );

    // ── Page 2 ──
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("Second Page").style("Heading1");

    doc.add_paragraph(
        "This page shows the default header banner (dark blue). The first page \
         had a lighter blue banner because we set a different first-page header.",
    );

    doc.add_paragraph("");

    doc.add_paragraph(
        "The banner repeats on every page because it is placed in the header part. \
         You can have different banners for default, first-page, and even-page headers.",
    );

    doc.set_title("Header Banner Example");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/styled_tables.rs (line 445)

fn generate_styled_tables(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );

    doc.add_paragraph("Styled Tables Showcase")
        .style("Heading1");

    doc.add_paragraph("");

    // =========================================================================
    // 1. Professional report table with alternating rows
    // =========================================================================
    doc.add_paragraph("1. Report Table with Alternating Row Colors")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 4);
        tbl = tbl.borders(BorderStyle::Single, 2, "BFBFBF");
        tbl = tbl.width_pct(100.0);

        // Header row
        let headers = ["Product", "Q1 Sales", "Q2 Sales", "Growth"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().shading("2E75B6");
            tbl.cell(0, col).unwrap().set_text(h);
        }
        tbl.row(0).unwrap().header();

        // Data with alternating shading
        let data = [
            ["Enterprise Suite", "$245,000", "$312,000", "+27.3%"],
            ["Professional", "$189,000", "$201,000", "+6.3%"],
            ["Starter Pack", "$67,000", "$84,500", "+26.1%"],
            ["Add-ons", "$34,000", "$41,200", "+21.2%"],
            ["Training", "$22,000", "$28,900", "+31.4%"],
            ["Support Plans", "$56,000", "$62,300", "+11.3%"],
        ];

        for (i, row) in data.iter().enumerate() {
            let row_idx = i + 1;
            for (col, val) in row.iter().enumerate() {
                tbl.cell(row_idx, col).unwrap().set_text(val);
                // Alternate row colors
                if i % 2 == 0 {
                    tbl.cell(row_idx, col).unwrap().shading("F2F7FB");
                }
            }
        }

        // Total row
        tbl.cell(7, 0).unwrap().set_text("TOTAL");
        tbl.cell(7, 0).unwrap().shading("D6E4F0");
        tbl.cell(7, 1).unwrap().set_text("$613,000");
        tbl.cell(7, 1).unwrap().shading("D6E4F0");
        tbl.cell(7, 2).unwrap().set_text("$729,900");
        tbl.cell(7, 2).unwrap().shading("D6E4F0");
        tbl.cell(7, 3).unwrap().set_text("+19.1%");
        tbl.cell(7, 3).unwrap().shading("D6E4F0");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 2. Invoice-style table with merged header
    // =========================================================================
    doc.add_paragraph("2. Invoice Table with Merged Header & Row Spans")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(7, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Merged title row
        tbl.cell(0, 0).unwrap().set_text("INVOICE #2026-0042");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("1F4E79");

        // Column headers
        let headers = ["Item", "Description", "Qty", "Amount"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(1, col).unwrap().set_text(h);
            tbl.cell(1, col).unwrap().shading("D6E4F0");
        }

        // Line items
        tbl.cell(2, 0).unwrap().set_text("LIC-ENT-500");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Enterprise License (500 seats)");
        tbl.cell(2, 2).unwrap().set_text("1");
        tbl.cell(2, 3).unwrap().set_text("$60,000");

        tbl.cell(3, 0).unwrap().set_text("SVC-IMPL");
        tbl.cell(3, 1).unwrap().set_text("Implementation Services");
        tbl.cell(3, 2).unwrap().set_text("1");
        tbl.cell(3, 3).unwrap().set_text("$25,000");

        tbl.cell(4, 0).unwrap().set_text("SVC-TRAIN");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("On-site Training (3 days)");
        tbl.cell(4, 2).unwrap().set_text("1");
        tbl.cell(4, 3).unwrap().set_text("$4,500");

        // Subtotal
        tbl.cell(5, 0).unwrap().set_text("Subtotal");
        tbl.cell(5, 0).unwrap().grid_span(3);
        tbl.cell(5, 0).unwrap().shading("F2F2F2");
        tbl.cell(5, 3).unwrap().set_text("$89,500");
        tbl.cell(5, 3).unwrap().shading("F2F2F2");

        // Total
        tbl.cell(6, 0).unwrap().set_text("TOTAL DUE");
        tbl.cell(6, 0).unwrap().grid_span(3);
        tbl.cell(6, 0).unwrap().shading("1F4E79");
        tbl.cell(6, 3).unwrap().set_text("$89,500");
        tbl.cell(6, 3).unwrap().shading("1F4E79");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 3. Specification table with vertical merge
    // =========================================================================
    doc.add_paragraph("3. Specification Table with Vertical Merges")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Specification");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Value");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        // "Hardware" spans 3 rows
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 0).unwrap().shading("E2EFDA");
        tbl.cell(1, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(1, 1).unwrap().set_text("Processor");
        tbl.cell(1, 2).unwrap().set_text("Intel Xeon E-2388G");

        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Memory");
        tbl.cell(2, 2).unwrap().set_text("64 GB DDR4 ECC");

        tbl.cell(3, 0).unwrap().v_merge_continue();
        tbl.cell(3, 1).unwrap().set_text("Storage");
        tbl.cell(3, 2).unwrap().set_text("2x 1TB NVMe SSD (RAID 1)");

        // "Network" spans 2 rows
        tbl.cell(4, 0).unwrap().set_text("Network");
        tbl.cell(4, 0).unwrap().v_merge_restart();
        tbl.cell(4, 0).unwrap().shading("FCE4D6");
        tbl.cell(4, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(4, 1).unwrap().set_text("Ethernet");
        tbl.cell(4, 2).unwrap().set_text("4x 10GbE SFP+");

        tbl.cell(5, 0).unwrap().v_merge_continue();
        tbl.cell(5, 1).unwrap().set_text("Management");
        tbl.cell(5, 2).unwrap().set_text("1x 1GbE IPMI");

        // "Software" spans 2 rows
        tbl.cell(6, 0).unwrap().set_text("Software");
        tbl.cell(6, 0).unwrap().v_merge_restart();
        tbl.cell(6, 0).unwrap().shading("D6E4F0");
        tbl.cell(6, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(6, 1).unwrap().set_text("Operating System");
        tbl.cell(6, 2).unwrap().set_text("Ubuntu 24.04 LTS");

        tbl.cell(7, 0).unwrap().v_merge_continue();
        tbl.cell(7, 1).unwrap().set_text("Monitoring");
        tbl.cell(7, 2).unwrap().set_text("Prometheus + Grafana");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 4. Nested table (table inside a cell)
    // =========================================================================
    doc.add_paragraph("4. Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");
        tbl = tbl.width_pct(100.0);
        tbl = tbl.cell_margins(
            Length::twips(72),
            Length::twips(108),
            Length::twips(72),
            Length::twips(108),
        );

        tbl.cell(0, 0).unwrap().set_text("Project Alpha");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Project Beta");
        tbl.cell(0, 1).unwrap().shading("2E75B6");

        // Nested table in cell (1,0)
        {
            let mut cell = tbl.cell(1, 0).unwrap();
            cell.set_text("Milestones:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "70AD47");
            inner.cell(0, 0).unwrap().set_text("Phase");
            inner.cell(0, 0).unwrap().shading("E2EFDA");
            inner.cell(0, 1).unwrap().set_text("Status");
            inner.cell(0, 1).unwrap().shading("E2EFDA");
            inner.cell(1, 0).unwrap().set_text("Design");
            inner.cell(1, 1).unwrap().set_text("Complete");
            inner.cell(2, 0).unwrap().set_text("Build");
            inner.cell(2, 1).unwrap().set_text("In Progress");
        }

        // Nested table in cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Budget:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "ED7D31");
            inner.cell(0, 0).unwrap().set_text("Category");
            inner.cell(0, 0).unwrap().shading("FCE4D6");
            inner.cell(0, 1).unwrap().set_text("Amount");
            inner.cell(0, 1).unwrap().shading("FCE4D6");
            inner.cell(1, 0).unwrap().set_text("Development");
            inner.cell(1, 1).unwrap().set_text("$120,000");
            inner.cell(2, 0).unwrap().set_text("Testing");
            inner.cell(2, 1).unwrap().set_text("$35,000");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 5. Form-style table with labels
    // =========================================================================
    doc.add_paragraph("5. Form-Style Table").style("Heading2");

    {
        let mut tbl = doc.add_table(6, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "808080");
        tbl = tbl.width_pct(100.0);

        // Row 0: Full-width title
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer Registration Form");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("404040");

        // Row 1: Name fields
        tbl.cell(1, 0).unwrap().set_text("First Name");
        tbl.cell(1, 0).unwrap().shading("E8E8E8");
        tbl.cell(1, 1).unwrap().set_text("John");
        tbl.cell(1, 2).unwrap().set_text("Last Name");
        tbl.cell(1, 2).unwrap().shading("E8E8E8");
        tbl.cell(1, 3).unwrap().set_text("Smith");

        // Row 2: Contact
        tbl.cell(2, 0).unwrap().set_text("Email");
        tbl.cell(2, 0).unwrap().shading("E8E8E8");
        tbl.cell(2, 1).unwrap().set_text("john.smith@example.com");
        tbl.cell(2, 1).unwrap().grid_span(3);

        // Row 3: Phone
        tbl.cell(3, 0).unwrap().set_text("Phone");
        tbl.cell(3, 0).unwrap().shading("E8E8E8");
        tbl.cell(3, 1).unwrap().set_text("+1 (555) 123-4567");
        tbl.cell(3, 2).unwrap().set_text("Company");
        tbl.cell(3, 2).unwrap().shading("E8E8E8");
        tbl.cell(3, 3).unwrap().set_text("Acme Corp");

        // Row 4: Address (spanning)
        tbl.cell(4, 0).unwrap().set_text("Address");
        tbl.cell(4, 0).unwrap().shading("E8E8E8");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("123 Business Ave, Suite 400, Portland, OR 97201");
        tbl.cell(4, 1).unwrap().grid_span(3);

        // Row 5: Notes
        tbl.cell(5, 0).unwrap().set_text("Notes");
        tbl.cell(5, 0).unwrap().shading("E8E8E8");
        tbl.cell(5, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top);
        {
            let mut cell = tbl.cell(5, 1).unwrap().grid_span(3);
            cell.set_text("Premium customer since 2020. Preferred contact method: email.");
            cell.add_paragraph("Annual review scheduled for March 2026.");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 6. Comparison table with border styles
    // =========================================================================
    doc.add_paragraph("6. Comparison Table with Custom Borders")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(5, 3);
        tbl = tbl.borders(BorderStyle::Double, 4, "2E75B6");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Feature");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Basic Plan");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Enterprise Plan");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        tbl.cell(1, 0).unwrap().set_text("Users");
        tbl.cell(1, 1).unwrap().set_text("Up to 10");
        tbl.cell(1, 2).unwrap().set_text("Unlimited");
        tbl.cell(1, 2).unwrap().shading("E2EFDA");

        tbl.cell(2, 0).unwrap().set_text("Storage");
        tbl.cell(2, 1).unwrap().set_text("50 GB");
        tbl.cell(2, 2).unwrap().set_text("5 TB");
        tbl.cell(2, 2).unwrap().shading("E2EFDA");

        tbl.cell(3, 0).unwrap().set_text("Support");
        tbl.cell(3, 1).unwrap().set_text("Email only");
        tbl.cell(3, 2).unwrap().set_text("24/7 Phone + Email");
        tbl.cell(3, 2).unwrap().shading("E2EFDA");

        tbl.cell(4, 0).unwrap().set_text("Price");
        tbl.cell(4, 0).unwrap().shading("F2F2F2");
        tbl.cell(4, 1).unwrap().set_text("$29/month");
        tbl.cell(4, 1).unwrap().shading("F2F2F2");
        tbl.cell(4, 2).unwrap().set_text("$199/month");
        tbl.cell(4, 2).unwrap().shading("C6EFCE");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 7. Wide table with fixed layout and row height
    // =========================================================================
    doc.add_paragraph("7. Fixed Layout Table with Row Height Control")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 5);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width(Length::inches(7.0));
        tbl = tbl.layout_fixed();

        // Set column widths
        for col in 0..5 {
            tbl.cell(0, col).unwrap().width(Length::inches(1.4));
        }

        // Header with exact height
        tbl.row(0).unwrap().height_exact(Length::twips(480));
        tbl.row(0).unwrap().header();
        tbl.row(0).unwrap().cant_split();

        let headers = ["Mon", "Tue", "Wed", "Thu", "Fri"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("404040");
            tbl.cell(0, col)
                .unwrap()
                .vertical_alignment(VerticalAlignment::Center);
        }

        // Schedule rows with minimum height
        tbl.row(1).unwrap().height(Length::twips(600));
        tbl.cell(1, 0).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 1).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 2).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 3).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 4).unwrap().set_text("9:00 Standup");

        tbl.row(2).unwrap().height(Length::twips(600));
        tbl.cell(2, 0).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 0).unwrap().shading("D6E4F0");
        tbl.cell(2, 1).unwrap().set_text("10:00 Design Review");
        tbl.cell(2, 1).unwrap().shading("FCE4D6");
        tbl.cell(2, 2).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 2).unwrap().shading("D6E4F0");
        tbl.cell(2, 3).unwrap().set_text("10:00 Sprint Planning");
        tbl.cell(2, 3).unwrap().shading("E2EFDA");
        tbl.cell(2, 4).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 4).unwrap().shading("D6E4F0");

        tbl.row(3).unwrap().height(Length::twips(600));
        tbl.cell(3, 0).unwrap().set_text("14:00 Code Review");
        tbl.cell(3, 1).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 1).unwrap().shading("D6E4F0");
        tbl.cell(3, 2).unwrap().set_text("14:00 Demo");
        tbl.cell(3, 2).unwrap().shading("FCE4D6");
        tbl.cell(3, 3).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 3).unwrap().shading("D6E4F0");
        tbl.cell(3, 4).unwrap().set_text("14:00 Retro");
        tbl.cell(3, 4).unwrap().shading("E2EFDA");
    }

    doc.set_title("Styled Tables Showcase");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/generate_all_samples.rs (line 110)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

// =============================================================================
// 6. LETTER — Slate blue + silver scheme
// =============================================================================
fn generate_letter(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Slate #4A5568, Blue accent #3182CE
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
    );
    doc.set_title("Business Letter");
    doc.set_author("Walter White");

    // Banner header using raw XML
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "4A5568",
            banner_width: 7772400,
            banner_height: 731520, // ~0.8"
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 146304,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_margins(
        Length::twips(2000),
        Length::twips(1800),
        Length::twips(1440),
        Length::twips(1800),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Footer with contact
    doc.set_footer(
        "Tensorbee | 123 Innovation Drive, Suite 400 | San Francisco, CA 94105 | tensorbee.com",
    );

    // ── Sender Address ──
    doc.add_paragraph("Walter White");
    doc.add_paragraph("Chief Executive Officer");
    doc.add_paragraph("Tensorbee");
    doc.add_paragraph("123 Innovation Drive, Suite 400");
    doc.add_paragraph("San Francisco, CA 94105");
    doc.add_paragraph("");
    doc.add_paragraph("February 22, 2026");

    doc.add_paragraph("");

    // ── Recipient ──
    doc.add_paragraph("Ms. Sarah Chen");
    doc.add_paragraph("VP of Engineering");
    doc.add_paragraph("Meridian Dynamics LLC");
    doc.add_paragraph("456 Enterprise Boulevard");
    doc.add_paragraph("Austin, TX 78701");

    doc.add_paragraph("");

    // ── Subject ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Re: Strategic Technology Partnership — Phase 2 Expansion")
            .bold(true);
    }

    doc.add_paragraph("");

    // ── Body ──
    doc.add_paragraph("Dear Ms. Chen,");
    doc.add_paragraph("");

    doc.add_paragraph(
        "I am writing to express Tensorbee's enthusiasm for expanding our strategic technology \
         partnership with Meridian Dynamics. Following the successful completion of Phase 1, \
         which delivered a 40% improvement in your ML inference pipeline throughput, we believe \
         the foundation is firmly established for an ambitious Phase 2 engagement.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "During our recent executive review, your team highlighted three priority areas for \
         the next phase of collaboration:",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_numbered_list_item(
        "Real-time anomaly detection for your financial transaction monitoring system, \
         targeting sub-100ms latency at 50,000 transactions per second.",
        0,
    );
    doc.add_numbered_list_item(
        "Federated learning infrastructure to enable model training across your distributed \
         data centers without centralizing sensitive financial data.",
        0,
    );
    doc.add_numbered_list_item(
        "MLOps automation to reduce your model deployment cycle from the current 5 days \
         to under 4 hours.",
        0,
    );

    doc.add_paragraph(
        "Our engineering team has prepared a detailed technical proposal addressing each of \
         these areas. We have allocated a dedicated team of eight senior engineers, led by \
         our CTO, to ensure continuity with the Phase 1 team your organization has already \
         built a productive working relationship with.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "I would welcome the opportunity to present our Phase 2 proposal in person. My \
         assistant will reach out to coordinate a meeting at your convenience during the \
         first week of March.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("");

    doc.add_paragraph("Warm regards,");
    doc.add_paragraph("");
    doc.add_paragraph("");

    // Signature line
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "4A5568");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Walter White").bold(true).size(12.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Chief Executive Officer, Tensorbee")
            .italic(true)
            .size(10.0)
            .color("666666");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("walter@tensorbee.com | +1 (415) 555-0199")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 7. EMPLOYMENT CONTRACT — Purple + charcoal scheme
// =============================================================================
fn generate_contract(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Purple #5B2C6F, Plum #8E44AD, Gray #2C3E50
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Employment Agreement");
    doc.set_author("Tensorbee HR Department");
    doc.set_subject("Employment Contract — Walter White");
    doc.set_keywords("employment, contract, agreement, Tensorbee");

    doc.set_header("TENSORBEE — Employment Agreement");
    doc.set_footer("Employment Agreement — Walter White — Page");

    // ── Title Block ──
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("EMPLOYMENT AGREEMENT")
            .bold(true)
            .size(24.0)
            .color("5B2C6F")
            .font("Georgia");
    }
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    doc.add_paragraph("");

    // ── Parties ──
    doc.add_paragraph(
        "This Employment Agreement (\"Agreement\") is entered into as of February 22, 2026 \
         (\"Effective Date\"), by and between:",
    );

    doc.add_paragraph("");

    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYER: ").bold(true);
        p.add_run(
            "Tensorbee, Inc., a Delaware corporation with its principal place of business at \
                   123 Innovation Drive, Suite 400, San Francisco, CA 94105 (\"Company\")",
        );
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYEE: ").bold(true);
        p.add_run(
            "Walter White, residing at 308 Negra Arroyo Lane, Albuquerque, NM 87104 (\"Employee\")",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph("The Company and Employee are collectively referred to as the \"Parties.\"");
    doc.add_paragraph("");

    // ── Article 1: Position and Duties ──
    doc.add_paragraph("Article 1 — Position and Duties")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.1 ").bold(true);
        p.add_run("The Company hereby employs the Employee as ");
        p.add_run("Chief Executive Officer (CEO)")
            .bold(true)
            .italic(true);
        p.add_run(", reporting directly to the Board of Directors.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.2 ").bold(true);
        p.add_run("The Employee shall devote full working time, attention, and best efforts to \
                   the performance of duties as reasonably assigned by the Board, including but not limited to:");
    }
    doc.add_bullet_list_item(
        "Setting and executing the Company's strategic vision and business plan",
        0,
    );
    doc.add_bullet_list_item(
        "Overseeing all operations, engineering, and commercial activities",
        0,
    );
    doc.add_bullet_list_item(
        "Representing the Company to investors, customers, and the public",
        0,
    );
    doc.add_bullet_list_item("Recruiting, developing, and retaining key talent", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.3 ").bold(true);
        p.add_run(
            "The Employee's primary work location shall be the Company's San Francisco \
                   headquarters, with reasonable travel as required by business needs.",
        );
    }

    // ── Article 2: Compensation ──
    doc.add_paragraph("Article 2 — Compensation and Benefits")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.1 Base Salary. ").bold(true);
        p.add_run("The Company shall pay the Employee an annual base salary of ");
        p.add_run("$375,000.00").bold(true);
        p.add_run(" (Three Hundred Seventy-Five Thousand Dollars), payable in accordance with the \
                   Company's standard payroll schedule, less applicable withholdings and deductions.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.2 Annual Bonus. ").bold(true);
        p.add_run("The Employee shall be eligible for an annual performance bonus of up to ");
        p.add_run("40%").bold(true);
        p.add_run(
            " of base salary, based on achievement of mutually agreed performance objectives.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.3 Equity. ").bold(true);
        p.add_run("Subject to Board approval, the Employee shall receive a stock option grant of ");
        p.add_run("500,000 shares").bold(true);
        p.add_run(
            " of the Company's common stock, vesting over four (4) years with a one-year cliff, \
                   at an exercise price equal to the fair market value on the date of grant.",
        );
    }

    // Compensation summary table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "5B2C6F")
            .width_pct(70.0)
            .alignment(Alignment::Center);
        tbl.cell(0, 0).unwrap().set_text("Compensation Element");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");
        let items = [
            ("Base Salary", "$375,000/year"),
            ("Target Bonus", "Up to 40% ($150,000)"),
            ("Equity Grant", "500,000 shares (4yr vest)"),
            ("Total Target Comp", "$525,000 + equity"),
        ];
        for (i, (elem, val)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(elem);
            tbl.cell(i + 1, 1).unwrap().set_text(val);
            if i == 3 {
                tbl.cell(i + 1, 0).unwrap().shading("E8DAEF");
                tbl.cell(i + 1, 1).unwrap().shading("E8DAEF");
            }
        }
    }

    // ── Article 3: Benefits ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Article 3 — Benefits").style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.1 ").bold(true);
        p.add_run(
            "The Employee shall be entitled to participate in all benefit programs \
                   generally available to senior executives, including:",
        );
    }
    doc.add_bullet_list_item(
        "Medical, dental, and vision insurance (100% premium coverage for employee and dependents)",
        0,
    );
    doc.add_bullet_list_item("401(k) retirement plan with 6% company match", 0);
    doc.add_bullet_list_item("Life insurance and long-term disability coverage", 0);
    doc.add_bullet_list_item("Annual professional development allowance of $10,000", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.2 Paid Time Off. ").bold(true);
        p.add_run(
            "The Employee shall receive 25 days of paid vacation per year, plus Company holidays, \
                   accruing on a monthly basis.",
        );
    }

    // ── Article 4: Term and Termination ──
    doc.add_paragraph("Article 4 — Term and Termination")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.1 At-Will Employment. ").bold(true);
        p.add_run(
            "This Agreement is for at-will employment and may be terminated by either Party \
                   at any time, with or without cause, subject to the notice provisions herein.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.2 Notice Period. ").bold(true);
        p.add_run("Either Party shall provide ");
        p.add_run("ninety (90) days").bold(true);
        p.add_run(" written notice of termination, or pay in lieu thereof.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.3 Severance. ").bold(true);
        p.add_run("In the event of termination by the Company without Cause, the Employee shall \
                   receive (a) twelve (12) months of base salary continuation, (b) pro-rata bonus \
                   for the year of termination, and (c) twelve (12) months of COBRA premium coverage.");
    }

    // ── Article 5: Confidentiality ──
    doc.add_paragraph("Article 5 — Confidentiality and IP")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.1 ").bold(true);
        p.add_run(
            "The Employee agrees to maintain strict confidentiality of all proprietary \
                   information, trade secrets, and business plans of the Company during and after \
                   employment.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.2 ").bold(true);
        p.add_run(
            "All intellectual property, inventions, and works of authorship created by the \
                   Employee during the term of employment and within the scope of duties shall be \
                   the sole and exclusive property of the Company.",
        );
    }

    // ── Article 6: Non-Compete ──
    doc.add_paragraph("Article 6 — Non-Competition")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("6.1 ").bold(true);
        p.add_run("For a period of twelve (12) months following termination, the Employee agrees \
                   not to engage in any business that directly competes with the Company's core \
                   business of AI infrastructure and ML operations services, within the United States.");
    }

    // ── Article 7: General Provisions ──
    doc.add_paragraph("Article 7 — General Provisions")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.1 Governing Law. ").bold(true);
        p.add_run(
            "This Agreement shall be governed by and construed in accordance with the laws of \
                   the State of California.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.2 Entire Agreement. ").bold(true);
        p.add_run(
            "This Agreement constitutes the entire agreement between the Parties and supersedes \
                   all prior negotiations, representations, and agreements.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.3 Amendment. ").bold(true);
        p.add_run(
            "This Agreement may only be amended by a written instrument signed by both Parties.",
        );
    }

    // ── Signature Block ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("IN WITNESS WHEREOF, the Parties have executed this Employment Agreement as of the Effective Date.")
        .space_after(Length::pt(24.0));

    // Signature table
    {
        let mut tbl = doc.add_table(6, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("FOR THE COMPANY:");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("EMPLOYEE:");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");

        tbl.cell(1, 0).unwrap().set_text("");
        tbl.cell(1, 1).unwrap().set_text("");
        tbl.row(1).unwrap().height(Length::pt(40.0));

        tbl.cell(2, 0)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(3, 0)
            .unwrap()
            .set_text("Name: Board Representative");
        tbl.cell(3, 1).unwrap().set_text("Name: Walter White");
        tbl.cell(4, 0)
            .unwrap()
            .set_text("Title: Chair, Board of Directors");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Title: Chief Executive Officer");
        tbl.cell(5, 0).unwrap().set_text("Date: _______________");
        tbl.cell(5, 1).unwrap().set_text("Date: _______________");
    }

    doc
}

pub fn author(&self) -> Option<&str>

Get the document author/creator.

pub fn set_author(&mut self, author: &str)

Set the document author/creator.

Examples found in repository

examples/generate_pdf.rs (line 21)

fn main() {
    // Test 1: Simple document
    let doc = Document::new();
    match doc.to_pdf() {
        Ok(bytes) => {
            std::fs::write("/tmp/rdocx_simple.pdf", &bytes).unwrap();
            println!("Simple PDF: {} bytes -> /tmp/rdocx_simple.pdf", bytes.len());
        }
        Err(e) => println!("Simple PDF failed: {e}"),
    }

    // Test 2: Document with content
    let mut doc = Document::new();
    doc.set_title("Test PDF Document");
    doc.set_author("rdocx-pdf");
    doc.add_paragraph("Chapter 1: Introduction")
        .style("Heading1");
    doc.add_paragraph(
        "This is a test document generated by rdocx and rendered to PDF. \
         It demonstrates text rendering with proper font shaping and pagination.",
    );
    doc.add_paragraph("Section 1.1").style("Heading2");
    doc.add_paragraph("More content in a sub-section.");

    {
        let mut table = doc.add_table(2, 3);
        for r in 0..2 {
            for c in 0..3 {
                if let Some(mut cell) = table.cell(r, c) {
                    cell.set_text(&format!("R{}C{}", r + 1, c + 1));
                }
            }
        }
    }

    doc.add_paragraph("After the table.");

    match doc.to_pdf() {
        Ok(bytes) => {
            std::fs::write("/tmp/rdocx_content.pdf", &bytes).unwrap();
            println!(
                "Content PDF: {} bytes -> /tmp/rdocx_content.pdf",
                bytes.len()
            );
        }
        Err(e) => println!("Content PDF failed: {e}"),
    }

    // Test 3: From feature_showcase.docx
    let showcase_path = concat!(
        env!("CARGO_MANIFEST_DIR"),
        "/../../samples/feature_showcase.docx"
    );
    match Document::open(showcase_path) {
        Ok(doc) => match doc.to_pdf() {
            Ok(bytes) => {
                std::fs::write("/tmp/rdocx_showcase.pdf", &bytes).unwrap();
                println!(
                    "Showcase PDF: {} bytes -> /tmp/rdocx_showcase.pdf",
                    bytes.len()
                );
            }
            Err(e) => println!("Showcase PDF failed: {e}"),
        },
        Err(e) => println!("Failed to open showcase: {e}"),
    }
}

examples/template_replace.rs (line 156)

fn create_template(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );

    doc.set_header("{{company_name}} — Confidential");
    doc.set_footer("Prepared by {{author_name}} on {{date}}");

    // ── Title ──
    doc.add_paragraph("{{company_name}}")
        .style("Heading1")
        .alignment(Alignment::Center);

    doc.add_paragraph("Project Proposal")
        .alignment(Alignment::Center);

    doc.add_paragraph("");

    // ── Summary section ──
    doc.add_paragraph("Executive Summary").style("Heading2");

    doc.add_paragraph(
        "This proposal outlines the {{project_name}} project for {{company_name}}. \
         The primary contact is {{contact_name}} ({{contact_email}}). \
         The proposed start date is {{start_date}} with an estimated duration of {{duration}}.",
    );

    doc.add_paragraph("");

    // ── Cross-run placeholder (bold label + normal value) ──
    doc.add_paragraph("Key Details").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Project: ").bold(true);
        p.add_run("{{project_name}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Budget: ").bold(true);
        p.add_run("{{budget}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Status: ").bold(true);
        p.add_run("{{status}}");
    }

    doc.add_paragraph("");

    // ── Table with placeholders ──
    doc.add_paragraph("Team Members").style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        // Header row
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Email");

        tbl.cell(1, 0).unwrap().set_text("{{member1_name}}");
        tbl.cell(1, 1).unwrap().set_text("{{member1_role}}");
        tbl.cell(1, 2).unwrap().set_text("{{member1_email}}");

        tbl.cell(2, 0).unwrap().set_text("{{member2_name}}");
        tbl.cell(2, 1).unwrap().set_text("{{member2_role}}");
        tbl.cell(2, 2).unwrap().set_text("{{member2_email}}");

        tbl.cell(3, 0).unwrap().set_text("{{member3_name}}");
        tbl.cell(3, 1).unwrap().set_text("{{member3_role}}");
        tbl.cell(3, 2).unwrap().set_text("{{member3_email}}");
    }

    doc.add_paragraph("");

    // ── Deliverables section ──
    doc.add_paragraph("Deliverables").style("Heading2");

    doc.add_paragraph("INSERTION_POINT");

    doc.add_paragraph("");

    // ── Signature block ──
    doc.add_paragraph("Acceptance").style("Heading2");

    doc.add_paragraph(
        "By signing below, {{company_name}} agrees to the terms outlined in this proposal.",
    );

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer: ___________________");
        tbl.cell(0, 1)
            .unwrap()
            .set_text("Provider: ___________________");
        tbl.cell(1, 0).unwrap().set_text("Date: {{date}}");
        tbl.cell(1, 1).unwrap().set_text("Date: {{date}}");
    }

    doc.set_title("{{company_name}} — Project Proposal Template");
    doc.set_author("Template Generator");

    doc.save(path).unwrap();
}

/// Open the template, replace all placeholders, insert content, and save.
fn fill_template(template_path: &Path, output_path: &Path) {
    let mut doc = Document::open(template_path).unwrap();

    // ── Batch replacement ──
    let mut replacements = HashMap::new();
    replacements.insert("{{company_name}}", "Riverside Medical Center");
    replacements.insert("{{project_name}}", "Network Security Upgrade");
    replacements.insert("{{contact_name}}", "Dr. Sarah Chen");
    replacements.insert("{{contact_email}}", "s.chen@riverside.org");
    replacements.insert("{{start_date}}", "March 1, 2026");
    replacements.insert("{{duration}}", "12 weeks");
    replacements.insert("{{budget}}", "$185,000");
    replacements.insert("{{status}}", "Pending Approval");
    replacements.insert("{{author_name}}", "James Wilson");
    replacements.insert("{{date}}", "February 22, 2026");

    // Team members
    replacements.insert("{{member1_name}}", "James Wilson");
    replacements.insert("{{member1_role}}", "Project Lead");
    replacements.insert("{{member1_email}}", "j.wilson@provider.com");
    replacements.insert("{{member2_name}}", "Maria Garcia");
    replacements.insert("{{member2_role}}", "Security Architect");
    replacements.insert("{{member2_email}}", "m.garcia@provider.com");
    replacements.insert("{{member3_name}}", "David Park");
    replacements.insert("{{member3_role}}", "Network Engineer");
    replacements.insert("{{member3_email}}", "d.park@provider.com");

    let count = doc.replace_all(&replacements);
    println!("  Replaced {} placeholders", count);

    // ── Insert deliverables at the insertion point ──
    if let Some(idx) = doc.find_content_index("INSERTION_POINT") {
        // Remove the placeholder paragraph
        doc.remove_content(idx);

        // Insert deliverables list
        doc.insert_paragraph(idx, "The following deliverables are included:");

        // Insert a deliverables table
        let mut tbl = doc.insert_table(idx + 1, 5, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("E2EFDA");
        }
        tbl.cell(0, 0).unwrap().set_text("Phase");
        tbl.cell(0, 1).unwrap().set_text("Description");
        tbl.cell(0, 2).unwrap().set_text("Timeline");

        tbl.cell(1, 0).unwrap().set_text("1. Discovery");
        tbl.cell(1, 1)
            .unwrap()
            .set_text("Network assessment and asset inventory");
        tbl.cell(1, 2).unwrap().set_text("Weeks 1-3");

        tbl.cell(2, 0).unwrap().set_text("2. Design");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Security architecture and policy design");
        tbl.cell(2, 2).unwrap().set_text("Weeks 4-6");

        tbl.cell(3, 0).unwrap().set_text("3. Implementation");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("Deploy monitoring and access controls");
        tbl.cell(3, 2).unwrap().set_text("Weeks 7-10");

        tbl.cell(4, 0).unwrap().set_text("4. Validation");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Testing, training, and handover");
        tbl.cell(4, 2).unwrap().set_text("Weeks 11-12");

        println!("  Inserted deliverables table at position {}", idx);
    }

    // ── Update metadata ──
    doc.set_title("Riverside Medical Center — Network Security Upgrade Proposal");
    doc.set_author("James Wilson");
    doc.set_subject("Project Proposal");
    doc.set_keywords("security, network, medical, proposal");

    doc.save(output_path).unwrap();
}

examples/header_banner.rs (line 166)

fn generate_header_banner_doc(path: &Path) {
    let mut doc = Document::new();

    // Page setup with extra top margin for the banner
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::twips(2292), // top — extra tall for header banner
        Length::twips(1440), // right
        Length::twips(1440), // bottom
        Length::twips(1440), // left
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Generate a simple logo image (white text on transparent background)
    let logo_img = create_logo_png(220, 48);

    // ── Dark blue banner ──
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1A3C6E",
            banner_width: 7772400, // full page width in EMU (~8.5")
            banner_height: 969026, // banner height in EMU (~1.06")
            logo_width: 2011680,   // logo display width (~2.2")
            logo_height: 438912,   // logo display height (~0.48")
            logo_x_offset: 295125, // left padding
            logo_y_offset: 265057, // vertical centering
        },
    );

    doc.set_raw_header_with_images(
        banner.clone(),
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );

    // Use a different first page header (same banner, different color)
    doc.set_different_first_page(true);
    let first_page_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "2E75B6", // lighter blue for cover
            banner_width: 7772400,
            banner_height: 969026,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 265057,
        },
    );
    doc.set_raw_header_with_images(
        first_page_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );

    // Footer
    doc.set_footer("Confidential — Internal Use Only");

    // ── Page 1: Cover ──
    doc.add_paragraph("Company Report").style("Heading1");

    doc.add_paragraph(
        "This document demonstrates a custom header banner built with DrawingML \
         group shapes. The banner uses a colored rectangle with a logo image overlaid, \
         positioned at the top of each page.",
    );

    doc.add_paragraph("");

    doc.add_paragraph("How the Header Banner Works")
        .style("Heading2");

    doc.add_paragraph(
        "The header banner is built using set_raw_header_with_images(), which \
         accepts raw XML and a list of (rel_id, image_data, filename) tuples. \
         The XML uses a DrawingML group shape (wpg:wgp) containing:",
    );

    doc.add_bullet_list_item(
        "A wps:wsp rectangle shape with a solid color fill (the background bar)",
        0,
    );
    doc.add_bullet_list_item(
        "A pic:pic image element positioned within the group (the logo)",
        0,
    );
    doc.add_bullet_list_item(
        "The group is wrapped in a wp:anchor element for absolute page positioning",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Customization").style("Heading2");

    doc.add_paragraph(
        "All dimensions are in EMU (English Metric Units) where 914400 EMU = 1 inch. \
         You can customize:",
    );

    doc.add_bullet_list_item("bg_color — any hex color for the rectangle background", 0);
    doc.add_bullet_list_item("banner_width / banner_height — size of the full banner", 0);
    doc.add_bullet_list_item("logo_width / logo_height — display size of the logo", 0);
    doc.add_bullet_list_item(
        "logo_x_offset / logo_y_offset — logo position within the banner",
        0,
    );

    doc.add_paragraph("");

    doc.add_paragraph("Different First Page").style("Heading2");

    doc.add_paragraph(
        "This page uses a lighter blue banner (first page header). \
         Subsequent pages use a darker blue banner (default header). \
         Use set_different_first_page(true) to enable this.",
    );

    // ── Page 2 ──
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("Second Page").style("Heading1");

    doc.add_paragraph(
        "This page shows the default header banner (dark blue). The first page \
         had a lighter blue banner because we set a different first-page header.",
    );

    doc.add_paragraph("");

    doc.add_paragraph(
        "The banner repeats on every page because it is placed in the header part. \
         You can have different banners for default, first-page, and even-page headers.",
    );

    doc.set_title("Header Banner Example");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/styled_tables.rs (line 446)

fn generate_styled_tables(path: &Path) {
    let mut doc = Document::new();
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );

    doc.add_paragraph("Styled Tables Showcase")
        .style("Heading1");

    doc.add_paragraph("");

    // =========================================================================
    // 1. Professional report table with alternating rows
    // =========================================================================
    doc.add_paragraph("1. Report Table with Alternating Row Colors")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 4);
        tbl = tbl.borders(BorderStyle::Single, 2, "BFBFBF");
        tbl = tbl.width_pct(100.0);

        // Header row
        let headers = ["Product", "Q1 Sales", "Q2 Sales", "Growth"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().shading("2E75B6");
            tbl.cell(0, col).unwrap().set_text(h);
        }
        tbl.row(0).unwrap().header();

        // Data with alternating shading
        let data = [
            ["Enterprise Suite", "$245,000", "$312,000", "+27.3%"],
            ["Professional", "$189,000", "$201,000", "+6.3%"],
            ["Starter Pack", "$67,000", "$84,500", "+26.1%"],
            ["Add-ons", "$34,000", "$41,200", "+21.2%"],
            ["Training", "$22,000", "$28,900", "+31.4%"],
            ["Support Plans", "$56,000", "$62,300", "+11.3%"],
        ];

        for (i, row) in data.iter().enumerate() {
            let row_idx = i + 1;
            for (col, val) in row.iter().enumerate() {
                tbl.cell(row_idx, col).unwrap().set_text(val);
                // Alternate row colors
                if i % 2 == 0 {
                    tbl.cell(row_idx, col).unwrap().shading("F2F7FB");
                }
            }
        }

        // Total row
        tbl.cell(7, 0).unwrap().set_text("TOTAL");
        tbl.cell(7, 0).unwrap().shading("D6E4F0");
        tbl.cell(7, 1).unwrap().set_text("$613,000");
        tbl.cell(7, 1).unwrap().shading("D6E4F0");
        tbl.cell(7, 2).unwrap().set_text("$729,900");
        tbl.cell(7, 2).unwrap().shading("D6E4F0");
        tbl.cell(7, 3).unwrap().set_text("+19.1%");
        tbl.cell(7, 3).unwrap().shading("D6E4F0");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 2. Invoice-style table with merged header
    // =========================================================================
    doc.add_paragraph("2. Invoice Table with Merged Header & Row Spans")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(7, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Merged title row
        tbl.cell(0, 0).unwrap().set_text("INVOICE #2026-0042");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("1F4E79");

        // Column headers
        let headers = ["Item", "Description", "Qty", "Amount"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(1, col).unwrap().set_text(h);
            tbl.cell(1, col).unwrap().shading("D6E4F0");
        }

        // Line items
        tbl.cell(2, 0).unwrap().set_text("LIC-ENT-500");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Enterprise License (500 seats)");
        tbl.cell(2, 2).unwrap().set_text("1");
        tbl.cell(2, 3).unwrap().set_text("$60,000");

        tbl.cell(3, 0).unwrap().set_text("SVC-IMPL");
        tbl.cell(3, 1).unwrap().set_text("Implementation Services");
        tbl.cell(3, 2).unwrap().set_text("1");
        tbl.cell(3, 3).unwrap().set_text("$25,000");

        tbl.cell(4, 0).unwrap().set_text("SVC-TRAIN");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("On-site Training (3 days)");
        tbl.cell(4, 2).unwrap().set_text("1");
        tbl.cell(4, 3).unwrap().set_text("$4,500");

        // Subtotal
        tbl.cell(5, 0).unwrap().set_text("Subtotal");
        tbl.cell(5, 0).unwrap().grid_span(3);
        tbl.cell(5, 0).unwrap().shading("F2F2F2");
        tbl.cell(5, 3).unwrap().set_text("$89,500");
        tbl.cell(5, 3).unwrap().shading("F2F2F2");

        // Total
        tbl.cell(6, 0).unwrap().set_text("TOTAL DUE");
        tbl.cell(6, 0).unwrap().grid_span(3);
        tbl.cell(6, 0).unwrap().shading("1F4E79");
        tbl.cell(6, 3).unwrap().set_text("$89,500");
        tbl.cell(6, 3).unwrap().shading("1F4E79");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 3. Specification table with vertical merge
    // =========================================================================
    doc.add_paragraph("3. Specification Table with Vertical Merges")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(8, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Specification");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Value");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        // "Hardware" spans 3 rows
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 0).unwrap().shading("E2EFDA");
        tbl.cell(1, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(1, 1).unwrap().set_text("Processor");
        tbl.cell(1, 2).unwrap().set_text("Intel Xeon E-2388G");

        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Memory");
        tbl.cell(2, 2).unwrap().set_text("64 GB DDR4 ECC");

        tbl.cell(3, 0).unwrap().v_merge_continue();
        tbl.cell(3, 1).unwrap().set_text("Storage");
        tbl.cell(3, 2).unwrap().set_text("2x 1TB NVMe SSD (RAID 1)");

        // "Network" spans 2 rows
        tbl.cell(4, 0).unwrap().set_text("Network");
        tbl.cell(4, 0).unwrap().v_merge_restart();
        tbl.cell(4, 0).unwrap().shading("FCE4D6");
        tbl.cell(4, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(4, 1).unwrap().set_text("Ethernet");
        tbl.cell(4, 2).unwrap().set_text("4x 10GbE SFP+");

        tbl.cell(5, 0).unwrap().v_merge_continue();
        tbl.cell(5, 1).unwrap().set_text("Management");
        tbl.cell(5, 2).unwrap().set_text("1x 1GbE IPMI");

        // "Software" spans 2 rows
        tbl.cell(6, 0).unwrap().set_text("Software");
        tbl.cell(6, 0).unwrap().v_merge_restart();
        tbl.cell(6, 0).unwrap().shading("D6E4F0");
        tbl.cell(6, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(6, 1).unwrap().set_text("Operating System");
        tbl.cell(6, 2).unwrap().set_text("Ubuntu 24.04 LTS");

        tbl.cell(7, 0).unwrap().v_merge_continue();
        tbl.cell(7, 1).unwrap().set_text("Monitoring");
        tbl.cell(7, 2).unwrap().set_text("Prometheus + Grafana");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 4. Nested table (table inside a cell)
    // =========================================================================
    doc.add_paragraph("4. Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");
        tbl = tbl.width_pct(100.0);
        tbl = tbl.cell_margins(
            Length::twips(72),
            Length::twips(108),
            Length::twips(72),
            Length::twips(108),
        );

        tbl.cell(0, 0).unwrap().set_text("Project Alpha");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Project Beta");
        tbl.cell(0, 1).unwrap().shading("2E75B6");

        // Nested table in cell (1,0)
        {
            let mut cell = tbl.cell(1, 0).unwrap();
            cell.set_text("Milestones:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "70AD47");
            inner.cell(0, 0).unwrap().set_text("Phase");
            inner.cell(0, 0).unwrap().shading("E2EFDA");
            inner.cell(0, 1).unwrap().set_text("Status");
            inner.cell(0, 1).unwrap().shading("E2EFDA");
            inner.cell(1, 0).unwrap().set_text("Design");
            inner.cell(1, 1).unwrap().set_text("Complete");
            inner.cell(2, 0).unwrap().set_text("Build");
            inner.cell(2, 1).unwrap().set_text("In Progress");
        }

        // Nested table in cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Budget:");
            let mut inner = cell.add_table(3, 2);
            inner = inner.borders(BorderStyle::Single, 2, "ED7D31");
            inner.cell(0, 0).unwrap().set_text("Category");
            inner.cell(0, 0).unwrap().shading("FCE4D6");
            inner.cell(0, 1).unwrap().set_text("Amount");
            inner.cell(0, 1).unwrap().shading("FCE4D6");
            inner.cell(1, 0).unwrap().set_text("Development");
            inner.cell(1, 1).unwrap().set_text("$120,000");
            inner.cell(2, 0).unwrap().set_text("Testing");
            inner.cell(2, 1).unwrap().set_text("$35,000");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 5. Form-style table with labels
    // =========================================================================
    doc.add_paragraph("5. Form-Style Table").style("Heading2");

    {
        let mut tbl = doc.add_table(6, 4);
        tbl = tbl.borders(BorderStyle::Single, 4, "808080");
        tbl = tbl.width_pct(100.0);

        // Row 0: Full-width title
        tbl.cell(0, 0)
            .unwrap()
            .set_text("Customer Registration Form");
        tbl.cell(0, 0).unwrap().grid_span(4);
        tbl.cell(0, 0).unwrap().shading("404040");

        // Row 1: Name fields
        tbl.cell(1, 0).unwrap().set_text("First Name");
        tbl.cell(1, 0).unwrap().shading("E8E8E8");
        tbl.cell(1, 1).unwrap().set_text("John");
        tbl.cell(1, 2).unwrap().set_text("Last Name");
        tbl.cell(1, 2).unwrap().shading("E8E8E8");
        tbl.cell(1, 3).unwrap().set_text("Smith");

        // Row 2: Contact
        tbl.cell(2, 0).unwrap().set_text("Email");
        tbl.cell(2, 0).unwrap().shading("E8E8E8");
        tbl.cell(2, 1).unwrap().set_text("john.smith@example.com");
        tbl.cell(2, 1).unwrap().grid_span(3);

        // Row 3: Phone
        tbl.cell(3, 0).unwrap().set_text("Phone");
        tbl.cell(3, 0).unwrap().shading("E8E8E8");
        tbl.cell(3, 1).unwrap().set_text("+1 (555) 123-4567");
        tbl.cell(3, 2).unwrap().set_text("Company");
        tbl.cell(3, 2).unwrap().shading("E8E8E8");
        tbl.cell(3, 3).unwrap().set_text("Acme Corp");

        // Row 4: Address (spanning)
        tbl.cell(4, 0).unwrap().set_text("Address");
        tbl.cell(4, 0).unwrap().shading("E8E8E8");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("123 Business Ave, Suite 400, Portland, OR 97201");
        tbl.cell(4, 1).unwrap().grid_span(3);

        // Row 5: Notes
        tbl.cell(5, 0).unwrap().set_text("Notes");
        tbl.cell(5, 0).unwrap().shading("E8E8E8");
        tbl.cell(5, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top);
        {
            let mut cell = tbl.cell(5, 1).unwrap().grid_span(3);
            cell.set_text("Premium customer since 2020. Preferred contact method: email.");
            cell.add_paragraph("Annual review scheduled for March 2026.");
        }
    }

    doc.add_paragraph("");

    // =========================================================================
    // 6. Comparison table with border styles
    // =========================================================================
    doc.add_paragraph("6. Comparison Table with Custom Borders")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(5, 3);
        tbl = tbl.borders(BorderStyle::Double, 4, "2E75B6");
        tbl = tbl.width_pct(100.0);

        // Header
        tbl.cell(0, 0).unwrap().set_text("Feature");
        tbl.cell(0, 0).unwrap().shading("2E75B6");
        tbl.cell(0, 1).unwrap().set_text("Basic Plan");
        tbl.cell(0, 1).unwrap().shading("2E75B6");
        tbl.cell(0, 2).unwrap().set_text("Enterprise Plan");
        tbl.cell(0, 2).unwrap().shading("2E75B6");

        tbl.cell(1, 0).unwrap().set_text("Users");
        tbl.cell(1, 1).unwrap().set_text("Up to 10");
        tbl.cell(1, 2).unwrap().set_text("Unlimited");
        tbl.cell(1, 2).unwrap().shading("E2EFDA");

        tbl.cell(2, 0).unwrap().set_text("Storage");
        tbl.cell(2, 1).unwrap().set_text("50 GB");
        tbl.cell(2, 2).unwrap().set_text("5 TB");
        tbl.cell(2, 2).unwrap().shading("E2EFDA");

        tbl.cell(3, 0).unwrap().set_text("Support");
        tbl.cell(3, 1).unwrap().set_text("Email only");
        tbl.cell(3, 2).unwrap().set_text("24/7 Phone + Email");
        tbl.cell(3, 2).unwrap().shading("E2EFDA");

        tbl.cell(4, 0).unwrap().set_text("Price");
        tbl.cell(4, 0).unwrap().shading("F2F2F2");
        tbl.cell(4, 1).unwrap().set_text("$29/month");
        tbl.cell(4, 1).unwrap().shading("F2F2F2");
        tbl.cell(4, 2).unwrap().set_text("$199/month");
        tbl.cell(4, 2).unwrap().shading("C6EFCE");
    }

    doc.add_paragraph("");

    // =========================================================================
    // 7. Wide table with fixed layout and row height
    // =========================================================================
    doc.add_paragraph("7. Fixed Layout Table with Row Height Control")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 5);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl = tbl.width(Length::inches(7.0));
        tbl = tbl.layout_fixed();

        // Set column widths
        for col in 0..5 {
            tbl.cell(0, col).unwrap().width(Length::inches(1.4));
        }

        // Header with exact height
        tbl.row(0).unwrap().height_exact(Length::twips(480));
        tbl.row(0).unwrap().header();
        tbl.row(0).unwrap().cant_split();

        let headers = ["Mon", "Tue", "Wed", "Thu", "Fri"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("404040");
            tbl.cell(0, col)
                .unwrap()
                .vertical_alignment(VerticalAlignment::Center);
        }

        // Schedule rows with minimum height
        tbl.row(1).unwrap().height(Length::twips(600));
        tbl.cell(1, 0).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 1).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 2).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 3).unwrap().set_text("9:00 Standup");
        tbl.cell(1, 4).unwrap().set_text("9:00 Standup");

        tbl.row(2).unwrap().height(Length::twips(600));
        tbl.cell(2, 0).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 0).unwrap().shading("D6E4F0");
        tbl.cell(2, 1).unwrap().set_text("10:00 Design Review");
        tbl.cell(2, 1).unwrap().shading("FCE4D6");
        tbl.cell(2, 2).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 2).unwrap().shading("D6E4F0");
        tbl.cell(2, 3).unwrap().set_text("10:00 Sprint Planning");
        tbl.cell(2, 3).unwrap().shading("E2EFDA");
        tbl.cell(2, 4).unwrap().set_text("10:00 Dev");
        tbl.cell(2, 4).unwrap().shading("D6E4F0");

        tbl.row(3).unwrap().height(Length::twips(600));
        tbl.cell(3, 0).unwrap().set_text("14:00 Code Review");
        tbl.cell(3, 1).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 1).unwrap().shading("D6E4F0");
        tbl.cell(3, 2).unwrap().set_text("14:00 Demo");
        tbl.cell(3, 2).unwrap().shading("FCE4D6");
        tbl.cell(3, 3).unwrap().set_text("14:00 Dev");
        tbl.cell(3, 3).unwrap().shading("D6E4F0");
        tbl.cell(3, 4).unwrap().set_text("14:00 Retro");
        tbl.cell(3, 4).unwrap().shading("E2EFDA");
    }

    doc.set_title("Styled Tables Showcase");
    doc.set_author("rdocx");

    doc.save(path).unwrap();
}

examples/generate_all_samples.rs (line 111)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

// =============================================================================
// 6. LETTER — Slate blue + silver scheme
// =============================================================================
fn generate_letter(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Slate #4A5568, Blue accent #3182CE
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
    );
    doc.set_title("Business Letter");
    doc.set_author("Walter White");

    // Banner header using raw XML
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "4A5568",
            banner_width: 7772400,
            banner_height: 731520, // ~0.8"
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 146304,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_margins(
        Length::twips(2000),
        Length::twips(1800),
        Length::twips(1440),
        Length::twips(1800),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Footer with contact
    doc.set_footer(
        "Tensorbee | 123 Innovation Drive, Suite 400 | San Francisco, CA 94105 | tensorbee.com",
    );

    // ── Sender Address ──
    doc.add_paragraph("Walter White");
    doc.add_paragraph("Chief Executive Officer");
    doc.add_paragraph("Tensorbee");
    doc.add_paragraph("123 Innovation Drive, Suite 400");
    doc.add_paragraph("San Francisco, CA 94105");
    doc.add_paragraph("");
    doc.add_paragraph("February 22, 2026");

    doc.add_paragraph("");

    // ── Recipient ──
    doc.add_paragraph("Ms. Sarah Chen");
    doc.add_paragraph("VP of Engineering");
    doc.add_paragraph("Meridian Dynamics LLC");
    doc.add_paragraph("456 Enterprise Boulevard");
    doc.add_paragraph("Austin, TX 78701");

    doc.add_paragraph("");

    // ── Subject ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Re: Strategic Technology Partnership — Phase 2 Expansion")
            .bold(true);
    }

    doc.add_paragraph("");

    // ── Body ──
    doc.add_paragraph("Dear Ms. Chen,");
    doc.add_paragraph("");

    doc.add_paragraph(
        "I am writing to express Tensorbee's enthusiasm for expanding our strategic technology \
         partnership with Meridian Dynamics. Following the successful completion of Phase 1, \
         which delivered a 40% improvement in your ML inference pipeline throughput, we believe \
         the foundation is firmly established for an ambitious Phase 2 engagement.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "During our recent executive review, your team highlighted three priority areas for \
         the next phase of collaboration:",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_numbered_list_item(
        "Real-time anomaly detection for your financial transaction monitoring system, \
         targeting sub-100ms latency at 50,000 transactions per second.",
        0,
    );
    doc.add_numbered_list_item(
        "Federated learning infrastructure to enable model training across your distributed \
         data centers without centralizing sensitive financial data.",
        0,
    );
    doc.add_numbered_list_item(
        "MLOps automation to reduce your model deployment cycle from the current 5 days \
         to under 4 hours.",
        0,
    );

    doc.add_paragraph(
        "Our engineering team has prepared a detailed technical proposal addressing each of \
         these areas. We have allocated a dedicated team of eight senior engineers, led by \
         our CTO, to ensure continuity with the Phase 1 team your organization has already \
         built a productive working relationship with.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "I would welcome the opportunity to present our Phase 2 proposal in person. My \
         assistant will reach out to coordinate a meeting at your convenience during the \
         first week of March.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("");

    doc.add_paragraph("Warm regards,");
    doc.add_paragraph("");
    doc.add_paragraph("");

    // Signature line
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "4A5568");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Walter White").bold(true).size(12.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Chief Executive Officer, Tensorbee")
            .italic(true)
            .size(10.0)
            .color("666666");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("walter@tensorbee.com | +1 (415) 555-0199")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 7. EMPLOYMENT CONTRACT — Purple + charcoal scheme
// =============================================================================
fn generate_contract(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Purple #5B2C6F, Plum #8E44AD, Gray #2C3E50
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Employment Agreement");
    doc.set_author("Tensorbee HR Department");
    doc.set_subject("Employment Contract — Walter White");
    doc.set_keywords("employment, contract, agreement, Tensorbee");

    doc.set_header("TENSORBEE — Employment Agreement");
    doc.set_footer("Employment Agreement — Walter White — Page");

    // ── Title Block ──
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("EMPLOYMENT AGREEMENT")
            .bold(true)
            .size(24.0)
            .color("5B2C6F")
            .font("Georgia");
    }
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    doc.add_paragraph("");

    // ── Parties ──
    doc.add_paragraph(
        "This Employment Agreement (\"Agreement\") is entered into as of February 22, 2026 \
         (\"Effective Date\"), by and between:",
    );

    doc.add_paragraph("");

    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYER: ").bold(true);
        p.add_run(
            "Tensorbee, Inc., a Delaware corporation with its principal place of business at \
                   123 Innovation Drive, Suite 400, San Francisco, CA 94105 (\"Company\")",
        );
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYEE: ").bold(true);
        p.add_run(
            "Walter White, residing at 308 Negra Arroyo Lane, Albuquerque, NM 87104 (\"Employee\")",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph("The Company and Employee are collectively referred to as the \"Parties.\"");
    doc.add_paragraph("");

    // ── Article 1: Position and Duties ──
    doc.add_paragraph("Article 1 — Position and Duties")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.1 ").bold(true);
        p.add_run("The Company hereby employs the Employee as ");
        p.add_run("Chief Executive Officer (CEO)")
            .bold(true)
            .italic(true);
        p.add_run(", reporting directly to the Board of Directors.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.2 ").bold(true);
        p.add_run("The Employee shall devote full working time, attention, and best efforts to \
                   the performance of duties as reasonably assigned by the Board, including but not limited to:");
    }
    doc.add_bullet_list_item(
        "Setting and executing the Company's strategic vision and business plan",
        0,
    );
    doc.add_bullet_list_item(
        "Overseeing all operations, engineering, and commercial activities",
        0,
    );
    doc.add_bullet_list_item(
        "Representing the Company to investors, customers, and the public",
        0,
    );
    doc.add_bullet_list_item("Recruiting, developing, and retaining key talent", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.3 ").bold(true);
        p.add_run(
            "The Employee's primary work location shall be the Company's San Francisco \
                   headquarters, with reasonable travel as required by business needs.",
        );
    }

    // ── Article 2: Compensation ──
    doc.add_paragraph("Article 2 — Compensation and Benefits")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.1 Base Salary. ").bold(true);
        p.add_run("The Company shall pay the Employee an annual base salary of ");
        p.add_run("$375,000.00").bold(true);
        p.add_run(" (Three Hundred Seventy-Five Thousand Dollars), payable in accordance with the \
                   Company's standard payroll schedule, less applicable withholdings and deductions.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.2 Annual Bonus. ").bold(true);
        p.add_run("The Employee shall be eligible for an annual performance bonus of up to ");
        p.add_run("40%").bold(true);
        p.add_run(
            " of base salary, based on achievement of mutually agreed performance objectives.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.3 Equity. ").bold(true);
        p.add_run("Subject to Board approval, the Employee shall receive a stock option grant of ");
        p.add_run("500,000 shares").bold(true);
        p.add_run(
            " of the Company's common stock, vesting over four (4) years with a one-year cliff, \
                   at an exercise price equal to the fair market value on the date of grant.",
        );
    }

    // Compensation summary table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "5B2C6F")
            .width_pct(70.0)
            .alignment(Alignment::Center);
        tbl.cell(0, 0).unwrap().set_text("Compensation Element");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");
        let items = [
            ("Base Salary", "$375,000/year"),
            ("Target Bonus", "Up to 40% ($150,000)"),
            ("Equity Grant", "500,000 shares (4yr vest)"),
            ("Total Target Comp", "$525,000 + equity"),
        ];
        for (i, (elem, val)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(elem);
            tbl.cell(i + 1, 1).unwrap().set_text(val);
            if i == 3 {
                tbl.cell(i + 1, 0).unwrap().shading("E8DAEF");
                tbl.cell(i + 1, 1).unwrap().shading("E8DAEF");
            }
        }
    }

    // ── Article 3: Benefits ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Article 3 — Benefits").style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.1 ").bold(true);
        p.add_run(
            "The Employee shall be entitled to participate in all benefit programs \
                   generally available to senior executives, including:",
        );
    }
    doc.add_bullet_list_item(
        "Medical, dental, and vision insurance (100% premium coverage for employee and dependents)",
        0,
    );
    doc.add_bullet_list_item("401(k) retirement plan with 6% company match", 0);
    doc.add_bullet_list_item("Life insurance and long-term disability coverage", 0);
    doc.add_bullet_list_item("Annual professional development allowance of $10,000", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.2 Paid Time Off. ").bold(true);
        p.add_run(
            "The Employee shall receive 25 days of paid vacation per year, plus Company holidays, \
                   accruing on a monthly basis.",
        );
    }

    // ── Article 4: Term and Termination ──
    doc.add_paragraph("Article 4 — Term and Termination")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.1 At-Will Employment. ").bold(true);
        p.add_run(
            "This Agreement is for at-will employment and may be terminated by either Party \
                   at any time, with or without cause, subject to the notice provisions herein.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.2 Notice Period. ").bold(true);
        p.add_run("Either Party shall provide ");
        p.add_run("ninety (90) days").bold(true);
        p.add_run(" written notice of termination, or pay in lieu thereof.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.3 Severance. ").bold(true);
        p.add_run("In the event of termination by the Company without Cause, the Employee shall \
                   receive (a) twelve (12) months of base salary continuation, (b) pro-rata bonus \
                   for the year of termination, and (c) twelve (12) months of COBRA premium coverage.");
    }

    // ── Article 5: Confidentiality ──
    doc.add_paragraph("Article 5 — Confidentiality and IP")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.1 ").bold(true);
        p.add_run(
            "The Employee agrees to maintain strict confidentiality of all proprietary \
                   information, trade secrets, and business plans of the Company during and after \
                   employment.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.2 ").bold(true);
        p.add_run(
            "All intellectual property, inventions, and works of authorship created by the \
                   Employee during the term of employment and within the scope of duties shall be \
                   the sole and exclusive property of the Company.",
        );
    }

    // ── Article 6: Non-Compete ──
    doc.add_paragraph("Article 6 — Non-Competition")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("6.1 ").bold(true);
        p.add_run("For a period of twelve (12) months following termination, the Employee agrees \
                   not to engage in any business that directly competes with the Company's core \
                   business of AI infrastructure and ML operations services, within the United States.");
    }

    // ── Article 7: General Provisions ──
    doc.add_paragraph("Article 7 — General Provisions")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.1 Governing Law. ").bold(true);
        p.add_run(
            "This Agreement shall be governed by and construed in accordance with the laws of \
                   the State of California.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.2 Entire Agreement. ").bold(true);
        p.add_run(
            "This Agreement constitutes the entire agreement between the Parties and supersedes \
                   all prior negotiations, representations, and agreements.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.3 Amendment. ").bold(true);
        p.add_run(
            "This Agreement may only be amended by a written instrument signed by both Parties.",
        );
    }

    // ── Signature Block ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("IN WITNESS WHEREOF, the Parties have executed this Employment Agreement as of the Effective Date.")
        .space_after(Length::pt(24.0));

    // Signature table
    {
        let mut tbl = doc.add_table(6, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("FOR THE COMPANY:");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("EMPLOYEE:");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");

        tbl.cell(1, 0).unwrap().set_text("");
        tbl.cell(1, 1).unwrap().set_text("");
        tbl.row(1).unwrap().height(Length::pt(40.0));

        tbl.cell(2, 0)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(3, 0)
            .unwrap()
            .set_text("Name: Board Representative");
        tbl.cell(3, 1).unwrap().set_text("Name: Walter White");
        tbl.cell(4, 0)
            .unwrap()
            .set_text("Title: Chair, Board of Directors");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Title: Chief Executive Officer");
        tbl.cell(5, 0).unwrap().set_text("Date: _______________");
        tbl.cell(5, 1).unwrap().set_text("Date: _______________");
    }

    doc
}

pub fn subject(&self) -> Option<&str>

Get the document subject.

pub fn set_subject(&mut self, subject: &str)

Set the document subject.

Examples found in repository

examples/template_replace.rs (line 241)

fn fill_template(template_path: &Path, output_path: &Path) {
    let mut doc = Document::open(template_path).unwrap();

    // ── Batch replacement ──
    let mut replacements = HashMap::new();
    replacements.insert("{{company_name}}", "Riverside Medical Center");
    replacements.insert("{{project_name}}", "Network Security Upgrade");
    replacements.insert("{{contact_name}}", "Dr. Sarah Chen");
    replacements.insert("{{contact_email}}", "s.chen@riverside.org");
    replacements.insert("{{start_date}}", "March 1, 2026");
    replacements.insert("{{duration}}", "12 weeks");
    replacements.insert("{{budget}}", "$185,000");
    replacements.insert("{{status}}", "Pending Approval");
    replacements.insert("{{author_name}}", "James Wilson");
    replacements.insert("{{date}}", "February 22, 2026");

    // Team members
    replacements.insert("{{member1_name}}", "James Wilson");
    replacements.insert("{{member1_role}}", "Project Lead");
    replacements.insert("{{member1_email}}", "j.wilson@provider.com");
    replacements.insert("{{member2_name}}", "Maria Garcia");
    replacements.insert("{{member2_role}}", "Security Architect");
    replacements.insert("{{member2_email}}", "m.garcia@provider.com");
    replacements.insert("{{member3_name}}", "David Park");
    replacements.insert("{{member3_role}}", "Network Engineer");
    replacements.insert("{{member3_email}}", "d.park@provider.com");

    let count = doc.replace_all(&replacements);
    println!("  Replaced {} placeholders", count);

    // ── Insert deliverables at the insertion point ──
    if let Some(idx) = doc.find_content_index("INSERTION_POINT") {
        // Remove the placeholder paragraph
        doc.remove_content(idx);

        // Insert deliverables list
        doc.insert_paragraph(idx, "The following deliverables are included:");

        // Insert a deliverables table
        let mut tbl = doc.insert_table(idx + 1, 5, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("E2EFDA");
        }
        tbl.cell(0, 0).unwrap().set_text("Phase");
        tbl.cell(0, 1).unwrap().set_text("Description");
        tbl.cell(0, 2).unwrap().set_text("Timeline");

        tbl.cell(1, 0).unwrap().set_text("1. Discovery");
        tbl.cell(1, 1)
            .unwrap()
            .set_text("Network assessment and asset inventory");
        tbl.cell(1, 2).unwrap().set_text("Weeks 1-3");

        tbl.cell(2, 0).unwrap().set_text("2. Design");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Security architecture and policy design");
        tbl.cell(2, 2).unwrap().set_text("Weeks 4-6");

        tbl.cell(3, 0).unwrap().set_text("3. Implementation");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("Deploy monitoring and access controls");
        tbl.cell(3, 2).unwrap().set_text("Weeks 7-10");

        tbl.cell(4, 0).unwrap().set_text("4. Validation");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Testing, training, and handover");
        tbl.cell(4, 2).unwrap().set_text("Weeks 11-12");

        println!("  Inserted deliverables table at position {}", idx);
    }

    // ── Update metadata ──
    doc.set_title("Riverside Medical Center — Network Security Upgrade Proposal");
    doc.set_author("James Wilson");
    doc.set_subject("Project Proposal");
    doc.set_keywords("security, network, medical, proposal");

    doc.save(output_path).unwrap();
}

examples/generate_all_samples.rs (line 112)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

// =============================================================================
// 6. LETTER — Slate blue + silver scheme
// =============================================================================
fn generate_letter(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Slate #4A5568, Blue accent #3182CE
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
    );
    doc.set_title("Business Letter");
    doc.set_author("Walter White");

    // Banner header using raw XML
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "4A5568",
            banner_width: 7772400,
            banner_height: 731520, // ~0.8"
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 146304,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_margins(
        Length::twips(2000),
        Length::twips(1800),
        Length::twips(1440),
        Length::twips(1800),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Footer with contact
    doc.set_footer(
        "Tensorbee | 123 Innovation Drive, Suite 400 | San Francisco, CA 94105 | tensorbee.com",
    );

    // ── Sender Address ──
    doc.add_paragraph("Walter White");
    doc.add_paragraph("Chief Executive Officer");
    doc.add_paragraph("Tensorbee");
    doc.add_paragraph("123 Innovation Drive, Suite 400");
    doc.add_paragraph("San Francisco, CA 94105");
    doc.add_paragraph("");
    doc.add_paragraph("February 22, 2026");

    doc.add_paragraph("");

    // ── Recipient ──
    doc.add_paragraph("Ms. Sarah Chen");
    doc.add_paragraph("VP of Engineering");
    doc.add_paragraph("Meridian Dynamics LLC");
    doc.add_paragraph("456 Enterprise Boulevard");
    doc.add_paragraph("Austin, TX 78701");

    doc.add_paragraph("");

    // ── Subject ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Re: Strategic Technology Partnership — Phase 2 Expansion")
            .bold(true);
    }

    doc.add_paragraph("");

    // ── Body ──
    doc.add_paragraph("Dear Ms. Chen,");
    doc.add_paragraph("");

    doc.add_paragraph(
        "I am writing to express Tensorbee's enthusiasm for expanding our strategic technology \
         partnership with Meridian Dynamics. Following the successful completion of Phase 1, \
         which delivered a 40% improvement in your ML inference pipeline throughput, we believe \
         the foundation is firmly established for an ambitious Phase 2 engagement.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "During our recent executive review, your team highlighted three priority areas for \
         the next phase of collaboration:",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_numbered_list_item(
        "Real-time anomaly detection for your financial transaction monitoring system, \
         targeting sub-100ms latency at 50,000 transactions per second.",
        0,
    );
    doc.add_numbered_list_item(
        "Federated learning infrastructure to enable model training across your distributed \
         data centers without centralizing sensitive financial data.",
        0,
    );
    doc.add_numbered_list_item(
        "MLOps automation to reduce your model deployment cycle from the current 5 days \
         to under 4 hours.",
        0,
    );

    doc.add_paragraph(
        "Our engineering team has prepared a detailed technical proposal addressing each of \
         these areas. We have allocated a dedicated team of eight senior engineers, led by \
         our CTO, to ensure continuity with the Phase 1 team your organization has already \
         built a productive working relationship with.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "I would welcome the opportunity to present our Phase 2 proposal in person. My \
         assistant will reach out to coordinate a meeting at your convenience during the \
         first week of March.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("");

    doc.add_paragraph("Warm regards,");
    doc.add_paragraph("");
    doc.add_paragraph("");

    // Signature line
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "4A5568");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Walter White").bold(true).size(12.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Chief Executive Officer, Tensorbee")
            .italic(true)
            .size(10.0)
            .color("666666");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("walter@tensorbee.com | +1 (415) 555-0199")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 7. EMPLOYMENT CONTRACT — Purple + charcoal scheme
// =============================================================================
fn generate_contract(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Purple #5B2C6F, Plum #8E44AD, Gray #2C3E50
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Employment Agreement");
    doc.set_author("Tensorbee HR Department");
    doc.set_subject("Employment Contract — Walter White");
    doc.set_keywords("employment, contract, agreement, Tensorbee");

    doc.set_header("TENSORBEE — Employment Agreement");
    doc.set_footer("Employment Agreement — Walter White — Page");

    // ── Title Block ──
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("EMPLOYMENT AGREEMENT")
            .bold(true)
            .size(24.0)
            .color("5B2C6F")
            .font("Georgia");
    }
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    doc.add_paragraph("");

    // ── Parties ──
    doc.add_paragraph(
        "This Employment Agreement (\"Agreement\") is entered into as of February 22, 2026 \
         (\"Effective Date\"), by and between:",
    );

    doc.add_paragraph("");

    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYER: ").bold(true);
        p.add_run(
            "Tensorbee, Inc., a Delaware corporation with its principal place of business at \
                   123 Innovation Drive, Suite 400, San Francisco, CA 94105 (\"Company\")",
        );
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYEE: ").bold(true);
        p.add_run(
            "Walter White, residing at 308 Negra Arroyo Lane, Albuquerque, NM 87104 (\"Employee\")",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph("The Company and Employee are collectively referred to as the \"Parties.\"");
    doc.add_paragraph("");

    // ── Article 1: Position and Duties ──
    doc.add_paragraph("Article 1 — Position and Duties")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.1 ").bold(true);
        p.add_run("The Company hereby employs the Employee as ");
        p.add_run("Chief Executive Officer (CEO)")
            .bold(true)
            .italic(true);
        p.add_run(", reporting directly to the Board of Directors.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.2 ").bold(true);
        p.add_run("The Employee shall devote full working time, attention, and best efforts to \
                   the performance of duties as reasonably assigned by the Board, including but not limited to:");
    }
    doc.add_bullet_list_item(
        "Setting and executing the Company's strategic vision and business plan",
        0,
    );
    doc.add_bullet_list_item(
        "Overseeing all operations, engineering, and commercial activities",
        0,
    );
    doc.add_bullet_list_item(
        "Representing the Company to investors, customers, and the public",
        0,
    );
    doc.add_bullet_list_item("Recruiting, developing, and retaining key talent", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.3 ").bold(true);
        p.add_run(
            "The Employee's primary work location shall be the Company's San Francisco \
                   headquarters, with reasonable travel as required by business needs.",
        );
    }

    // ── Article 2: Compensation ──
    doc.add_paragraph("Article 2 — Compensation and Benefits")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.1 Base Salary. ").bold(true);
        p.add_run("The Company shall pay the Employee an annual base salary of ");
        p.add_run("$375,000.00").bold(true);
        p.add_run(" (Three Hundred Seventy-Five Thousand Dollars), payable in accordance with the \
                   Company's standard payroll schedule, less applicable withholdings and deductions.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.2 Annual Bonus. ").bold(true);
        p.add_run("The Employee shall be eligible for an annual performance bonus of up to ");
        p.add_run("40%").bold(true);
        p.add_run(
            " of base salary, based on achievement of mutually agreed performance objectives.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.3 Equity. ").bold(true);
        p.add_run("Subject to Board approval, the Employee shall receive a stock option grant of ");
        p.add_run("500,000 shares").bold(true);
        p.add_run(
            " of the Company's common stock, vesting over four (4) years with a one-year cliff, \
                   at an exercise price equal to the fair market value on the date of grant.",
        );
    }

    // Compensation summary table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "5B2C6F")
            .width_pct(70.0)
            .alignment(Alignment::Center);
        tbl.cell(0, 0).unwrap().set_text("Compensation Element");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");
        let items = [
            ("Base Salary", "$375,000/year"),
            ("Target Bonus", "Up to 40% ($150,000)"),
            ("Equity Grant", "500,000 shares (4yr vest)"),
            ("Total Target Comp", "$525,000 + equity"),
        ];
        for (i, (elem, val)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(elem);
            tbl.cell(i + 1, 1).unwrap().set_text(val);
            if i == 3 {
                tbl.cell(i + 1, 0).unwrap().shading("E8DAEF");
                tbl.cell(i + 1, 1).unwrap().shading("E8DAEF");
            }
        }
    }

    // ── Article 3: Benefits ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Article 3 — Benefits").style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.1 ").bold(true);
        p.add_run(
            "The Employee shall be entitled to participate in all benefit programs \
                   generally available to senior executives, including:",
        );
    }
    doc.add_bullet_list_item(
        "Medical, dental, and vision insurance (100% premium coverage for employee and dependents)",
        0,
    );
    doc.add_bullet_list_item("401(k) retirement plan with 6% company match", 0);
    doc.add_bullet_list_item("Life insurance and long-term disability coverage", 0);
    doc.add_bullet_list_item("Annual professional development allowance of $10,000", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.2 Paid Time Off. ").bold(true);
        p.add_run(
            "The Employee shall receive 25 days of paid vacation per year, plus Company holidays, \
                   accruing on a monthly basis.",
        );
    }

    // ── Article 4: Term and Termination ──
    doc.add_paragraph("Article 4 — Term and Termination")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.1 At-Will Employment. ").bold(true);
        p.add_run(
            "This Agreement is for at-will employment and may be terminated by either Party \
                   at any time, with or without cause, subject to the notice provisions herein.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.2 Notice Period. ").bold(true);
        p.add_run("Either Party shall provide ");
        p.add_run("ninety (90) days").bold(true);
        p.add_run(" written notice of termination, or pay in lieu thereof.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.3 Severance. ").bold(true);
        p.add_run("In the event of termination by the Company without Cause, the Employee shall \
                   receive (a) twelve (12) months of base salary continuation, (b) pro-rata bonus \
                   for the year of termination, and (c) twelve (12) months of COBRA premium coverage.");
    }

    // ── Article 5: Confidentiality ──
    doc.add_paragraph("Article 5 — Confidentiality and IP")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.1 ").bold(true);
        p.add_run(
            "The Employee agrees to maintain strict confidentiality of all proprietary \
                   information, trade secrets, and business plans of the Company during and after \
                   employment.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.2 ").bold(true);
        p.add_run(
            "All intellectual property, inventions, and works of authorship created by the \
                   Employee during the term of employment and within the scope of duties shall be \
                   the sole and exclusive property of the Company.",
        );
    }

    // ── Article 6: Non-Compete ──
    doc.add_paragraph("Article 6 — Non-Competition")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("6.1 ").bold(true);
        p.add_run("For a period of twelve (12) months following termination, the Employee agrees \
                   not to engage in any business that directly competes with the Company's core \
                   business of AI infrastructure and ML operations services, within the United States.");
    }

    // ── Article 7: General Provisions ──
    doc.add_paragraph("Article 7 — General Provisions")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.1 Governing Law. ").bold(true);
        p.add_run(
            "This Agreement shall be governed by and construed in accordance with the laws of \
                   the State of California.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.2 Entire Agreement. ").bold(true);
        p.add_run(
            "This Agreement constitutes the entire agreement between the Parties and supersedes \
                   all prior negotiations, representations, and agreements.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.3 Amendment. ").bold(true);
        p.add_run(
            "This Agreement may only be amended by a written instrument signed by both Parties.",
        );
    }

    // ── Signature Block ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("IN WITNESS WHEREOF, the Parties have executed this Employment Agreement as of the Effective Date.")
        .space_after(Length::pt(24.0));

    // Signature table
    {
        let mut tbl = doc.add_table(6, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("FOR THE COMPANY:");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("EMPLOYEE:");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");

        tbl.cell(1, 0).unwrap().set_text("");
        tbl.cell(1, 1).unwrap().set_text("");
        tbl.row(1).unwrap().height(Length::pt(40.0));

        tbl.cell(2, 0)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(3, 0)
            .unwrap()
            .set_text("Name: Board Representative");
        tbl.cell(3, 1).unwrap().set_text("Name: Walter White");
        tbl.cell(4, 0)
            .unwrap()
            .set_text("Title: Chair, Board of Directors");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Title: Chief Executive Officer");
        tbl.cell(5, 0).unwrap().set_text("Date: _______________");
        tbl.cell(5, 1).unwrap().set_text("Date: _______________");
    }

    doc
}

pub fn keywords(&self) -> Option<&str>

Get the document keywords.

pub fn set_keywords(&mut self, keywords: &str)

Set the document keywords.

Examples found in repository

examples/template_replace.rs (line 242)

fn fill_template(template_path: &Path, output_path: &Path) {
    let mut doc = Document::open(template_path).unwrap();

    // ── Batch replacement ──
    let mut replacements = HashMap::new();
    replacements.insert("{{company_name}}", "Riverside Medical Center");
    replacements.insert("{{project_name}}", "Network Security Upgrade");
    replacements.insert("{{contact_name}}", "Dr. Sarah Chen");
    replacements.insert("{{contact_email}}", "s.chen@riverside.org");
    replacements.insert("{{start_date}}", "March 1, 2026");
    replacements.insert("{{duration}}", "12 weeks");
    replacements.insert("{{budget}}", "$185,000");
    replacements.insert("{{status}}", "Pending Approval");
    replacements.insert("{{author_name}}", "James Wilson");
    replacements.insert("{{date}}", "February 22, 2026");

    // Team members
    replacements.insert("{{member1_name}}", "James Wilson");
    replacements.insert("{{member1_role}}", "Project Lead");
    replacements.insert("{{member1_email}}", "j.wilson@provider.com");
    replacements.insert("{{member2_name}}", "Maria Garcia");
    replacements.insert("{{member2_role}}", "Security Architect");
    replacements.insert("{{member2_email}}", "m.garcia@provider.com");
    replacements.insert("{{member3_name}}", "David Park");
    replacements.insert("{{member3_role}}", "Network Engineer");
    replacements.insert("{{member3_email}}", "d.park@provider.com");

    let count = doc.replace_all(&replacements);
    println!("  Replaced {} placeholders", count);

    // ── Insert deliverables at the insertion point ──
    if let Some(idx) = doc.find_content_index("INSERTION_POINT") {
        // Remove the placeholder paragraph
        doc.remove_content(idx);

        // Insert deliverables list
        doc.insert_paragraph(idx, "The following deliverables are included:");

        // Insert a deliverables table
        let mut tbl = doc.insert_table(idx + 1, 5, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("E2EFDA");
        }
        tbl.cell(0, 0).unwrap().set_text("Phase");
        tbl.cell(0, 1).unwrap().set_text("Description");
        tbl.cell(0, 2).unwrap().set_text("Timeline");

        tbl.cell(1, 0).unwrap().set_text("1. Discovery");
        tbl.cell(1, 1)
            .unwrap()
            .set_text("Network assessment and asset inventory");
        tbl.cell(1, 2).unwrap().set_text("Weeks 1-3");

        tbl.cell(2, 0).unwrap().set_text("2. Design");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Security architecture and policy design");
        tbl.cell(2, 2).unwrap().set_text("Weeks 4-6");

        tbl.cell(3, 0).unwrap().set_text("3. Implementation");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("Deploy monitoring and access controls");
        tbl.cell(3, 2).unwrap().set_text("Weeks 7-10");

        tbl.cell(4, 0).unwrap().set_text("4. Validation");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Testing, training, and handover");
        tbl.cell(4, 2).unwrap().set_text("Weeks 11-12");

        println!("  Inserted deliverables table at position {}", idx);
    }

    // ── Update metadata ──
    doc.set_title("Riverside Medical Center — Network Security Upgrade Proposal");
    doc.set_author("James Wilson");
    doc.set_subject("Project Proposal");
    doc.set_keywords("security, network, medical, proposal");

    doc.save(output_path).unwrap();
}

examples/generate_all_samples.rs (line 113)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

// =============================================================================
// 6. LETTER — Slate blue + silver scheme
// =============================================================================
fn generate_letter(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Slate #4A5568, Blue accent #3182CE
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
        Length::inches(1.25),
    );
    doc.set_title("Business Letter");
    doc.set_author("Walter White");

    // Banner header using raw XML
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "4A5568",
            banner_width: 7772400,
            banner_height: 731520, // ~0.8"
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 146304,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_margins(
        Length::twips(2000),
        Length::twips(1800),
        Length::twips(1440),
        Length::twips(1800),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));

    // Footer with contact
    doc.set_footer(
        "Tensorbee | 123 Innovation Drive, Suite 400 | San Francisco, CA 94105 | tensorbee.com",
    );

    // ── Sender Address ──
    doc.add_paragraph("Walter White");
    doc.add_paragraph("Chief Executive Officer");
    doc.add_paragraph("Tensorbee");
    doc.add_paragraph("123 Innovation Drive, Suite 400");
    doc.add_paragraph("San Francisco, CA 94105");
    doc.add_paragraph("");
    doc.add_paragraph("February 22, 2026");

    doc.add_paragraph("");

    // ── Recipient ──
    doc.add_paragraph("Ms. Sarah Chen");
    doc.add_paragraph("VP of Engineering");
    doc.add_paragraph("Meridian Dynamics LLC");
    doc.add_paragraph("456 Enterprise Boulevard");
    doc.add_paragraph("Austin, TX 78701");

    doc.add_paragraph("");

    // ── Subject ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Re: Strategic Technology Partnership — Phase 2 Expansion")
            .bold(true);
    }

    doc.add_paragraph("");

    // ── Body ──
    doc.add_paragraph("Dear Ms. Chen,");
    doc.add_paragraph("");

    doc.add_paragraph(
        "I am writing to express Tensorbee's enthusiasm for expanding our strategic technology \
         partnership with Meridian Dynamics. Following the successful completion of Phase 1, \
         which delivered a 40% improvement in your ML inference pipeline throughput, we believe \
         the foundation is firmly established for an ambitious Phase 2 engagement.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "During our recent executive review, your team highlighted three priority areas for \
         the next phase of collaboration:",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_numbered_list_item(
        "Real-time anomaly detection for your financial transaction monitoring system, \
         targeting sub-100ms latency at 50,000 transactions per second.",
        0,
    );
    doc.add_numbered_list_item(
        "Federated learning infrastructure to enable model training across your distributed \
         data centers without centralizing sensitive financial data.",
        0,
    );
    doc.add_numbered_list_item(
        "MLOps automation to reduce your model deployment cycle from the current 5 days \
         to under 4 hours.",
        0,
    );

    doc.add_paragraph(
        "Our engineering team has prepared a detailed technical proposal addressing each of \
         these areas. We have allocated a dedicated team of eight senior engineers, led by \
         our CTO, to ensure continuity with the Phase 1 team your organization has already \
         built a productive working relationship with.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph(
        "I would welcome the opportunity to present our Phase 2 proposal in person. My \
         assistant will reach out to coordinate a meeting at your convenience during the \
         first week of March.",
    )
    .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("");

    doc.add_paragraph("Warm regards,");
    doc.add_paragraph("");
    doc.add_paragraph("");

    // Signature line
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "4A5568");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Walter White").bold(true).size(12.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Chief Executive Officer, Tensorbee")
            .italic(true)
            .size(10.0)
            .color("666666");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("walter@tensorbee.com | +1 (415) 555-0199")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 7. EMPLOYMENT CONTRACT — Purple + charcoal scheme
// =============================================================================
fn generate_contract(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Purple #5B2C6F, Plum #8E44AD, Gray #2C3E50
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.25),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Employment Agreement");
    doc.set_author("Tensorbee HR Department");
    doc.set_subject("Employment Contract — Walter White");
    doc.set_keywords("employment, contract, agreement, Tensorbee");

    doc.set_header("TENSORBEE — Employment Agreement");
    doc.set_footer("Employment Agreement — Walter White — Page");

    // ── Title Block ──
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("EMPLOYMENT AGREEMENT")
            .bold(true)
            .size(24.0)
            .color("5B2C6F")
            .font("Georgia");
    }
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 12, "5B2C6F");
    doc.add_paragraph("");

    // ── Parties ──
    doc.add_paragraph(
        "This Employment Agreement (\"Agreement\") is entered into as of February 22, 2026 \
         (\"Effective Date\"), by and between:",
    );

    doc.add_paragraph("");

    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYER: ").bold(true);
        p.add_run(
            "Tensorbee, Inc., a Delaware corporation with its principal place of business at \
                   123 Innovation Drive, Suite 400, San Francisco, CA 94105 (\"Company\")",
        );
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").indent_left(Length::inches(0.5));
        p.add_run("EMPLOYEE: ").bold(true);
        p.add_run(
            "Walter White, residing at 308 Negra Arroyo Lane, Albuquerque, NM 87104 (\"Employee\")",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph("The Company and Employee are collectively referred to as the \"Parties.\"");
    doc.add_paragraph("");

    // ── Article 1: Position and Duties ──
    doc.add_paragraph("Article 1 — Position and Duties")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.1 ").bold(true);
        p.add_run("The Company hereby employs the Employee as ");
        p.add_run("Chief Executive Officer (CEO)")
            .bold(true)
            .italic(true);
        p.add_run(", reporting directly to the Board of Directors.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.2 ").bold(true);
        p.add_run("The Employee shall devote full working time, attention, and best efforts to \
                   the performance of duties as reasonably assigned by the Board, including but not limited to:");
    }
    doc.add_bullet_list_item(
        "Setting and executing the Company's strategic vision and business plan",
        0,
    );
    doc.add_bullet_list_item(
        "Overseeing all operations, engineering, and commercial activities",
        0,
    );
    doc.add_bullet_list_item(
        "Representing the Company to investors, customers, and the public",
        0,
    );
    doc.add_bullet_list_item("Recruiting, developing, and retaining key talent", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("1.3 ").bold(true);
        p.add_run(
            "The Employee's primary work location shall be the Company's San Francisco \
                   headquarters, with reasonable travel as required by business needs.",
        );
    }

    // ── Article 2: Compensation ──
    doc.add_paragraph("Article 2 — Compensation and Benefits")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.1 Base Salary. ").bold(true);
        p.add_run("The Company shall pay the Employee an annual base salary of ");
        p.add_run("$375,000.00").bold(true);
        p.add_run(" (Three Hundred Seventy-Five Thousand Dollars), payable in accordance with the \
                   Company's standard payroll schedule, less applicable withholdings and deductions.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.2 Annual Bonus. ").bold(true);
        p.add_run("The Employee shall be eligible for an annual performance bonus of up to ");
        p.add_run("40%").bold(true);
        p.add_run(
            " of base salary, based on achievement of mutually agreed performance objectives.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("2.3 Equity. ").bold(true);
        p.add_run("Subject to Board approval, the Employee shall receive a stock option grant of ");
        p.add_run("500,000 shares").bold(true);
        p.add_run(
            " of the Company's common stock, vesting over four (4) years with a one-year cliff, \
                   at an exercise price equal to the fair market value on the date of grant.",
        );
    }

    // Compensation summary table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "5B2C6F")
            .width_pct(70.0)
            .alignment(Alignment::Center);
        tbl.cell(0, 0).unwrap().set_text("Compensation Element");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");
        let items = [
            ("Base Salary", "$375,000/year"),
            ("Target Bonus", "Up to 40% ($150,000)"),
            ("Equity Grant", "500,000 shares (4yr vest)"),
            ("Total Target Comp", "$525,000 + equity"),
        ];
        for (i, (elem, val)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(elem);
            tbl.cell(i + 1, 1).unwrap().set_text(val);
            if i == 3 {
                tbl.cell(i + 1, 0).unwrap().shading("E8DAEF");
                tbl.cell(i + 1, 1).unwrap().shading("E8DAEF");
            }
        }
    }

    // ── Article 3: Benefits ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Article 3 — Benefits").style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.1 ").bold(true);
        p.add_run(
            "The Employee shall be entitled to participate in all benefit programs \
                   generally available to senior executives, including:",
        );
    }
    doc.add_bullet_list_item(
        "Medical, dental, and vision insurance (100% premium coverage for employee and dependents)",
        0,
    );
    doc.add_bullet_list_item("401(k) retirement plan with 6% company match", 0);
    doc.add_bullet_list_item("Life insurance and long-term disability coverage", 0);
    doc.add_bullet_list_item("Annual professional development allowance of $10,000", 0);

    {
        let mut p = doc.add_paragraph("");
        p.add_run("3.2 Paid Time Off. ").bold(true);
        p.add_run(
            "The Employee shall receive 25 days of paid vacation per year, plus Company holidays, \
                   accruing on a monthly basis.",
        );
    }

    // ── Article 4: Term and Termination ──
    doc.add_paragraph("Article 4 — Term and Termination")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.1 At-Will Employment. ").bold(true);
        p.add_run(
            "This Agreement is for at-will employment and may be terminated by either Party \
                   at any time, with or without cause, subject to the notice provisions herein.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.2 Notice Period. ").bold(true);
        p.add_run("Either Party shall provide ");
        p.add_run("ninety (90) days").bold(true);
        p.add_run(" written notice of termination, or pay in lieu thereof.");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("4.3 Severance. ").bold(true);
        p.add_run("In the event of termination by the Company without Cause, the Employee shall \
                   receive (a) twelve (12) months of base salary continuation, (b) pro-rata bonus \
                   for the year of termination, and (c) twelve (12) months of COBRA premium coverage.");
    }

    // ── Article 5: Confidentiality ──
    doc.add_paragraph("Article 5 — Confidentiality and IP")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.1 ").bold(true);
        p.add_run(
            "The Employee agrees to maintain strict confidentiality of all proprietary \
                   information, trade secrets, and business plans of the Company during and after \
                   employment.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("5.2 ").bold(true);
        p.add_run(
            "All intellectual property, inventions, and works of authorship created by the \
                   Employee during the term of employment and within the scope of duties shall be \
                   the sole and exclusive property of the Company.",
        );
    }

    // ── Article 6: Non-Compete ──
    doc.add_paragraph("Article 6 — Non-Competition")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("6.1 ").bold(true);
        p.add_run("For a period of twelve (12) months following termination, the Employee agrees \
                   not to engage in any business that directly competes with the Company's core \
                   business of AI infrastructure and ML operations services, within the United States.");
    }

    // ── Article 7: General Provisions ──
    doc.add_paragraph("Article 7 — General Provisions")
        .style("Heading1");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.1 Governing Law. ").bold(true);
        p.add_run(
            "This Agreement shall be governed by and construed in accordance with the laws of \
                   the State of California.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.2 Entire Agreement. ").bold(true);
        p.add_run(
            "This Agreement constitutes the entire agreement between the Parties and supersedes \
                   all prior negotiations, representations, and agreements.",
        );
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("7.3 Amendment. ").bold(true);
        p.add_run(
            "This Agreement may only be amended by a written instrument signed by both Parties.",
        );
    }

    // ── Signature Block ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("IN WITNESS WHEREOF, the Parties have executed this Employment Agreement as of the Effective Date.")
        .space_after(Length::pt(24.0));

    // Signature table
    {
        let mut tbl = doc.add_table(6, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("FOR THE COMPANY:");
        tbl.cell(0, 0).unwrap().shading("5B2C6F");
        tbl.cell(0, 1).unwrap().set_text("EMPLOYEE:");
        tbl.cell(0, 1).unwrap().shading("5B2C6F");

        tbl.cell(1, 0).unwrap().set_text("");
        tbl.cell(1, 1).unwrap().set_text("");
        tbl.row(1).unwrap().height(Length::pt(40.0));

        tbl.cell(2, 0)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Signature: ___________________________");
        tbl.cell(3, 0)
            .unwrap()
            .set_text("Name: Board Representative");
        tbl.cell(3, 1).unwrap().set_text("Name: Walter White");
        tbl.cell(4, 0)
            .unwrap()
            .set_text("Title: Chair, Board of Directors");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Title: Chief Executive Officer");
        tbl.cell(5, 0).unwrap().set_text("Date: _______________");
        tbl.cell(5, 1).unwrap().set_text("Date: _______________");
    }

    doc
}

pub fn append(&mut self, other: &Document)

Append the content of another document to this document.

Copies all body content (paragraphs and tables) from the other document. Handles style deduplication and numbering remapping.

Examples found in repository

examples/generate_all_samples.rs (line 648)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

pub fn append_with_break(&mut self, other: &Document, break_type: SectionBreak)

Append the content of another document with a section break.

pub fn insert_document(&mut self, index: usize, other: &Document)

Insert the content of another document at a specified body index.

An index past the end is clamped to the end rather than panicking.

pub fn insert_toc(&mut self, index: usize, max_level: u32)

Insert a Table of Contents at the given body content index.

Scans the document for heading paragraphs (Heading1..HeadingN where N <= max_level), inserts bookmark markers at each heading, and generates TOC entry paragraphs with internal hyperlinks and dot-leader tab stops.

Arguments

• index - Body content index at which to insert the TOC
• max_level - Maximum heading level to include (1-9, typically 3)

Examples found in repository

examples/generate_all_samples.rs (line 156)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

// =============================================================================
// 2. PROPOSAL DOCUMENT — Deep navy + gold scheme
// =============================================================================
fn generate_proposal(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Navy #1B2A4A, Gold #C5922E, Light #F4F1EB
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("AI Platform Modernization Proposal");
    doc.set_author("Walter White");
    doc.set_subject("Technology Proposal");
    doc.set_keywords("proposal, AI, modernization, Tensorbee");

    // Banner header
    let logo_img = create_logo_png(220, 48);
    let banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "1B2A4A",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::Default,
    );
    doc.set_different_first_page(true);
    let cover_banner = build_header_banner_xml(
        "rId1",
        &BannerOpts {
            bg_color: "C5922E",
            banner_width: 7772400,
            banner_height: 914400,
            logo_width: 2011680,
            logo_height: 438912,
            logo_x_offset: 295125,
            logo_y_offset: 237744,
        },
    );
    doc.set_raw_header_with_images(
        cover_banner,
        &[("rId1", &logo_img, "logo.png")],
        rdocx_oxml::header_footer::HdrFtrType::First,
    );
    doc.set_margins(
        Length::twips(2292),
        Length::twips(1440),
        Length::twips(1440),
        Length::twips(1440),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_footer("Tensorbee — Confidential");

    // Custom styles
    doc.add_style(
        StyleBuilder::paragraph("ProposalTitle", "Proposal Title")
            .based_on("Normal")
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                font_ascii: Some("Georgia".to_string()),
                font_hansi: Some("Georgia".to_string()),
                sz: Some(rdocx_oxml::HalfPoint(56)), // half-points → 28pt
                color: Some("1B2A4A".to_string()),
                ..Default::default()
            }),
    );

    // ── Cover Page ──
    for _ in 0..4 {
        doc.add_paragraph("");
    }
    doc.add_paragraph("AI Platform Modernization")
        .style("ProposalTitle")
        .alignment(Alignment::Center);
    doc.add_paragraph("")
        .alignment(Alignment::Center)
        .border_bottom(BorderStyle::Single, 8, "C5922E");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared for Global Financial Corp.")
            .size(14.0)
            .color("666666")
            .italic(true);
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by: Walter White, CEO — Tensorbee")
            .size(12.0)
            .color("888888");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("February 22, 2026").size(12.0).color("888888");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Table of Contents").style("Heading1");
    // We'll add a manual-style TOC since the insert_toc goes at a specific position
    doc.insert_toc(doc.content_count(), 2);

    // ── Executive Summary ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Summary").style("Heading1");
    doc.add_paragraph(
        "Tensorbee proposes a comprehensive modernization of Global Financial Corp's AI platform, \
         transitioning from legacy batch-processing systems to a real-time inference architecture. \
         This transformation will reduce model deployment time from weeks to hours, improve \
         prediction accuracy by an estimated 23%, and deliver $4.2M in annual operational savings.",
    )
    .first_line_indent(Length::inches(0.3));
    doc.add_paragraph(
        "The project spans three phases over 18 months, with a total investment of $2.8M. \
         Tensorbee brings deep expertise in ML infrastructure, having successfully completed \
         similar transformations for three Fortune 500 financial institutions.",
    )
    .first_line_indent(Length::inches(0.3));

    // Key metrics table
    doc.add_paragraph("");
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Key Metric");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        let rows = [
            ("Total Investment", "$2.8M"),
            ("Annual Savings", "$4.2M"),
            ("ROI (Year 1)", "150%"),
            ("Timeline", "18 months"),
        ];
        for (i, (k, v)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(k);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
            }
            tbl.cell(i + 1, 1).unwrap().set_text(v);
            if i % 2 == 0 {
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Problem Statement ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Problem Statement").style("Heading1");
    doc.add_paragraph(
        "Global Financial Corp's current AI infrastructure faces three critical challenges:",
    );
    doc.add_numbered_list_item("Deployment Latency — New models take 3-4 weeks to deploy to production, compared to the industry benchmark of 2-3 days.", 0);
    doc.add_numbered_list_item("Scalability Constraints — The batch processing architecture cannot handle real-time inference demands during peak trading hours.", 0);
    doc.add_numbered_list_item("Technical Debt — Legacy Python 2.7 codebases and manual deployment scripts create reliability risks and slow iteration speed.", 0);

    // ── Proposed Solution ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Proposed Solution").style("Heading1");

    doc.add_paragraph("Phase 1: Foundation (Months 1-6)")
        .style("Heading2");
    doc.add_bullet_list_item("Deploy Kubernetes-based ML serving infrastructure", 0);
    doc.add_bullet_list_item("Implement CI/CD pipeline for model deployment", 0);
    doc.add_bullet_list_item("Migrate top 5 production models to new platform", 0);

    doc.add_paragraph("Phase 2: Expansion (Months 7-12)")
        .style("Heading2");
    doc.add_bullet_list_item(
        "Real-time feature engineering pipeline (Apache Kafka + Flink)",
        0,
    );
    doc.add_bullet_list_item("A/B testing framework for model variants", 0);
    doc.add_bullet_list_item("Automated model monitoring and drift detection", 0);

    doc.add_paragraph("Phase 3: Optimization (Months 13-18)")
        .style("Heading2");
    doc.add_bullet_list_item("GPU inference optimization (TensorRT/ONNX Runtime)", 0);
    doc.add_bullet_list_item("Multi-region deployment for latency reduction", 0);
    doc.add_bullet_list_item(
        "Self-service model deployment portal for data science teams",
        0,
    );

    // ── Budget ──
    doc.add_paragraph("Budget Breakdown").style("Heading1");
    {
        let mut tbl = doc
            .add_table(6, 3)
            .borders(BorderStyle::Single, 4, "1B2A4A")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("1B2A4A");
        tbl.cell(0, 1).unwrap().set_text("Cost");
        tbl.cell(0, 1).unwrap().shading("1B2A4A");
        tbl.cell(0, 2).unwrap().set_text("Notes");
        tbl.cell(0, 2).unwrap().shading("1B2A4A");
        let items = [
            (
                "Infrastructure",
                "$450,000",
                "Cloud compute + GPU instances",
            ),
            ("Engineering Services", "$1,600,000", "12 FTE x 18 months"),
            (
                "Software Licenses",
                "$350,000",
                "Kafka, monitoring, CI/CD tools",
            ),
            (
                "Training & Enablement",
                "$200,000",
                "Team training, documentation",
            ),
            ("Contingency (10%)", "$200,000", "Risk buffer"),
        ];
        for (i, (cat, cost, note)) in items.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(cost);
            tbl.cell(i + 1, 2).unwrap().set_text(note);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 1).unwrap().shading("F4F1EB");
                tbl.cell(i + 1, 2).unwrap().shading("F4F1EB");
            }
        }
    }

    // ── Closing ──
    doc.add_paragraph("");
    doc.add_paragraph("Next Steps").style("Heading1");
    doc.add_numbered_list_item(
        "Schedule technical deep-dive with GFC engineering team (Week 1)",
        0,
    );
    doc.add_numbered_list_item("Finalize scope and sign SOW (Week 2-3)", 0);
    doc.add_numbered_list_item("Kick off Phase 1 with joint planning session (Week 4)", 0);

    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Walter White")
            .bold(true)
            .size(14.0)
            .color("1B2A4A");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("CEO, Tensorbee | walter@tensorbee.com")
            .size(10.0)
            .color("888888");
    }

    doc
}

// =============================================================================
// 3. QUOTE / BILL OF MATERIALS — Teal + orange scheme
// =============================================================================
fn generate_quote(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Teal #008B8B, Dark #1A3C3C, Orange #E07020, Light #F0F8F8
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Quotation QT-2026-0147");
    doc.set_author("Walter White");
    doc.set_keywords("quote, BOM, Tensorbee");

    doc.set_header("Tensorbee — Quotation");
    doc.set_footer("QT-2026-0147 | Page");

    // ── Header Block ──
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Left);
        p.add_run("TENSORBEE")
            .bold(true)
            .size(28.0)
            .color("008B8B")
            .font("Helvetica");
    }
    doc.add_paragraph("123 Innovation Drive, Suite 400")
        .alignment(Alignment::Left);
    doc.add_paragraph("San Francisco, CA 94105 | +1 (415) 555-0199")
        .alignment(Alignment::Left);
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 8, "008B8B");

    // Quote meta
    doc.add_paragraph("");
    {
        let mut tbl = doc.add_table(4, 4).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("QUOTATION");
        tbl.cell(0, 0).unwrap().shading("008B8B").grid_span(2);
        tbl.cell(0, 2).unwrap().set_text("DATE");
        tbl.cell(0, 2).unwrap().shading("008B8B");
        tbl.cell(0, 3).unwrap().set_text("VALID UNTIL");
        tbl.cell(0, 3).unwrap().shading("008B8B");
        tbl.cell(1, 0).unwrap().set_text("Quote #:");
        tbl.cell(1, 1).unwrap().set_text("QT-2026-0147");
        tbl.cell(1, 2).unwrap().set_text("Feb 22, 2026");
        tbl.cell(1, 3).unwrap().set_text("Mar 22, 2026");
        tbl.cell(2, 0).unwrap().set_text("Prepared by:");
        tbl.cell(2, 1).unwrap().set_text("Walter White");
        tbl.cell(2, 2).unwrap().set_text("Payment:");
        tbl.cell(2, 3).unwrap().set_text("Net 30");
        tbl.cell(3, 0).unwrap().set_text("Customer:");
        tbl.cell(3, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(3, 2).unwrap().set_text("Currency:");
        tbl.cell(3, 3).unwrap().set_text("USD");
    }

    doc.add_paragraph("");

    // ── Bill of Materials ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bill of Materials")
            .bold(true)
            .size(16.0)
            .color("1A3C3C");
    }
    doc.add_paragraph("");

    {
        let mut tbl = doc
            .add_table(10, 6)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width_pct(100.0)
            .layout_fixed();
        // Headers
        let hdrs = [
            "#",
            "Part Number",
            "Description",
            "Qty",
            "Unit Price",
            "Total",
        ];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("008B8B");
        }

        let items: Vec<(&str, &str, &str, &str, &str)> = vec![
            (
                "TB-GPU-A100",
                "NVIDIA A100 80GB GPU",
                "4",
                "$12,500.00",
                "$50,000.00",
            ),
            (
                "TB-SRV-R750",
                "Dell R750xa Server Chassis",
                "2",
                "$8,200.00",
                "$16,400.00",
            ),
            (
                "TB-RAM-256G",
                "256GB DDR5 ECC Memory Module",
                "8",
                "$890.00",
                "$7,120.00",
            ),
            (
                "TB-SSD-3840",
                "3.84TB NVMe U.2 SSD",
                "8",
                "$1,150.00",
                "$9,200.00",
            ),
            (
                "TB-NET-CX7",
                "ConnectX-7 200GbE NIC",
                "4",
                "$1,800.00",
                "$7,200.00",
            ),
            (
                "TB-SW-48P",
                "48-Port 100GbE Switch",
                "1",
                "$22,000.00",
                "$22,000.00",
            ),
            (
                "TB-CAB-RACK",
                "42U Server Rack + PDU",
                "1",
                "$4,500.00",
                "$4,500.00",
            ),
            (
                "TB-SVC-INST",
                "Installation & Configuration",
                "1",
                "$8,500.00",
                "$8,500.00",
            ),
            (
                "TB-SVC-SUPP",
                "3-Year Premium Support",
                "1",
                "$15,000.00",
                "$15,000.00",
            ),
        ];

        for (i, (pn, desc, qty, unit, total)) in items.iter().enumerate() {
            let row = i + 1;
            tbl.cell(row, 0).unwrap().set_text(&format!("{}", i + 1));
            tbl.cell(row, 1).unwrap().set_text(pn);
            tbl.cell(row, 2).unwrap().set_text(desc);
            tbl.cell(row, 3).unwrap().set_text(qty);
            tbl.cell(row, 4).unwrap().set_text(unit);
            tbl.cell(row, 5).unwrap().set_text(total);
            if i % 2 == 0 {
                for c in 0..6 {
                    tbl.cell(row, c).unwrap().shading("F0F8F8");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "008B8B")
            .width(Length::inches(3.5))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$139,920.00");
        tbl.cell(1, 0).unwrap().set_text("Shipping & Handling");
        tbl.cell(1, 1).unwrap().set_text("$2,500.00");
        tbl.cell(2, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(2, 1).unwrap().set_text("$12,068.10");
        tbl.cell(3, 0).unwrap().set_text("TOTAL");
        tbl.cell(3, 0).unwrap().shading("E07020");
        tbl.cell(3, 1).unwrap().set_text("$154,488.10");
        tbl.cell(3, 1).unwrap().shading("E07020");
    }

    doc.add_paragraph("");

    // ── Terms & Conditions ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Terms & Conditions")
            .bold(true)
            .size(14.0)
            .color("1A3C3C");
    }
    doc.add_numbered_list_item(
        "This quotation is valid for 30 calendar days from the date of issue.",
        0,
    );
    doc.add_numbered_list_item(
        "All prices are in USD and exclusive of applicable taxes unless stated.",
        0,
    );
    doc.add_numbered_list_item("Standard lead time is 4-6 weeks from PO receipt.", 0);
    doc.add_numbered_list_item(
        "Payment terms: Net 30 from invoice date. 2% discount for payment within 10 days.",
        0,
    );
    doc.add_numbered_list_item(
        "Warranty: 3-year manufacturer warranty on all hardware components.",
        0,
    );
    doc.add_numbered_list_item(
        "Returns subject to 15% restocking fee if initiated after 14 days.",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("")
        .border_bottom(BorderStyle::Single, 4, "008B8B");
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Accepted by: ").bold(true);
        p.add_run("___________________________ Date: ___________");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Print Name: ").bold(true);
        p.add_run("___________________________ Title: ___________");
    }

    doc
}

// =============================================================================
// 4. INVOICE — Crimson + charcoal scheme
// =============================================================================
fn generate_invoice(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Crimson #B22222, Charcoal #333333, Light #FAF0F0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
        Length::inches(0.75),
    );
    doc.set_title("Invoice INV-2026-0392");
    doc.set_author("Walter White");
    doc.set_keywords("invoice, Tensorbee");

    doc.set_footer("Tensorbee — Thank you for your business!");

    // ── Company & Invoice Header ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        // Company name left, INVOICE right
        {
            let mut cell = tbl.cell(0, 0).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("TENSORBEE")
                .bold(true)
                .size(32.0)
                .color("B22222")
                .font("Helvetica");
        }
        {
            let mut cell = tbl.cell(0, 1).unwrap();
            let mut p = cell.add_paragraph("");
            p.add_run("INVOICE").bold(true).size(32.0).color("333333");
        }
        tbl.cell(1, 0)
            .unwrap()
            .set_text("123 Innovation Drive, Suite 400");
        tbl.cell(1, 1).unwrap().set_text("Invoice #: INV-2026-0392");
        tbl.cell(2, 0).unwrap().set_text("San Francisco, CA 94105");
        tbl.cell(2, 1).unwrap().set_text("Date: February 22, 2026");
        tbl.cell(3, 0).unwrap().set_text("walter@tensorbee.com");
        tbl.cell(3, 1).unwrap().set_text("Due Date: March 24, 2026");
    }

    doc.add_paragraph("")
        .border_bottom(BorderStyle::Thick, 8, "B22222");
    doc.add_paragraph("");

    // ── Bill To / Ship To ──
    {
        let mut tbl = doc.add_table(4, 2).width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("BILL TO");
        tbl.cell(0, 0).unwrap().shading("B22222");
        tbl.cell(0, 1).unwrap().set_text("SHIP TO");
        tbl.cell(0, 1).unwrap().shading("B22222");
        tbl.cell(1, 0).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(1, 1).unwrap().set_text("Meridian Dynamics LLC");
        tbl.cell(2, 0).unwrap().set_text("456 Enterprise Blvd");
        tbl.cell(2, 1).unwrap().set_text("Attn: Server Room B");
        tbl.cell(3, 0).unwrap().set_text("Austin, TX 78701");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("456 Enterprise Blvd, Austin, TX 78701");
    }

    doc.add_paragraph("");

    // ── Line Items ──
    {
        let mut tbl = doc
            .add_table(8, 5)
            .borders(BorderStyle::Single, 2, "B22222")
            .width_pct(100.0);
        let hdrs = ["Description", "Qty", "Unit Price", "Tax", "Amount"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("B22222");
        }
        let items = [
            (
                "ML Infrastructure Setup — Phase 1",
                "1",
                "$45,000.00",
                "$3,881.25",
                "$48,881.25",
            ),
            (
                "Data Pipeline Development (160 hrs)",
                "160",
                "$225.00",
                "$3,105.00",
                "$39,105.00",
            ),
            (
                "GPU Cluster Configuration",
                "1",
                "$12,000.00",
                "$1,035.00",
                "$13,035.00",
            ),
            (
                "API Gateway Implementation",
                "1",
                "$18,500.00",
                "$1,595.63",
                "$20,095.63",
            ),
            (
                "Load Testing & QA (80 hrs)",
                "80",
                "$195.00",
                "$1,345.50",
                "$16,945.50",
            ),
            (
                "Documentation & Training",
                "1",
                "$8,000.00",
                "$690.00",
                "$8,690.00",
            ),
            (
                "Project Management (3 months)",
                "3",
                "$6,500.00",
                "$1,679.63",
                "$21,179.63",
            ),
        ];
        for (i, (desc, qty, unit, tax, amt)) in items.iter().enumerate() {
            let r = i + 1;
            tbl.cell(r, 0).unwrap().set_text(desc);
            tbl.cell(r, 1).unwrap().set_text(qty);
            tbl.cell(r, 2).unwrap().set_text(unit);
            tbl.cell(r, 3).unwrap().set_text(tax);
            tbl.cell(r, 4).unwrap().set_text(amt);
            if i % 2 == 0 {
                for c in 0..5 {
                    tbl.cell(r, c).unwrap().shading("FAF0F0");
                }
            }
        }
    }

    doc.add_paragraph("");

    // ── Totals ──
    {
        let mut tbl = doc
            .add_table(4, 2)
            .borders(BorderStyle::Single, 2, "B22222")
            .width(Length::inches(3.0))
            .alignment(Alignment::Right);
        tbl.cell(0, 0).unwrap().set_text("Subtotal");
        tbl.cell(0, 1).unwrap().set_text("$154,600.00");
        tbl.cell(1, 0).unwrap().set_text("Tax (8.625%)");
        tbl.cell(1, 1).unwrap().set_text("$13,334.25");
        tbl.cell(2, 0).unwrap().set_text("Discount (5%)");
        tbl.cell(2, 1).unwrap().set_text("-$7,730.00");
        tbl.cell(3, 0).unwrap().set_text("AMOUNT DUE");
        tbl.cell(3, 0).unwrap().shading("B22222");
        tbl.cell(3, 1).unwrap().set_text("$160,204.25");
        tbl.cell(3, 1).unwrap().shading("B22222");
    }

    doc.add_paragraph("");
    doc.add_paragraph("");

    // ── Payment Details ──
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Payment Details")
            .bold(true)
            .size(14.0)
            .color("333333");
    }
    doc.add_paragraph("Bank: Silicon Valley Bank")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Account: Tensorbee Inc. — 0847-2953-1120")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Routing: 121140399")
        .indent_left(Length::inches(0.3));
    doc.add_paragraph("Swift: SVBKUS6S")
        .indent_left(Length::inches(0.3));

    doc.add_paragraph("");

    doc.add_paragraph("Please include invoice number INV-2026-0392 in the payment reference.")
        .shading("FAF0F0")
        .border_all(BorderStyle::Single, 2, "B22222");

    doc
}

// =============================================================================
// 5. REPORT — Forest green + earth tones, with images & hierarchical sections
// =============================================================================
fn generate_report(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // Colors: Forest #2D5016, Sage #6B8E23, Earth #8B7355, Cream #FFFAF0
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_title("Q4 2025 Environmental Impact Report");
    doc.set_author("Walter White");
    doc.set_subject("Quarterly Environmental Report");
    doc.set_keywords("environment, sustainability, report, Tensorbee");

    doc.set_different_first_page(true);
    doc.set_first_page_header("");
    doc.set_header("Tensorbee — Q4 2025 Environmental Impact Report");
    doc.set_footer("CONFIDENTIAL — Page");

    // ── Cover ──
    let cover_bg = create_sample_png(612, 792, [20, 50, 15]);
    doc.add_background_image(&cover_bg, "report_cover.png");

    for _ in 0..5 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Q4 2025")
            .bold(true)
            .size(48.0)
            .color("FFFFFF")
            .font("Georgia");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Environmental Impact Report")
            .size(24.0)
            .color("90EE90")
            .font("Georgia")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Tensorbee — Sustainability Division")
            .size(14.0)
            .color("C0C0C0");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Prepared by Walter White, Chief Sustainability Officer")
            .size(11.0)
            .color("AAAAAA");
    }

    // ── TOC ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── Section 1: Executive Overview ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Executive Overview").style("Heading1");
    doc.add_paragraph(
        "This report presents Tensorbee's environmental performance for Q4 2025. Our \
         sustainability initiatives have yielded a 34% reduction in carbon emissions compared \
         to Q4 2024, exceeding our target of 25%. Key achievements include the transition to \
         100% renewable energy in our primary data centers and the launch of our carbon offset \
         marketplace.",
    )
    .first_line_indent(Length::inches(0.3));

    // Image: performance chart
    let chart_img = create_chart_png(400, 200);
    doc.add_paragraph("");
    doc.add_picture(
        &chart_img,
        "performance_chart.png",
        Length::inches(5.0),
        Length::inches(2.5),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 1: Quarterly Carbon Emissions (tonnes CO2e)")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    // ── Section 2: Energy Consumption ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Energy Consumption").style("Heading1");

    doc.add_paragraph("Data Center Operations")
        .style("Heading2");
    doc.add_paragraph(
        "Our three primary data centers consumed a combined 4.2 GWh in Q4 2025, \
         a 12% reduction from Q3 2025 driven by improved cooling efficiency and \
         server consolidation.",
    );

    // Data table
    {
        let mut tbl = doc
            .add_table(5, 4)
            .borders(BorderStyle::Single, 4, "2D5016")
            .width_pct(100.0);
        let hdrs = ["Data Center", "Capacity (MW)", "Usage (GWh)", "PUE"];
        for (c, h) in hdrs.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2D5016");
        }
        let rows = [
            ("San Francisco (Primary)", "3.2", "1.8", "1.12"),
            ("Dublin (EU)", "2.1", "1.2", "1.18"),
            ("Singapore (APAC)", "1.8", "1.2", "1.24"),
            ("TOTAL", "7.1", "4.2", "1.17 avg"),
        ];
        for (i, (dc, cap, use_, pue)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(dc);
            tbl.cell(i + 1, 1).unwrap().set_text(cap);
            tbl.cell(i + 1, 2).unwrap().set_text(use_);
            tbl.cell(i + 1, 3).unwrap().set_text(pue);
            if i == 3 {
                for c in 0..4 {
                    tbl.cell(i + 1, c).unwrap().shading("E2EFDA");
                }
            }
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("Renewable Energy Mix").style("Heading2");
    doc.add_paragraph("Breakdown of energy sources across all facilities:");

    doc.add_bullet_list_item("Solar PV: 42% (1.76 GWh)", 0);
    doc.add_bullet_list_item("Wind Power Purchase Agreements: 38% (1.60 GWh)", 0);
    doc.add_bullet_list_item("Hydroelectric: 12% (0.50 GWh)", 0);
    doc.add_bullet_list_item("Grid (non-renewable): 8% (0.34 GWh)", 0);

    // ── Section 3: Water & Waste ──
    doc.add_paragraph("Water & Waste Management")
        .style("Heading1");

    doc.add_paragraph("Water Usage").style("Heading2");
    doc.add_paragraph(
        "Total water consumption was 12.4 million gallons, a 15% reduction from Q3. \
         Our closed-loop cooling systems now recycle 78% of water used in cooling operations.",
    );

    doc.add_paragraph("Waste Reduction").style("Heading2");
    doc.add_paragraph("E-waste management results for Q4:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 2, "6B8E23")
            .width_pct(80.0);
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("6B8E23");
        tbl.cell(0, 1).unwrap().set_text("Weight (kg)");
        tbl.cell(0, 1).unwrap().shading("6B8E23");
        tbl.cell(0, 2).unwrap().set_text("Recycled %");
        tbl.cell(0, 2).unwrap().shading("6B8E23");
        let rows = [
            ("Server Hardware", "2,450", "94%"),
            ("Networking Equipment", "820", "91%"),
            ("Storage Media", "340", "99%"),
        ];
        for (i, (cat, wt, pct)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(cat);
            tbl.cell(i + 1, 1).unwrap().set_text(wt);
            tbl.cell(i + 1, 2).unwrap().set_text(pct);
        }
    }

    // ── Section 4: Initiatives ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("Q1 2026 Initiatives").style("Heading1");

    doc.add_paragraph("Planned Programs").style("Heading2");
    doc.add_numbered_list_item(
        "Deploy on-site battery storage at SF data center (2 MWh capacity)",
        0,
    );
    doc.add_numbered_list_item("Pilot immersion cooling in Dublin facility", 0);
    doc.add_numbered_list_item("Launch employee commute carbon offset program", 0);
    doc.add_numbered_list_item("Achieve ISO 14001 certification for Singapore facility", 0);

    doc.add_paragraph("Investment Targets").style("Heading2");
    doc.add_paragraph("Sustainability CapEx allocation for FY2026:")
        .keep_with_next(true);
    {
        let mut tbl = doc
            .add_table(5, 2)
            .borders(BorderStyle::Single, 4, "2D5016");
        tbl.cell(0, 0).unwrap().set_text("Initiative");
        tbl.cell(0, 0).unwrap().shading("2D5016");
        tbl.cell(0, 1).unwrap().set_text("Budget");
        tbl.cell(0, 1).unwrap().shading("2D5016");
        let rows = [
            ("Battery Storage", "$1.2M"),
            ("Immersion Cooling Pilot", "$800K"),
            ("Solar Panel Expansion", "$2.1M"),
            ("Carbon Credits", "$500K"),
        ];
        for (i, (init, budget)) in rows.iter().enumerate() {
            tbl.cell(i + 1, 0).unwrap().set_text(init);
            tbl.cell(i + 1, 1).unwrap().set_text(budget);
            if i % 2 == 0 {
                tbl.cell(i + 1, 0).unwrap().shading("FFFAF0");
                tbl.cell(i + 1, 1).unwrap().shading("FFFAF0");
            }
        }
    }

    // Image: sustainability roadmap
    let roadmap_img = create_sample_png(500, 100, [40, 80, 30]);
    doc.add_paragraph("");
    doc.add_picture(
        &roadmap_img,
        "roadmap.png",
        Length::inches(6.0),
        Length::inches(1.2),
    )
    .alignment(Alignment::Center);
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Figure 2: 2026 Sustainability Roadmap")
            .italic(true)
            .size(9.0)
            .color("666666");
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "For questions about this report, contact Walter White at sustainability@tensorbee.com.",
    )
    .shading("FFFAF0")
    .border_all(BorderStyle::Single, 2, "2D5016");

    doc
}

pub fn replace_text(&mut self, placeholder: &str, replacement: &str) -> usize

Replace all occurrences of placeholder with replacement throughout the document.

Searches body paragraphs, tables (including nested), headers, footers, text boxes and chart labels. Handles placeholders split across multiple runs. Returns the total number of replacements made.

A replacement that contains placeholder is substituted once, not repeatedly.

pub fn replace_all(&mut self, replacements: &HashMap<&str, &str>) -> usize

Replace multiple placeholders at once. Returns total replacements.

Cheaper than calling Self::replace_text per entry: the document is serialised and re-parsed once for the whole batch rather than once per placeholder.

Examples found in repository

examples/template_replace.rs (line 189)

fn fill_template(template_path: &Path, output_path: &Path) {
    let mut doc = Document::open(template_path).unwrap();

    // ── Batch replacement ──
    let mut replacements = HashMap::new();
    replacements.insert("{{company_name}}", "Riverside Medical Center");
    replacements.insert("{{project_name}}", "Network Security Upgrade");
    replacements.insert("{{contact_name}}", "Dr. Sarah Chen");
    replacements.insert("{{contact_email}}", "s.chen@riverside.org");
    replacements.insert("{{start_date}}", "March 1, 2026");
    replacements.insert("{{duration}}", "12 weeks");
    replacements.insert("{{budget}}", "$185,000");
    replacements.insert("{{status}}", "Pending Approval");
    replacements.insert("{{author_name}}", "James Wilson");
    replacements.insert("{{date}}", "February 22, 2026");

    // Team members
    replacements.insert("{{member1_name}}", "James Wilson");
    replacements.insert("{{member1_role}}", "Project Lead");
    replacements.insert("{{member1_email}}", "j.wilson@provider.com");
    replacements.insert("{{member2_name}}", "Maria Garcia");
    replacements.insert("{{member2_role}}", "Security Architect");
    replacements.insert("{{member2_email}}", "m.garcia@provider.com");
    replacements.insert("{{member3_name}}", "David Park");
    replacements.insert("{{member3_role}}", "Network Engineer");
    replacements.insert("{{member3_email}}", "d.park@provider.com");

    let count = doc.replace_all(&replacements);
    println!("  Replaced {} placeholders", count);

    // ── Insert deliverables at the insertion point ──
    if let Some(idx) = doc.find_content_index("INSERTION_POINT") {
        // Remove the placeholder paragraph
        doc.remove_content(idx);

        // Insert deliverables list
        doc.insert_paragraph(idx, "The following deliverables are included:");

        // Insert a deliverables table
        let mut tbl = doc.insert_table(idx + 1, 5, 3);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");

        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("E2EFDA");
        }
        tbl.cell(0, 0).unwrap().set_text("Phase");
        tbl.cell(0, 1).unwrap().set_text("Description");
        tbl.cell(0, 2).unwrap().set_text("Timeline");

        tbl.cell(1, 0).unwrap().set_text("1. Discovery");
        tbl.cell(1, 1)
            .unwrap()
            .set_text("Network assessment and asset inventory");
        tbl.cell(1, 2).unwrap().set_text("Weeks 1-3");

        tbl.cell(2, 0).unwrap().set_text("2. Design");
        tbl.cell(2, 1)
            .unwrap()
            .set_text("Security architecture and policy design");
        tbl.cell(2, 2).unwrap().set_text("Weeks 4-6");

        tbl.cell(3, 0).unwrap().set_text("3. Implementation");
        tbl.cell(3, 1)
            .unwrap()
            .set_text("Deploy monitoring and access controls");
        tbl.cell(3, 2).unwrap().set_text("Weeks 7-10");

        tbl.cell(4, 0).unwrap().set_text("4. Validation");
        tbl.cell(4, 1)
            .unwrap()
            .set_text("Testing, training, and handover");
        tbl.cell(4, 2).unwrap().set_text("Weeks 11-12");

        println!("  Inserted deliverables table at position {}", idx);
    }

    // ── Update metadata ──
    doc.set_title("Riverside Medical Center — Network Security Upgrade Proposal");
    doc.set_author("James Wilson");
    doc.set_subject("Project Proposal");
    doc.set_keywords("security, network, medical, proposal");

    doc.save(output_path).unwrap();
}

examples/generate_all_samples.rs (line 540)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

pub fn replace_regex( &mut self, pattern: &str, replacement: &str, ) -> Result<usize>

Replace all regex matches with replacement throughout the document.

The replacement string supports capture groups: $1, $2, etc. Searches body paragraphs, tables (including nested), headers, and footers. Returns the total number of replacements made, or an error if the regex is invalid.

Examples found in repository

examples/generate_all_samples.rs (line 547)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

pub fn replace_all_regex( &mut self, patterns: &[(String, String)], ) -> Result<usize>

Replace multiple regex patterns at once. Returns total replacements.

pub fn to_pdf(&self) -> Result<Vec<u8>>

Render the document to PDF bytes.

This performs a full layout pass (font shaping, line breaking, pagination) and then renders the result to a PDF document.

Font resolution order:

1. Fonts embedded in the DOCX file (word/fonts/)
2. System fonts when the default system-fonts feature is enabled
3. Always-available bundled metric-compatible fonts

Examples found in repository

examples/generate_pdf.rs (line 10)

fn main() {
    // Test 1: Simple document
    let doc = Document::new();
    match doc.to_pdf() {
        Ok(bytes) => {
            std::fs::write("/tmp/rdocx_simple.pdf", &bytes).unwrap();
            println!("Simple PDF: {} bytes -> /tmp/rdocx_simple.pdf", bytes.len());
        }
        Err(e) => println!("Simple PDF failed: {e}"),
    }

    // Test 2: Document with content
    let mut doc = Document::new();
    doc.set_title("Test PDF Document");
    doc.set_author("rdocx-pdf");
    doc.add_paragraph("Chapter 1: Introduction")
        .style("Heading1");
    doc.add_paragraph(
        "This is a test document generated by rdocx and rendered to PDF. \
         It demonstrates text rendering with proper font shaping and pagination.",
    );
    doc.add_paragraph("Section 1.1").style("Heading2");
    doc.add_paragraph("More content in a sub-section.");

    {
        let mut table = doc.add_table(2, 3);
        for r in 0..2 {
            for c in 0..3 {
                if let Some(mut cell) = table.cell(r, c) {
                    cell.set_text(&format!("R{}C{}", r + 1, c + 1));
                }
            }
        }
    }

    doc.add_paragraph("After the table.");

    match doc.to_pdf() {
        Ok(bytes) => {
            std::fs::write("/tmp/rdocx_content.pdf", &bytes).unwrap();
            println!(
                "Content PDF: {} bytes -> /tmp/rdocx_content.pdf",
                bytes.len()
            );
        }
        Err(e) => println!("Content PDF failed: {e}"),
    }

    // Test 3: From feature_showcase.docx
    let showcase_path = concat!(
        env!("CARGO_MANIFEST_DIR"),
        "/../../samples/feature_showcase.docx"
    );
    match Document::open(showcase_path) {
        Ok(doc) => match doc.to_pdf() {
            Ok(bytes) => {
                std::fs::write("/tmp/rdocx_showcase.pdf", &bytes).unwrap();
                println!(
                    "Showcase PDF: {} bytes -> /tmp/rdocx_showcase.pdf",
                    bytes.len()
                );
            }
            Err(e) => println!("Showcase PDF failed: {e}"),
        },
        Err(e) => println!("Failed to open showcase: {e}"),
    }
}

pub fn to_pdf_deterministic(&self) -> Result<Vec<u8>>

Render the document to PDF bytes using bundled fonts without system font discovery.

The deterministic layout is cached independently from the normal-font layout and is suitable for reproducible render baselines.

Examples found in repository

examples/generate_all_samples.rs (line 74)

fn export_all(dir: &Path, name: &str, mut doc: Document) {
    let docx_path = dir.join(format!("{name}.docx"));
    doc.save(&docx_path).unwrap();
    println!("  {name}.docx");

    let png = doc
        .render_page_to_png_deterministic(0, 150.0)
        .unwrap()
        .expect("every generated sample should have a first page");
    let png_path = dir.join(format!("{name}.png"));
    std::fs::write(&png_path, &png).unwrap();
    println!("  {name}.png ({} bytes)", png.len());

    match doc.to_pdf_deterministic() {
        Ok(pdf) => {
            let pdf_path = dir.join(format!("{name}.pdf"));
            std::fs::write(&pdf_path, &pdf).unwrap();
            println!("  {name}.pdf ({} bytes)", pdf.len());
        }
        Err(e) => println!("  {name}.pdf — skipped: {e}"),
    }

    let html = doc.to_html();
    let html_path = dir.join(format!("{name}.html"));
    std::fs::write(&html_path, &html).unwrap();
    println!("  {name}.html ({} bytes)", html.len());

    let md = doc.to_markdown();
    let md_path = dir.join(format!("{name}.md"));
    std::fs::write(&md_path, &md).unwrap();
    println!("  {name}.md ({} bytes)", md.len());
}

pub fn to_pdf_with_fonts(&self, font_files: &[(&str, &[u8])]) -> Result<Vec<u8>>

Render the document to PDF bytes with user-provided font files.

User-provided fonts take highest priority in font resolution.

Arguments

• font_files - Additional font files to use. Each entry is (family_name, font_bytes).

Font resolution order:

1. User-provided fonts (this parameter)
2. Fonts embedded in the DOCX file (word/fonts/)
3. System fonts when the default system-fonts feature is enabled
4. Always-available bundled metric-compatible fonts

pub fn save_pdf<P: AsRef<Path>>(&self, path: P) -> Result<()>

Save the document as a PDF file.

pub fn to_html(&self) -> String

Convert the document to a complete HTML document string.

Examples found in repository

examples/convert_html_md.rs (line 6)

fn main() {
    let doc = Document::open("samples/feature_showcase.docx").expect("Failed to open document");

    let html = doc.to_html();
    std::fs::write("/tmp/feature_showcase.html", &html).expect("Failed to write HTML");
    println!("HTML: {} bytes -> /tmp/feature_showcase.html", html.len());

    let md = doc.to_markdown();
    std::fs::write("/tmp/feature_showcase.md", &md).expect("Failed to write Markdown");
    println!("Markdown: {} bytes -> /tmp/feature_showcase.md", md.len());

    // Simple document
    let mut simple = Document::new();
    simple.add_paragraph("Hello, World!");
    let html = simple.to_html();
    println!("\n--- Simple HTML ---\n{html}");

    let md = simple.to_markdown();
    println!("--- Simple Markdown ---\n{md}");
}

examples/generate_all_samples.rs (line 83)

fn export_all(dir: &Path, name: &str, mut doc: Document) {
    let docx_path = dir.join(format!("{name}.docx"));
    doc.save(&docx_path).unwrap();
    println!("  {name}.docx");

    let png = doc
        .render_page_to_png_deterministic(0, 150.0)
        .unwrap()
        .expect("every generated sample should have a first page");
    let png_path = dir.join(format!("{name}.png"));
    std::fs::write(&png_path, &png).unwrap();
    println!("  {name}.png ({} bytes)", png.len());

    match doc.to_pdf_deterministic() {
        Ok(pdf) => {
            let pdf_path = dir.join(format!("{name}.pdf"));
            std::fs::write(&pdf_path, &pdf).unwrap();
            println!("  {name}.pdf ({} bytes)", pdf.len());
        }
        Err(e) => println!("  {name}.pdf — skipped: {e}"),
    }

    let html = doc.to_html();
    let html_path = dir.join(format!("{name}.html"));
    std::fs::write(&html_path, &html).unwrap();
    println!("  {name}.html ({} bytes)", html.len());

    let md = doc.to_markdown();
    let md_path = dir.join(format!("{name}.md"));
    std::fs::write(&md_path, &md).unwrap();
    println!("  {name}.md ({} bytes)", md.len());
}

pub fn to_html_fragment(&self) -> String

Convert the document to an HTML fragment (body content only, no <html> wrapper).

pub fn to_markdown(&self) -> String

Convert the document to Markdown.

Examples found in repository

examples/convert_html_md.rs (line 10)

fn main() {
    let doc = Document::open("samples/feature_showcase.docx").expect("Failed to open document");

    let html = doc.to_html();
    std::fs::write("/tmp/feature_showcase.html", &html).expect("Failed to write HTML");
    println!("HTML: {} bytes -> /tmp/feature_showcase.html", html.len());

    let md = doc.to_markdown();
    std::fs::write("/tmp/feature_showcase.md", &md).expect("Failed to write Markdown");
    println!("Markdown: {} bytes -> /tmp/feature_showcase.md", md.len());

    // Simple document
    let mut simple = Document::new();
    simple.add_paragraph("Hello, World!");
    let html = simple.to_html();
    println!("\n--- Simple HTML ---\n{html}");

    let md = simple.to_markdown();
    println!("--- Simple Markdown ---\n{md}");
}

examples/generate_all_samples.rs (line 88)

fn export_all(dir: &Path, name: &str, mut doc: Document) {
    let docx_path = dir.join(format!("{name}.docx"));
    doc.save(&docx_path).unwrap();
    println!("  {name}.docx");

    let png = doc
        .render_page_to_png_deterministic(0, 150.0)
        .unwrap()
        .expect("every generated sample should have a first page");
    let png_path = dir.join(format!("{name}.png"));
    std::fs::write(&png_path, &png).unwrap();
    println!("  {name}.png ({} bytes)", png.len());

    match doc.to_pdf_deterministic() {
        Ok(pdf) => {
            let pdf_path = dir.join(format!("{name}.pdf"));
            std::fs::write(&pdf_path, &pdf).unwrap();
            println!("  {name}.pdf ({} bytes)", pdf.len());
        }
        Err(e) => println!("  {name}.pdf — skipped: {e}"),
    }

    let html = doc.to_html();
    let html_path = dir.join(format!("{name}.html"));
    std::fs::write(&html_path, &html).unwrap();
    println!("  {name}.html ({} bytes)", html.len());

    let md = doc.to_markdown();
    let md_path = dir.join(format!("{name}.md"));
    std::fs::write(&md_path, &md).unwrap();
    println!("  {name}.md ({} bytes)", md.len());
}

pub fn render_page_to_png( &self, page_index: usize, dpi: f64, ) -> Result<Option<Vec<u8>>>

Render a single page of the document to PNG bytes.

Arguments

• page_index - 0-based page index
• dpi - Resolution (72 = 1:1, 150 = standard, 300 = high quality)

pub fn render_page_to_png_deterministic( &self, page_index: usize, dpi: f64, ) -> Result<Option<Vec<u8>>>

Render a single page to PNG using bundled fonts without system font discovery.

Arguments

• page_index - 0-based page index
• dpi - Resolution (72 = 1:1, 150 = standard, 300 = high quality)

Examples found in repository

examples/generate_all_samples.rs (line 67)

fn export_all(dir: &Path, name: &str, mut doc: Document) {
    let docx_path = dir.join(format!("{name}.docx"));
    doc.save(&docx_path).unwrap();
    println!("  {name}.docx");

    let png = doc
        .render_page_to_png_deterministic(0, 150.0)
        .unwrap()
        .expect("every generated sample should have a first page");
    let png_path = dir.join(format!("{name}.png"));
    std::fs::write(&png_path, &png).unwrap();
    println!("  {name}.png ({} bytes)", png.len());

    match doc.to_pdf_deterministic() {
        Ok(pdf) => {
            let pdf_path = dir.join(format!("{name}.pdf"));
            std::fs::write(&pdf_path, &pdf).unwrap();
            println!("  {name}.pdf ({} bytes)", pdf.len());
        }
        Err(e) => println!("  {name}.pdf — skipped: {e}"),
    }

    let html = doc.to_html();
    let html_path = dir.join(format!("{name}.html"));
    std::fs::write(&html_path, &html).unwrap();
    println!("  {name}.html ({} bytes)", html.len());

    let md = doc.to_markdown();
    let md_path = dir.join(format!("{name}.md"));
    std::fs::write(&md_path, &md).unwrap();
    println!("  {name}.md ({} bytes)", md.len());
}

pub fn render_all_pages(&self, dpi: f64) -> Result<Vec<Vec<u8>>>

Render all pages of the document to PNG bytes.

pub fn layout_page(&self, page_index: usize) -> Result<Option<PageFrame>>

Return a cloned positioned page from the cached normal-font layout.

page_index is zero-based. An index beyond the document returns None.

pub fn load_fonts_from_dir<P: AsRef<Path>>(dir: P) -> Vec<FontFile>

Load font files from a directory and return them as FontFile entries.

This is useful for CLI tools that accept a --font-dir argument. Supports .ttf, .otf, and .ttc files.

pub fn headings(&self) -> Vec<(u32, String)>

Get all headings in the document as (level, text) pairs.

Detects heading paragraphs by their style ID (e.g. “Heading1”, “Heading2”).

Examples found in repository

examples/generate_all_samples.rs (line 625)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

pub fn document_outline(&self) -> Vec<OutlineNode>

Get a hierarchical outline of the document headings.

Returns a tree structure where each node contains the heading level, text, and children (sub-headings).

Examples found in repository

examples/generate_all_samples.rs (line 633)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

pub fn images(&self) -> Vec<ImageInfo>

Get information about all images in the document.

Returns metadata for each inline and anchored image found in body paragraphs.

Examples found in repository

examples/generate_all_samples.rs (line 626)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

pub fn links(&self) -> Vec<LinkInfo>

Get information about all hyperlinks in the document.

Resolves hyperlink relationship IDs to their target URLs where possible.

Examples found in repository

examples/generate_all_samples.rs (line 627)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

pub fn word_count(&self) -> usize

Count the number of words in the document.

Counts whitespace-separated tokens across all paragraphs (including paragraphs inside table cells).

Examples found in repository

examples/generate_all_samples.rs (line 624)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

pub fn audit_accessibility(&self) -> Vec<AccessibilityIssue>

Audit the document for accessibility issues.

Checks for common problems: missing image alt text, heading level gaps, empty paragraphs, missing document metadata.

Examples found in repository

examples/generate_all_samples.rs (line 636)

fn generate_feature_showcase(_samples_dir: &Path) -> Document {
    let mut doc = Document::new();

    // ── Page Setup & Metadata ──
    doc.set_page_size(Length::inches(8.5), Length::inches(11.0));
    doc.set_margins(
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
        Length::inches(1.0),
    );
    doc.set_header_footer_distance(Length::twips(720), Length::twips(432));
    doc.set_gutter(Length::twips(0));
    doc.set_title("rdocx Feature Showcase");
    doc.set_author("rdocx Sample Generator");
    doc.set_subject("Comprehensive feature demonstration");
    doc.set_keywords("rdocx, docx, rust, sample, showcase");

    // Headers & Footers with different first page
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx");

    // ── COVER PAGE ──
    let bg = create_sample_png(612, 792, [20, 45, 90]);
    doc.add_background_image(&bg, "cover_bg.png");

    for _ in 0..3 {
        doc.add_paragraph("");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("rdocx").bold(true).size(72.0).color("FFFFFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Complete Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }
    doc.add_paragraph("");
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("Every feature of the rdocx Rust library")
            .size(13.0)
            .color("B0C4DE");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("demonstrated in a single document.")
            .size(13.0)
            .color("B0C4DE");
    }

    // ── TABLE OF CONTENTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.insert_toc(doc.content_count(), 3);

    // ── SECTION 1: TEXT FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("1. Text Formatting").style("Heading1");

    // Paragraph Alignment
    doc.add_paragraph("1.1 Paragraph Alignment")
        .style("Heading2");
    doc.add_paragraph("Left-aligned paragraph (default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("Center-aligned paragraph.")
        .alignment(Alignment::Center);
    doc.add_paragraph("Right-aligned paragraph.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "Justified paragraph — this text is long enough to demonstrate how justified alignment \
         distributes extra space across word gaps so lines fill the full width of the text area.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // Run Formatting
    doc.add_paragraph("1.2 Run Formatting").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold").bold(true);
        p.add_run(" | ");
        p.add_run("Italic").italic(true);
        p.add_run(" | ");
        p.add_run("Bold Italic").bold(true).italic(true);
        p.add_run(" | ");
        p.add_run("Underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double Strike").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("H");
        p.add_run("2").subscript();
        p.add_run("O (subscript) | E=mc");
        p.add_run("2").superscript();
        p.add_run(" (superscript)");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("ALL CAPS").all_caps(true);
        p.add_run(" | ");
        p.add_run("Small Caps").small_caps(true);
        p.add_run(" | ");
        p.add_run("Expanded").character_spacing(Length::twips(40));
        p.add_run(" | ");
        p.add_run("Hidden text (not visible)").hidden(true);
    }

    doc.add_paragraph("");

    // Underline Styles
    doc.add_paragraph("1.3 Underline Styles").style("Heading2");
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single ")
            .underline_style(rdocx::UnderlineStyle::Single);
        p.add_run("Double ")
            .underline_style(rdocx::UnderlineStyle::Double);
        p.add_run("Thick ")
            .underline_style(rdocx::UnderlineStyle::Thick);
        p.add_run("Dotted ")
            .underline_style(rdocx::UnderlineStyle::Dotted);
        p.add_run("Dash ")
            .underline_style(rdocx::UnderlineStyle::Dash);
        p.add_run("Wave ")
            .underline_style(rdocx::UnderlineStyle::Wave);
    }

    // ── SECTION 2: PARAGRAPH FORMATTING ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("2. Paragraph Formatting")
        .style("Heading1");

    doc.add_paragraph("2.1 Shading & Borders").style("Heading2");
    doc.add_paragraph("Paragraph with light green shading")
        .shading("E2EFDA");
    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");
    doc.add_paragraph("Paragraph with all borders (red)")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("2.2 Indentation").style("Heading2");
    doc.add_paragraph("1-inch left indent + 0.5-inch hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));
    doc.add_paragraph("0.5-inch first-line indent on this paragraph")
        .first_line_indent(Length::inches(0.5));
    doc.add_paragraph("Both left and right indent (0.75 inches each)")
        .indent_left(Length::inches(0.75))
        .indent_right(Length::inches(0.75));

    doc.add_paragraph("2.3 Spacing & Line Height")
        .style("Heading2");
    doc.add_paragraph("Extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));
    doc.add_paragraph(
        "Double line spacing paragraph. This text should have extra vertical space between \
         lines to demonstrate line_spacing_multiple(2.0).",
    )
    .line_spacing_multiple(2.0);
    doc.add_paragraph("Exact 20pt line spacing (fixed height).")
        .line_spacing(20.0);

    doc.add_paragraph("2.4 Pagination Controls")
        .style("Heading2");
    doc.add_paragraph("keep_with_next — this paragraph stays with the next")
        .keep_with_next(true);
    doc.add_paragraph("(This paragraph was kept with the one above.)");
    doc.add_paragraph("keep_together — all lines of this paragraph stay on the same page")
        .keep_together(true);
    doc.add_paragraph("widow_control — prevents widow/orphan lines")
        .widow_control(true);

    // ── SECTION 3: LISTS ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("3. Lists").style("Heading1");

    doc.add_paragraph("3.1 Bullet Lists").style("Heading2");
    doc.add_bullet_list_item("First item", 0);
    doc.add_bullet_list_item("Second item", 0);
    doc.add_bullet_list_item("Nested level 1", 1);
    doc.add_bullet_list_item("Nested level 2", 2);
    doc.add_bullet_list_item("Back to level 1", 1);
    doc.add_bullet_list_item("Third item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("3.2 Numbered Lists").style("Heading2");
    doc.add_numbered_list_item("First numbered item", 0);
    doc.add_numbered_list_item("Second numbered item", 0);
    doc.add_numbered_list_item("Sub-item A", 1);
    doc.add_numbered_list_item("Sub-item B", 1);
    doc.add_numbered_list_item("Third numbered item", 0);

    // ── SECTION 4: TAB STOPS ──
    doc.add_paragraph("");
    doc.add_paragraph("4. Tab Stops").style("Heading1");

    doc.add_paragraph("4.1 Alignment Tabs").style("Heading2");
    doc.add_paragraph("Left\tCenter\tRight\tDecimal")
        .add_tab_stop(TabAlignment::Left, Length::inches(0.0))
        .add_tab_stop(TabAlignment::Center, Length::inches(2.5))
        .add_tab_stop(TabAlignment::Right, Length::inches(5.0))
        .add_tab_stop(TabAlignment::Decimal, Length::inches(6.5));

    doc.add_paragraph("4.2 Tab Leaders").style("Heading2");
    doc.add_paragraph("Item\t\tPrice")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Widget\t\t$19.99")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(4.0), TabLeader::Dot)
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);
    doc.add_paragraph("Gadget\t\t$249.50")
        .add_tab_stop_with_leader(TabAlignment::Left, Length::inches(0.0), TabLeader::None)
        .add_tab_stop_with_leader(
            TabAlignment::Right,
            Length::inches(4.0),
            TabLeader::Underscore,
        )
        .add_tab_stop_with_leader(TabAlignment::Right, Length::inches(5.0), TabLeader::None);

    // ── SECTION 5: TABLES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("5. Tables").style("Heading1");

    doc.add_paragraph("5.1 Basic Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        for col in 0..3 {
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }
        tbl.cell(0, 0).unwrap().set_text("Name");
        tbl.cell(0, 1).unwrap().set_text("Role");
        tbl.cell(0, 2).unwrap().set_text("Location");
        tbl.cell(1, 0).unwrap().set_text("Walter White");
        tbl.cell(1, 1).unwrap().set_text("CEO");
        tbl.cell(1, 2).unwrap().set_text("Albuquerque");
        tbl.cell(2, 0).unwrap().set_text("Jesse Pinkman");
        tbl.cell(2, 1).unwrap().set_text("CTO");
        tbl.cell(2, 2).unwrap().set_text("Remote");
        tbl.cell(3, 0).unwrap().set_text("Hank Schrader");
        tbl.cell(3, 1).unwrap().set_text("Security");
        tbl.cell(3, 2).unwrap().set_text("Washington");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.2 Column Span & Cell Shading")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(3, 4)
            .borders(BorderStyle::Single, 4, "000000")
            .width_pct(100.0);
        tbl.cell(0, 0).unwrap().set_text("Quarterly Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79").grid_span(4);
        tbl.cell(1, 0).unwrap().set_text("Region");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("Q1");
        tbl.cell(1, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 2).unwrap().set_text("Q2");
        tbl.cell(1, 2).unwrap().shading("D6E4F0");
        tbl.cell(1, 3).unwrap().set_text("Total");
        tbl.cell(1, 3).unwrap().shading("D6E4F0");
        tbl.cell(2, 0).unwrap().set_text("Americas");
        tbl.cell(2, 1).unwrap().set_text("$2.4M");
        tbl.cell(2, 2).unwrap().set_text("$2.7M");
        tbl.cell(2, 3).unwrap().set_text("$5.1M");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.3 Vertical Merge").style("Heading2");
    {
        let mut tbl = doc
            .add_table(4, 3)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Category");
        tbl.cell(0, 0).unwrap().shading("E2EFDA");
        tbl.cell(0, 1).unwrap().set_text("Item");
        tbl.cell(0, 1).unwrap().shading("E2EFDA");
        tbl.cell(0, 2).unwrap().set_text("Price");
        tbl.cell(0, 2).unwrap().shading("E2EFDA");
        tbl.cell(1, 0).unwrap().set_text("Hardware");
        tbl.cell(1, 0).unwrap().v_merge_restart();
        tbl.cell(1, 1).unwrap().set_text("Laptop");
        tbl.cell(1, 2).unwrap().set_text("$1,200");
        tbl.cell(2, 0).unwrap().v_merge_continue();
        tbl.cell(2, 1).unwrap().set_text("Monitor");
        tbl.cell(2, 2).unwrap().set_text("$450");
        tbl.cell(3, 0).unwrap().set_text("Software");
        tbl.cell(3, 1).unwrap().set_text("IDE License");
        tbl.cell(3, 2).unwrap().set_text("$200/yr");
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.4 Nested Table").style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 6, "2E75B6");
        tbl.cell(0, 0).unwrap().set_text("Outer (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer (1,0)");
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Nested table below:");
            let mut nested = cell
                .add_table(2, 2)
                .borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("A");
            nested.cell(0, 1).unwrap().set_text("B");
            nested.cell(1, 0).unwrap().set_text("C");
            nested.cell(1, 1).unwrap().set_text("D");
        }
    }

    doc.add_paragraph("");

    doc.add_paragraph("5.5 Vertical Alignment & Row Properties")
        .style("Heading2");
    {
        let mut tbl = doc
            .add_table(2, 3)
            .borders(BorderStyle::Single, 4, "666666");
        tbl.row(0).unwrap().height(Length::pt(50.0)).header();
        tbl.cell(0, 0).unwrap().set_text("Top");
        tbl.cell(0, 0)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Top)
            .shading("FFF2CC");
        tbl.cell(0, 1).unwrap().set_text("Center");
        tbl.cell(0, 1)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center)
            .shading("D9E2F3");
        tbl.cell(0, 2).unwrap().set_text("Bottom");
        tbl.cell(0, 2)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom)
            .shading("E2EFDA");
        tbl.row(1).unwrap().cant_split();
        tbl.cell(1, 0).unwrap().set_text("No-wrap cell");
        tbl.cell(1, 0).unwrap().no_wrap();
        tbl.cell(1, 1).unwrap().set_text("Fixed width");
        tbl.cell(1, 1).unwrap().width(Length::inches(2.0));
        tbl.cell(1, 2).unwrap().set_text("Normal");
    }

    // ── SECTION 6: IMAGES ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("6. Images").style("Heading1");

    doc.add_paragraph("6.1 Inline Image").style("Heading2");
    doc.add_paragraph("A blue gradient image below:");
    let img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(&img, "chart.png", Length::inches(3.0), Length::inches(0.75));

    doc.add_paragraph("");
    doc.add_paragraph("6.2 Header Image").style("Heading2");
    let hdr_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &hdr_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );
    doc.add_paragraph("The header now contains an inline image (check the top of this page).");

    doc.add_paragraph("");
    doc.add_paragraph("Note: Page 1 uses a full-page background image (add_background_image).");

    // ── SECTION 7: CONTENT MANIPULATION ──
    doc.add_paragraph("").page_break_before(true);
    doc.add_paragraph("7. Content Manipulation")
        .style("Heading1");

    doc.add_paragraph("7.1 Placeholder Replacement")
        .style("Heading2");
    doc.add_paragraph("Customer: {{customer}}");
    doc.add_paragraph("Date: {{date}}");
    doc.add_paragraph("Reference: {{ref_number}}");
    {
        let mut tbl = doc
            .add_table(2, 2)
            .borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Project");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("{{project}}");
        tbl.cell(1, 0).unwrap().set_text("Status");
        tbl.cell(1, 0).unwrap().shading("D6E4F0");
        tbl.cell(1, 1).unwrap().set_text("{{status}}");
    }

    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Tensorbee Inc.");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "TB-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let n = doc.replace_all(&replacements);
    doc.add_paragraph(&format!("({n} placeholders replaced above)"));

    doc.add_paragraph("");

    doc.add_paragraph("7.2 Regex Replacement").style("Heading2");
    doc.add_paragraph("Emails: user1@example.com and admin@tensorbee.com");
    let _ = doc.replace_regex(r"\b\w+@\w+\.\w+\b", "[REDACTED]");
    doc.add_paragraph("(Email addresses above were redacted using regex replacement)");

    doc.add_paragraph("");

    doc.add_paragraph("7.3 Content Insertion").style("Heading2");
    doc.add_paragraph("Section A: First content.");
    doc.add_paragraph("Section C: Third content.");
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C via find_content_index().",
        );
    }

    // ── SECTION 8: SECTION BREAKS & ORIENTATION ──
    doc.add_paragraph("").section_break(SectionBreak::NextPage);
    doc.add_paragraph("8. Section Breaks & Orientation")
        .style("Heading1");
    doc.add_paragraph("This page is LANDSCAPE. Useful for wide tables and charts.");

    {
        let mut tbl = doc
            .add_table(3, 7)
            .borders(BorderStyle::Single, 4, "2E75B6");
        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (c, h) in headers.iter().enumerate() {
            tbl.cell(0, c).unwrap().set_text(h);
            tbl.cell(0, c).unwrap().shading("2E75B6");
        }
        let data = [
            [
                "Americas", "$1.2M", "$1.3M", "$1.4M", "$1.5M", "$1.6M", "$7.0M",
            ],
            [
                "Europe", "$0.8M", "$0.9M", "$0.9M", "$1.0M", "$1.1M", "$4.7M",
            ],
        ];
        for (r, row) in data.iter().enumerate() {
            for (c, v) in row.iter().enumerate() {
                tbl.cell(r + 1, c).unwrap().set_text(v);
            }
        }
    }

    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // ── SECTION 9: CUSTOM STYLES ──
    doc.add_paragraph("9. Custom Styles").style("Heading1");
    doc.add_style(
        StyleBuilder::paragraph("CustomHighlight", "Custom Highlight")
            .based_on("Normal")
            .paragraph_properties(rdocx_oxml::properties::CT_PPr {
                shading: Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                }),
                ..Default::default()
            })
            .run_properties(rdocx_oxml::properties::CT_RPr {
                bold: Some(true),
                color: Some("C45911".to_string()),
                ..Default::default()
            }),
    );
    doc.add_paragraph("This paragraph uses a custom style: bold orange text on yellow background.")
        .style("CustomHighlight");

    doc.add_paragraph("");

    // ── SECTION 10: DOCUMENT INTELLIGENCE ──
    doc.add_paragraph("10. Document Intelligence API")
        .style("Heading1");

    let wc = doc.word_count();
    let hc = doc.headings().len();
    let ic = doc.images().len();
    let lc = doc.links().len();
    doc.add_paragraph(&format!("Word count: {wc}"));
    doc.add_paragraph(&format!("Heading count: {hc}"));
    doc.add_paragraph(&format!("Image count: {ic}"));
    doc.add_paragraph(&format!("Link count: {lc}"));

    let outline = doc.document_outline();
    doc.add_paragraph(&format!("Top-level outline nodes: {}", outline.len()));

    let issues = doc.audit_accessibility();
    doc.add_paragraph(&format!("Accessibility issues: {}", issues.len()));
    for issue in &issues {
        doc.add_bullet_list_item(&format!("{:?}: {}", issue.severity, issue.message), 0);
    }

    // ── SECTION 11: DOCUMENT MERGING ──
    doc.add_paragraph("");
    doc.add_paragraph("11. Document Merging").style("Heading1");
    {
        let mut other = Document::new();
        other.add_paragraph("This paragraph was merged from another document using append().");
        doc.append(&other);
    }

    doc.add_paragraph("");

    // ── SUMMARY ──
    doc.add_paragraph("Summary of Demonstrated Features")
        .style("Heading1");
    let features = [
        "Page setup: size, margins, header/footer distance, gutter",
        "Document metadata: title, author, subject, keywords",
        "Headers and footers: text, images, different first page",
        "Background images (full-page behind text)",
        "Table of Contents generation with bookmarks",
        "Text formatting: bold, italic, underline styles, strike, color, size, font",
        "Advanced run: superscript, subscript, caps, small caps, spacing, hidden",
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        "Pagination controls: keep-with-next, keep-together, widow control",
        "Bullet and numbered lists with nesting",
        "Tab stops with dot/underscore/hyphen leaders",
        "Tables: borders, shading, column spans, row spans, vertical alignment, nested tables",
        "Row properties: header rows, exact height, cant-split",
        "Cell properties: width, no-wrap, vertical alignment",
        "Inline images and header images",
        "Placeholder replacement (single and batch)",
        "Regex-based find and replace",
        "Content insertion at specific positions",
        "Section breaks with mixed portrait/landscape",
        "Custom paragraph and character styles",
        "Document intelligence: word count, headings, outline, images, links",
        "Accessibility audit",
        "Document merging (append)",
        "Export: DOCX, PDF, HTML, Markdown",
    ];
    for f in &features {
        doc.add_bullet_list_item(f, 0);
    }
    doc.add_paragraph("");
    doc.add_paragraph("All features built entirely with the rdocx Rust crate.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc
}

Trait Implementations

impl Default for Document

fn default() -> Self

Returns the “default value” for a type.