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_samples.rs (line 35)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

Additional examples can be found in:

• examples/generate_all_samples.rs

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 60)

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");

    match doc.to_pdf() {
        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();
}

examples/generate_samples.rs (line 661)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    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 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_samples.rs (line 70)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

Additional examples can be found in:

• examples/generate_all_samples.rs

pub fn paragraph_count(&self) -> usize

Get the number of paragraphs.

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 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_samples.rs (line 299)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (line 354)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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 145)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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 if index > content_count().

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_samples.rs (lines 537-540)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (lines 545-548)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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. Panics if index > content_count().

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_samples.rs (line 536)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (line 544)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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_samples.rs (lines 439-444)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (line 485)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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_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_samples.rs (line 68)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    doc.save(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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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 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_samples.rs (line 56)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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_samples.rs (line 57)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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_samples.rs (line 61)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (line 106)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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_samples.rs (line 62)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (line 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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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_samples.rs (lines 452-457)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (lines 490-495)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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 718-722)

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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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_samples.rs (line 240)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (line 302)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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_samples.rs (line 251)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (line 312)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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 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 587-605)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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_samples.rs (line 40)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (line 90)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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_samples.rs (lines 41-46)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (lines 91-96)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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_samples.rs (line 47)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (line 97)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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_samples.rs (line 48)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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_samples.rs (line 60)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (line 105)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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_samples.rs (line 50)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (line 99)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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_samples.rs (line 51)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (line 100)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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_samples.rs (line 52)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

    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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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_samples.rs (line 53)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (line 102)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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 639)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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.

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 145)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.font_ascii = Some("Georgia".to_string());
                rpr.font_hansi = Some("Georgia".to_string());
                rpr.sz = Some(rdocx_oxml::HalfPoint(56)); // half-points → 28pt
                rpr.color = Some("1B2A4A".to_string());
                rpr
            }),
    );

    // ── 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, and footers. Handles placeholders split across multiple runs. Returns the total number of replacements made.

pub fn replace_all(&mut self, replacements: &HashMap<&str, &str>) -> usize

Replace multiple placeholders at once. Returns total replacements.

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_samples.rs (line 519)

fn generate_feature_showcase(path: &Path) {
    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), // top
        Length::inches(1.0), // right
        Length::inches(1.0), // bottom
        Length::inches(1.0), // left
    );
    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");

    // Header & Footer
    doc.set_header("rdocx Feature Showcase");
    doc.set_footer("Generated by rdocx — Page");

    // Different first page header
    doc.set_different_first_page(true);
    doc.set_first_page_header("rdocx");
    doc.set_first_page_footer("Feature Showcase — Cover Page");

    // =========================================================================
    // PAGE 1: COVER PAGE — background image, run formatting
    // =========================================================================
    let bg_cover = create_sample_png(612, 792, [30, 60, 120]);
    doc.add_background_image(&bg_cover, "cover_bg.png");

    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer
    doc.add_paragraph(""); // spacer

    {
        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("Feature Showcase")
            .size(28.0)
            .color("FFFFFF")
            .italic(true);
    }

    doc.add_paragraph(""); // spacer

    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("A comprehensive demonstration of every feature")
            .size(14.0)
            .color("CCDDFF");
    }
    {
        let mut p = doc.add_paragraph("").alignment(Alignment::Center);
        p.add_run("provided by the rdocx Rust crate for DOCX generation.")
            .size(14.0)
            .color("CCDDFF");
    }

    // =========================================================================
    // PAGE 2: TEXT FORMATTING
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("1. Text Formatting").style("Heading1");

    doc.add_paragraph("This section demonstrates paragraph and run-level formatting options.");
    doc.add_paragraph("");

    // --- Paragraph alignment ---
    doc.add_paragraph("Paragraph Alignment").style("Heading2");

    doc.add_paragraph("This paragraph is left-aligned (the default).")
        .alignment(Alignment::Left);
    doc.add_paragraph("This paragraph is center-aligned.")
        .alignment(Alignment::Center);
    doc.add_paragraph("This paragraph is right-aligned.")
        .alignment(Alignment::Right);
    doc.add_paragraph(
        "This paragraph is justified. To demonstrate justified text properly, it needs \
         to be long enough to span multiple lines so the word spacing adjustment is visible \
         across the full width of the text area on the page.",
    )
    .alignment(Alignment::Justify);

    doc.add_paragraph("");

    // --- Run formatting ---
    doc.add_paragraph("Run Formatting").style("Heading2");

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Bold text").bold(true);
        p.add_run(" | ");
        p.add_run("Italic text").italic(true);
        p.add_run(" | ");
        p.add_run("Bold + Italic").bold(true).italic(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Single underline").underline(true);
        p.add_run(" | ");
        p.add_run("Strikethrough").strike(true);
        p.add_run(" | ");
        p.add_run("Double strikethrough").double_strike(true);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Red text").color("FF0000");
        p.add_run(" | ");
        p.add_run("Blue text").color("0000FF");
        p.add_run(" | ");
        p.add_run("Green text").color("00AA00");
        p.add_run(" | ");
        p.add_run("Highlighted").highlight("FFFF00");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("8pt small").size(8.0);
        p.add_run(" | ");
        p.add_run("11pt normal").size(11.0);
        p.add_run(" | ");
        p.add_run("16pt large").size(16.0);
        p.add_run(" | ");
        p.add_run("24pt extra-large").size(24.0);
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Arial font").font("Arial");
        p.add_run(" | ");
        p.add_run("Times New Roman font").font("Times New Roman");
        p.add_run(" | ");
        p.add_run("Courier New font").font("Courier New");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Normal");
        p.add_run(" H").size(11.0);
        p.add_run("2").subscript();
        p.add_run("O (subscript)").size(11.0);
        p.add_run(" | E = mc").size(11.0);
        p.add_run("2").superscript();
        p.add_run(" (superscript)").size(11.0);
    }
    {
        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 spacing")
            .character_spacing(Length::twips(40));
    }

    doc.add_paragraph("");

    // --- Paragraph formatting ---
    doc.add_paragraph("Paragraph Formatting").style("Heading2");

    doc.add_paragraph("Paragraph with shading (light green background)")
        .shading("E2EFDA");

    doc.add_paragraph("Paragraph with bottom border")
        .border_bottom(BorderStyle::Single, 6, "2E75B6");

    doc.add_paragraph("Paragraph with all borders")
        .border_all(BorderStyle::Single, 4, "FF0000");

    doc.add_paragraph("Paragraph with 1-inch left indent and hanging indent")
        .indent_left(Length::inches(1.0))
        .hanging_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with first-line indent of 0.5 inches")
        .first_line_indent(Length::inches(0.5));

    doc.add_paragraph("Paragraph with extra space before (24pt) and after (12pt)")
        .space_before(Length::pt(24.0))
        .space_after(Length::pt(12.0));

    doc.add_paragraph(
        "Paragraph with double line spacing. This text should have extra vertical \
         space between lines to demonstrate the line_spacing_multiple setting.",
    )
    .line_spacing_multiple(2.0);

    doc.add_paragraph("Paragraph with keep-with-next (won't break from the next paragraph)")
        .keep_with_next(true);
    doc.add_paragraph("(This stays with the paragraph above.)");

    // =========================================================================
    // PAGE 3: LISTS & TAB STOPS
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("2. Lists").style("Heading1");

    doc.add_paragraph("Bullet List").style("Heading2");

    doc.add_bullet_list_item("First bullet item", 0);
    doc.add_bullet_list_item("Second bullet 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 bullet item", 0);

    doc.add_paragraph("");

    doc.add_paragraph("Numbered List").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);

    doc.add_paragraph("");

    // --- Tab stops ---
    doc.add_paragraph("Tab Stops").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("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 A\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 B\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);

    // =========================================================================
    // PAGE 4: TABLES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("3. Tables").style("Heading1");

    // --- Basic table with borders ---
    doc.add_paragraph("Basic Table with Borders")
        .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("Location");

        tbl.cell(1, 0).unwrap().set_text("Alice Johnson");
        tbl.cell(1, 1).unwrap().set_text("Engineering Lead");
        tbl.cell(1, 2).unwrap().set_text("New York");

        tbl.cell(2, 0).unwrap().set_text("Bob Smith");
        tbl.cell(2, 1).unwrap().set_text("Product Manager");
        tbl.cell(2, 2).unwrap().set_text("San Francisco");

        tbl.cell(3, 0).unwrap().set_text("Carol Davis");
        tbl.cell(3, 1).unwrap().set_text("Designer");
        tbl.cell(3, 2).unwrap().set_text("London");
    }

    doc.add_paragraph("");

    // --- Table with cell merging ---
    doc.add_paragraph("Table with Cell Merging & Vertical Alignment")
        .style("Heading2");

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

        // Header spanning all columns
        tbl.cell(0, 0).unwrap().set_text("Quarterly Revenue Report");
        tbl.cell(0, 0).unwrap().shading("1F4E79");
        tbl.cell(0, 0).unwrap().grid_span(4);

        // Sub-header
        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");

        // Data
        tbl.cell(2, 0).unwrap().set_text("North America");
        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");

        tbl.cell(3, 0).unwrap().set_text("Europe");
        tbl.cell(3, 1).unwrap().set_text("$1.8M");
        tbl.cell(3, 2).unwrap().set_text("$2.0M");
        tbl.cell(3, 3).unwrap().set_text("$3.8M");

        // Vertical alignment on data cells
        tbl.cell(2, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Center);
        tbl.cell(3, 3)
            .unwrap()
            .vertical_alignment(VerticalAlignment::Bottom);
    }

    doc.add_paragraph("");

    // --- Table with vertical merge ---
    doc.add_paragraph("Table with Vertical Merge")
        .style("Heading2");

    {
        let mut tbl = doc.add_table(4, 3);
        tbl = tbl.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");

        // "Hardware" spans rows 1-2
        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");

        // "Software" on row 3
        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("");

    // --- Nested table ---
    doc.add_paragraph("Nested Table").style("Heading2");

    {
        let mut tbl = doc.add_table(2, 2);
        tbl = tbl.borders(BorderStyle::Single, 6, "2E75B6");

        tbl.cell(0, 0).unwrap().set_text("Outer Cell (0,0)");
        tbl.cell(0, 1).unwrap().set_text("Outer Cell (0,1)");
        tbl.cell(1, 0).unwrap().set_text("Outer Cell (1,0)");

        // Nested table inside cell (1,1)
        {
            let mut cell = tbl.cell(1, 1).unwrap();
            cell.set_text("Contains nested table:");
            let mut nested = cell.add_table(2, 2);
            nested = nested.borders(BorderStyle::Single, 2, "FF6600");
            nested.cell(0, 0).unwrap().set_text("Inner A");
            nested.cell(0, 1).unwrap().set_text("Inner B");
            nested.cell(1, 0).unwrap().set_text("Inner C");
            nested.cell(1, 1).unwrap().set_text("Inner D");
        }
    }

    // =========================================================================
    // PAGE 5: IMAGES
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("4. Images").style("Heading1");

    doc.add_paragraph("Inline Image").style("Heading2");

    doc.add_paragraph("Below is an inline image (200x50 pixels, blue gradient):");
    let inline_img = create_sample_png(200, 50, [0, 80, 200]);
    doc.add_picture(
        &inline_img,
        "inline_chart.png",
        Length::inches(3.0),
        Length::inches(0.75),
    );

    doc.add_paragraph("");

    doc.add_paragraph("Header Image").style("Heading2");

    // Replace the text-only header with an image header
    let header_img = create_sample_png(400, 40, [40, 40, 40]);
    doc.set_header_image(
        &header_img,
        "header_logo.png",
        Length::inches(2.0),
        Length::inches(0.2),
    );

    doc.add_paragraph(
        "The document header has been replaced with an inline image. \
         Check the header area at the top of this page.",
    );

    doc.add_paragraph("");
    doc.add_paragraph(
        "Note: The cover page uses a full-page background image behind the text, \
         demonstrated on page 1 via add_background_image().",
    );

    // =========================================================================
    // PAGE 6: CONTENT MANIPULATION — placeholder replacement, insertion
    // =========================================================================
    doc.add_paragraph("").page_break_before(true);

    doc.add_paragraph("5. Content Manipulation")
        .style("Heading1");

    // --- Placeholder replacement ---
    doc.add_paragraph("Placeholder Replacement")
        .style("Heading2");

    doc.add_paragraph(
        "Before replacement, this document contained {{customer}} and {{date}} placeholders.",
    );

    {
        let mut p = doc.add_paragraph("");
        p.add_run("Customer: ").bold(true);
        p.add_run("{{customer}}");
    }
    {
        let mut p = doc.add_paragraph("");
        p.add_run("Date: ").bold(true);
        p.add_run("{{date}}");
    }
    doc.add_paragraph("Reference: {{ref_number}}");

    // Table with placeholders
    {
        let mut tbl = doc.add_table(3, 2);
        tbl = tbl.borders(BorderStyle::Single, 4, "000000");
        tbl.cell(0, 0).unwrap().set_text("Field");
        tbl.cell(0, 0).unwrap().shading("D6E4F0");
        tbl.cell(0, 1).unwrap().set_text("Value");
        tbl.cell(0, 1).unwrap().shading("D6E4F0");
        tbl.cell(1, 0).unwrap().set_text("Project");
        tbl.cell(1, 1).unwrap().set_text("{{project}}");
        tbl.cell(2, 0).unwrap().set_text("Status");
        tbl.cell(2, 1).unwrap().set_text("{{status}}");
    }

    // Perform replacements
    let mut replacements = HashMap::new();
    replacements.insert("{{customer}}", "Acme Corporation");
    replacements.insert("{{date}}", "February 22, 2026");
    replacements.insert("{{ref_number}}", "REF-2026-001");
    replacements.insert("{{project}}", "Infrastructure Upgrade");
    replacements.insert("{{status}}", "In Progress");
    let replace_count = doc.replace_all(&replacements);

    doc.add_paragraph("");
    doc.add_paragraph(&format!(
        "(Replaced {} placeholders above — in body text and table cells)",
        replace_count
    ));

    doc.add_paragraph("");

    // --- Content insertion ---
    doc.add_paragraph("Content Insertion").style("Heading2");

    doc.add_paragraph("Section A: First section of content.");
    doc.add_paragraph("Section C: Third section of content.");

    // Insert "Section B" between A and C
    if let Some(idx) = doc.find_content_index("Section C") {
        doc.insert_paragraph(
            idx,
            "Section B: Inserted between A and C using find_content_index().",
        );
    }

    doc.add_paragraph("");
    doc.add_paragraph(
        "The paragraph above ('Section B') was inserted at a specific position \
         using find_content_index() + insert_paragraph().",
    );

    // =========================================================================
    // PAGE 7: LANDSCAPE — section break, wide table
    // =========================================================================
    doc.add_paragraph("").section_break(SectionBreak::NextPage);

    doc.add_paragraph("6. Mixed Page Orientation")
        .style("Heading1");

    doc.add_paragraph(
        "This page is in LANDSCAPE orientation. It was created using a section break \
         followed by section_landscape(). This is useful for wide tables or charts.",
    );

    doc.add_paragraph("");

    // Wide table for landscape
    {
        let mut tbl = doc.add_table(4, 7);
        tbl = tbl.borders(BorderStyle::Single, 4, "2E75B6");

        let headers = ["Region", "Jan", "Feb", "Mar", "Apr", "May", "Total"];
        for (col, h) in headers.iter().enumerate() {
            tbl.cell(0, col).unwrap().set_text(h);
            tbl.cell(0, col).unwrap().shading("2E75B6");
        }

        let data = [
            [
                "North America",
                "$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",
            ],
            [
                "Asia Pacific",
                "$0.5M",
                "$0.6M",
                "$0.7M",
                "$0.7M",
                "$0.8M",
                "$3.3M",
            ],
        ];
        for (row_idx, row_data) in data.iter().enumerate() {
            for (col, val) in row_data.iter().enumerate() {
                tbl.cell(row_idx + 1, col).unwrap().set_text(val);
            }
        }
    }

    // End landscape, return to portrait
    doc.add_paragraph("")
        .section_break(SectionBreak::NextPage)
        .section_landscape();

    // =========================================================================
    // PAGE 8: BACK TO PORTRAIT — styles, final notes
    // =========================================================================
    doc.add_paragraph("7. Custom Styles & Summary")
        .style("Heading1");

    doc.add_paragraph(
        "This final page is back in portrait orientation after a section break. \
         The document has demonstrated:",
    );

    doc.add_bullet_list_item(
        "Page setup: size, margins, header/footer distance, gutter",
        0,
    );
    doc.add_bullet_list_item("Document metadata: title, author, subject, keywords", 0);
    doc.add_bullet_list_item("Headers and footers: text, images, different first page", 0);
    doc.add_bullet_list_item("Background images: full-page behind text", 0);
    doc.add_bullet_list_item(
        "Text formatting: bold, italic, underline, strike, color, size, font",
        0,
    );
    doc.add_bullet_list_item(
        "Advanced run formatting: superscript, subscript, caps, spacing",
        0,
    );
    doc.add_bullet_list_item(
        "Paragraph formatting: alignment, borders, shading, spacing, indentation",
        0,
    );
    doc.add_bullet_list_item("Bullet and numbered lists with nesting levels", 0);
    doc.add_bullet_list_item("Tab stops with dot/underscore leaders", 0);
    doc.add_bullet_list_item(
        "Tables: borders, shading, column spans, row spans, nesting",
        0,
    );
    doc.add_bullet_list_item("Vertical alignment in table cells", 0);
    doc.add_bullet_list_item("Inline images", 0);
    doc.add_bullet_list_item("Placeholder replacement in body and table cells", 0);
    doc.add_bullet_list_item("Content insertion at specific positions", 0);
    doc.add_bullet_list_item(
        "Section breaks with mixed portrait/landscape orientation",
        0,
    );

    doc.add_paragraph("");
    doc.add_paragraph("All features above were built entirely from scratch using the rdocx API.")
        .alignment(Alignment::Center)
        .shading("E2EFDA")
        .border_all(BorderStyle::Single, 2, "00AA00");

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

examples/generate_all_samples.rs (line 529)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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 536)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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
3. Bundled fonts (if bundled-fonts feature is enabled)

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");

    match doc.to_pdf() {
        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/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_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
4. Bundled fonts (if bundled-fonts feature is enabled)

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 72)

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");

    match doc.to_pdf() {
        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 77)

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");

    match doc.to_pdf() {
        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_all_pages(&self, dpi: f64) -> Result<Vec<Vec<u8>>>

Render all pages of the document to PNG bytes.

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 616)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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 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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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 617)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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 618)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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 615)

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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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 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({
                let mut ppr = rdocx_oxml::properties::CT_PPr::default();
                ppr.shading = Some(rdocx_oxml::properties::CT_Shd {
                    val: "clear".to_string(),
                    color: None,
                    fill: Some("FFF2CC".to_string()),
                });
                ppr
            })
            .run_properties({
                let mut rpr = rdocx_oxml::properties::CT_RPr::default();
                rpr.bold = Some(true);
                rpr.color = Some("C45911".to_string());
                rpr
            }),
    );
    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.