pyplaykit 1.4.0__tar.gz → 1.5.0__tar.gz

{pyplaykit-1.4.0/pyplaykit.egg-info → pyplaykit-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyplaykit
-Version: 1.4.0
+Version: 1.5.0
 Summary: Enterprise Python + Playwright automation framework
 Author-email: Shan Konduru <shankonduru@gmail.com>
 License: MIT
@@ -49,10 +49,11 @@ PyPlayKit is a **multi-project enterprise test automation framework** built with
 - 👥 **Scalable**: Designed for 50-100 QE engineers working simultaneously
 - 🎯 **Zero Merge Conflicts**: Project-first organization eliminates conflicts
 - 📊 **Data Comparison**: File-to-File, File-to-DB, DB-to-File validation (Excel, CSV, JSON)
+- 📈 **Interactive HTML Reports**: Filterable validation reports with KPIs ⭐ **NEW**
 - 📚 **Comprehensive Documentation**: 8,700+ lines across 15+ guides
 - 🔧 **Extensible**: Plugin architecture with orchestration support
 - 🔍 **Self-Healing**: Locator recovery with fallback chains
-- 📈 **Observable**: Comprehensive metrics and reporting
+- 🔭 **Observable**: Comprehensive metrics and reporting
 
 ---
 
@@ -509,6 +510,42 @@ pytest examples/data_comparison_examples.py -v -s
 pytest examples/data_comparison_examples.py::test_excel_to_excel_basic -v -s
 ```
 
+### Interactive HTML Reports ⭐ **NEW**
+
+Generate filterable, searchable HTML validation reports:
+
+```python
+from utils.data_comparison_report import DataComparisonReport
+
+# Initialize report
+report = DataComparisonReport()
+report.set_comparison_type("FILE_TO_FILE (Excel)")
+report.set_source("baseline.xlsx", 100)
+report.set_target("current.xlsx", 100)
+
+# Add mismatch
+report.add_mismatch(
+    mismatch_type="VALUE_MISMATCH",
+    row_index=5,
+    mismatching_fields=["Price"],
+    source_value=99.99,
+    target_value=100.00,
+    reason="Price increased by $0.01"
+)
+
+# Generate interactive HTML report
+report.generate_report("reports/data_validation/report.html")
+```
+
+**Report Features:**
+- 📊 KPI dashboard with pass/fail rates
+- 🔍 Column-level filtering and search
+- 📋 Row-by-row mismatch details
+- 🎨 Color-coded status indicators
+- 📱 Mobile-responsive design
+
+See **[examples/data_comparison_with_html_report.py](examples/data_comparison_with_html_report.py)** for complete examples.
+
 ### Full Documentation
 
 - **[docs/PIP_INSTALL_GUIDE.md](docs/PIP_INSTALL_GUIDE.md#step-8--data-comparison-patterns)** - Complete patterns guide

{pyplaykit-1.4.0 → pyplaykit-1.5.0}/README.md

@@ -13,10 +13,11 @@ PyPlayKit is a **multi-project enterprise test automation framework** built with
 - 👥 **Scalable**: Designed for 50-100 QE engineers working simultaneously
 - 🎯 **Zero Merge Conflicts**: Project-first organization eliminates conflicts
 - 📊 **Data Comparison**: File-to-File, File-to-DB, DB-to-File validation (Excel, CSV, JSON)
+- 📈 **Interactive HTML Reports**: Filterable validation reports with KPIs ⭐ **NEW**
 - 📚 **Comprehensive Documentation**: 8,700+ lines across 15+ guides
 - 🔧 **Extensible**: Plugin architecture with orchestration support
 - 🔍 **Self-Healing**: Locator recovery with fallback chains
-- 📈 **Observable**: Comprehensive metrics and reporting
+- 🔭 **Observable**: Comprehensive metrics and reporting
 
 ---
 
@@ -473,6 +474,42 @@ pytest examples/data_comparison_examples.py -v -s
 pytest examples/data_comparison_examples.py::test_excel_to_excel_basic -v -s
 ```
 
+### Interactive HTML Reports ⭐ **NEW**
+
+Generate filterable, searchable HTML validation reports:
+
+```python
+from utils.data_comparison_report import DataComparisonReport
+
+# Initialize report
+report = DataComparisonReport()
+report.set_comparison_type("FILE_TO_FILE (Excel)")
+report.set_source("baseline.xlsx", 100)
+report.set_target("current.xlsx", 100)
+
+# Add mismatch
+report.add_mismatch(
+    mismatch_type="VALUE_MISMATCH",
+    row_index=5,
+    mismatching_fields=["Price"],
+    source_value=99.99,
+    target_value=100.00,
+    reason="Price increased by $0.01"
+)
+
+# Generate interactive HTML report
+report.generate_report("reports/data_validation/report.html")
+```
+
+**Report Features:**
+- 📊 KPI dashboard with pass/fail rates
+- 🔍 Column-level filtering and search
+- 📋 Row-by-row mismatch details
+- 🎨 Color-coded status indicators
+- 📱 Mobile-responsive design
+
+See **[examples/data_comparison_with_html_report.py](examples/data_comparison_with_html_report.py)** for complete examples.
+
 ### Full Documentation
 
 - **[docs/PIP_INSTALL_GUIDE.md](docs/PIP_INSTALL_GUIDE.md#step-8--data-comparison-patterns)** - Complete patterns guide

{pyplaykit-1.4.0 → pyplaykit-1.5.0/pyplaykit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyplaykit
-Version: 1.4.0
+Version: 1.5.0
 Summary: Enterprise Python + Playwright automation framework
 Author-email: Shan Konduru <shankonduru@gmail.com>
 License: MIT
@@ -49,10 +49,11 @@ PyPlayKit is a **multi-project enterprise test automation framework** built with
 - 👥 **Scalable**: Designed for 50-100 QE engineers working simultaneously
 - 🎯 **Zero Merge Conflicts**: Project-first organization eliminates conflicts
 - 📊 **Data Comparison**: File-to-File, File-to-DB, DB-to-File validation (Excel, CSV, JSON)
+- 📈 **Interactive HTML Reports**: Filterable validation reports with KPIs ⭐ **NEW**
 - 📚 **Comprehensive Documentation**: 8,700+ lines across 15+ guides
 - 🔧 **Extensible**: Plugin architecture with orchestration support
 - 🔍 **Self-Healing**: Locator recovery with fallback chains
-- 📈 **Observable**: Comprehensive metrics and reporting
+- 🔭 **Observable**: Comprehensive metrics and reporting
 
 ---
 
@@ -509,6 +510,42 @@ pytest examples/data_comparison_examples.py -v -s
 pytest examples/data_comparison_examples.py::test_excel_to_excel_basic -v -s
 ```
 
+### Interactive HTML Reports ⭐ **NEW**
+
+Generate filterable, searchable HTML validation reports:
+
+```python
+from utils.data_comparison_report import DataComparisonReport
+
+# Initialize report
+report = DataComparisonReport()
+report.set_comparison_type("FILE_TO_FILE (Excel)")
+report.set_source("baseline.xlsx", 100)
+report.set_target("current.xlsx", 100)
+
+# Add mismatch
+report.add_mismatch(
+    mismatch_type="VALUE_MISMATCH",
+    row_index=5,
+    mismatching_fields=["Price"],
+    source_value=99.99,
+    target_value=100.00,
+    reason="Price increased by $0.01"
+)
+
+# Generate interactive HTML report
+report.generate_report("reports/data_validation/report.html")
+```
+
+**Report Features:**
+- 📊 KPI dashboard with pass/fail rates
+- 🔍 Column-level filtering and search
+- 📋 Row-by-row mismatch details
+- 🎨 Color-coded status indicators
+- 📱 Mobile-responsive design
+
+See **[examples/data_comparison_with_html_report.py](examples/data_comparison_with_html_report.py)** for complete examples.
+
 ### Full Documentation
 
 - **[docs/PIP_INSTALL_GUIDE.md](docs/PIP_INSTALL_GUIDE.md#step-8--data-comparison-patterns)** - Complete patterns guide

{pyplaykit-1.4.0 → pyplaykit-1.5.0}/pyplaykit.egg-info/SOURCES.txt

@@ -58,6 +58,7 @@ utils/api_client.py
 utils/api_test_helper.py
 utils/assertion_helper.py
 utils/auth_manager.py
+utils/data_comparison_report.py
 utils/data_loader.py
 utils/data_source.py
 utils/data_validator.py

{pyplaykit-1.4.0 → pyplaykit-1.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pyplaykit"
-version = "1.4.0"
+version = "1.5.0"
 description = "Enterprise Python + Playwright automation framework"
 readme = "README.md"
 license = { text = "MIT" }

pyplaykit-1.5.0/utils/__init__.py

@@ -0,0 +1,5 @@
+"""Utils package for PyPlayKit framework."""
+
+from utils.data_comparison_report import DataComparisonReport
+
+__all__ = ["DataComparisonReport"]

pyplaykit-1.5.0/utils/data_comparison_report.py

@@ -0,0 +1,487 @@
+"""
+HTML/CSS Data Comparison Report Generator for PyPlayKit.
+
+Generates interactive, filterable HTML reports for data validation scenarios:
+- File-to-File comparison (Excel, CSV, JSON)
+- File-to-Database comparison
+- Database-to-File comparison
+
+Features:
+- Overall validation status with KPIs
+- Validation summary section
+- Filterable/searchable discrepancy table
+- Row-by-row mismatch details
+- Field-level difference highlighting
+"""
+
+from __future__ import annotations
+
+import json
+from datetime import datetime
+from pathlib import Path
+from typing import Any
+
+
+class DataComparisonReport:
+    """Generate interactive HTML reports for data validation results."""
+
+    def __init__(self):
+        self.comparison_type = "UNKNOWN"
+        self.source_name = ""
+        self.target_name = ""
+        self.source_count = 0
+        self.target_count = 0
+        self.passed_count = 0
+        self.failed_count = 0
+        self.source_only_count = 0
+        self.target_only_count = 0
+        self.mismatches: list[dict[str, Any]] = []
+        self.validation_summary = ""
+        self.metadata: dict[str, str] = {}
+
+    def set_comparison_type(self, comp_type: str) -> None:
+        """Set the comparison type (FILE_TO_FILE, FILE_TO_DB, DB_TO_FILE)."""
+        self.comparison_type = comp_type
+
+    def set_source(self, name: str, count: int) -> None:
+        """Set source details."""
+        self.source_name = name
+        self.source_count = count
+
+    def set_target(self, name: str, count: int) -> None:
+        """Set target details."""
+        self.target_name = name
+        self.target_count = count
+
+    def set_counts(self, passed: int, failed: int, source_only: int = 0, target_only: int = 0) -> None:
+        """Set validation result counts."""
+        self.passed_count = passed
+        self.failed_count = failed
+        self.source_only_count = source_only
+        self.target_only_count = target_only
+
+    def add_mismatch(
+        self,
+        mismatch_type: str,
+        row_index: int | None,
+        mismatching_fields: list[str],
+        source_value: Any,
+        target_value: Any,
+        reason: str,
+    ) -> None:
+        """Add a single mismatch record."""
+        self.mismatches.append({
+            "type": mismatch_type,
+            "row": row_index,
+            "mismatching_fields": mismatching_fields,
+            "source_value": self._safe_str(source_value),
+            "target_value": self._safe_str(target_value),
+            "reason": reason,
+        })
+
+    def set_validation_summary(self, summary: str) -> None:
+        """Set the validation summary text."""
+        self.validation_summary = summary
+
+    def add_metadata(self, key: str, value: str) -> None:
+        """Add metadata key-value pair."""
+        self.metadata[key] = value
+
+    def generate_report(self, output_path: str | Path) -> None:
+        """Generate and save the HTML report."""
+        output_path = Path(output_path)
+        output_path.parent.mkdir(parents=True, exist_ok=True)
+
+        html_content = self._build_html()
+
+        with open(output_path, "w", encoding="utf-8") as f:
+            f.write(html_content)
+
+    def _safe_str(self, value: Any) -> str:
+        """Safely convert value to string."""
+        if value is None:
+            return "NULL"
+        if isinstance(value, (dict, list)):
+            return json.dumps(value, default=str)
+        return str(value)
+
+    def _calculate_pass_rate(self) -> float:
+        """Calculate pass rate percentage."""
+        total = self.passed_count + self.failed_count
+        if total == 0:
+            return 0.0
+        return (self.passed_count / total) * 100
+
+    def _calculate_fail_rate(self) -> float:
+        """Calculate fail rate percentage."""
+        total = self.passed_count + self.failed_count
+        if total == 0:
+            return 0.0
+        return (self.failed_count / total) * 100
+
+    def _get_overall_status(self) -> str:
+        """Determine overall validation status."""
+        if self.failed_count == 0 and self.source_only_count == 0 and self.target_only_count == 0:
+            return "PASSED"
+        return "FAILED"
+
+    def _build_html(self) -> str:
+        """Build complete HTML report."""
+        overall_status = self._get_overall_status()
+        pass_rate = self._calculate_pass_rate()
+        fail_rate = self._calculate_fail_rate()
+        generated_timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+
+        # Build mismatch table rows
+        mismatch_rows = ""
+        if not self.mismatches:
+            mismatch_rows = "<tr><td colspan='6' style='text-align:center;color:#15803d;font-weight:600;'>✓ No discrepancies found</td></tr>"
+        else:
+            for idx, mismatch in enumerate(self.mismatches, 1):
+                row_display = str(mismatch["row"]) if mismatch["row"] is not None else "N/A"
+                fields_display = ", ".join(mismatch["mismatching_fields"]) if mismatch["mismatching_fields"] else "N/A"
+
+                mismatch_rows += f"""
+            <tr>
+              <td>{self._escape_html(mismatch['type'])}</td>
+              <td>{row_display}</td>
+              <td>{self._escape_html(fields_display)}</td>
+              <td><div style="max-width:300px;overflow:auto;">{self._escape_html(mismatch['source_value'])}</div></td>
+              <td><div style="max-width:300px;overflow:auto;">{self._escape_html(mismatch['target_value'])}</div></td>
+              <td>{self._escape_html(mismatch['reason'])}</td>
+            </tr>"""
+
+        # Build metadata section
+        metadata_html = ""
+        for key, value in self.metadata.items():
+            metadata_html += f'<div><strong>{self._escape_html(key)}:</strong> {self._escape_html(value)}</div>\n        '
+
+        # Status pill class
+        status_class = "status-pill-success" if overall_status == "PASSED" else "status-pill-danger"
+
+        return f"""<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width,initial-scale=1" />
+  <title>PyPlayKit Data Validation Report</title>
+  <style>
+    :root {{
+      --bg: #f4f7fb;
+      --surface: #ffffff;
+      --line: #d9e2ec;
+      --text: #0f172a;
+      --muted: #475569;
+      --brand: #0b3b66;
+    }}
+
+    * {{ box-sizing: border-box; }}
+
+    body {{
+      margin: 0;
+      font-family: "Segoe UI", Tahoma, sans-serif;
+      color: var(--text);
+      background: radial-gradient(circle at top right, #d9ebff, var(--bg) 35%);
+      min-height: 100vh;
+      display: flex;
+      flex-direction: column;
+    }}
+
+    .page {{
+      max-width: 1400px;
+      width: 100%;
+      margin: 0 auto;
+      padding: 24px;
+      flex: 1;
+    }}
+
+    .brand-header {{
+      background: linear-gradient(130deg, var(--brand), #155a96);
+      color: #fff;
+      border-radius: 14px;
+      padding: 20px;
+      box-shadow: 0 8px 24px rgba(17, 24, 39, 0.12);
+      margin-bottom: 18px;
+    }}
+
+    .brand-title {{ margin: 0; font-size: 30px; letter-spacing: 0.4px; }}
+    .brand-sub {{ margin: 6px 0 0 0; opacity: 0.92; }}
+
+    .status-pill-success {{
+      display: inline-block;
+      margin-top: 14px;
+      padding: 8px 14px;
+      border-radius: 999px;
+      font-weight: 700;
+      color: #0f5132;
+      background: #dcfce7;
+      border: 1px solid #14532d;
+    }}
+
+    .status-pill-danger {{
+      display: inline-block;
+      margin-top: 14px;
+      padding: 8px 14px;
+      border-radius: 999px;
+      font-weight: 700;
+      color: #991b1b;
+      background: #fee2e2;
+      border: 1px solid #7f1d1d;
+    }}
+
+    .kpi-grid {{
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
+      gap: 12px;
+      margin-bottom: 16px;
+    }}
+
+    .kpi-card {{
+      background: var(--surface);
+      border: 1px solid var(--line);
+      border-radius: 12px;
+      padding: 12px 14px;
+      box-shadow: 0 4px 14px rgba(15, 23, 42, 0.05);
+    }}
+
+    .kpi-card.success {{
+      background: #f0fdf4;
+      border-color: #86efac;
+      box-shadow: 0 4px 14px rgba(34, 197, 94, 0.15);
+    }}
+
+    .kpi-card.danger {{
+      background: #fef2f2;
+      border-color: #fca5a5;
+      box-shadow: 0 4px 14px rgba(239, 68, 68, 0.15);
+    }}
+
+    .kpi-card.warning {{
+      background: #fffbeb;
+      border-color: #fcd34d;
+      box-shadow: 0 4px 14px rgba(245, 158, 11, 0.15);
+    }}
+
+    .kpi-label {{
+      color: var(--muted);
+      font-size: 12px;
+      text-transform: uppercase;
+      letter-spacing: 0.4px;
+      margin-bottom: 6px;
+    }}
+
+    .kpi-card.success .kpi-label {{ color: #15803d; }}
+    .kpi-card.danger .kpi-label {{ color: #991b1b; }}
+    .kpi-card.warning .kpi-label {{ color: #92400e; }}
+
+    .kpi-value {{ font-size: 24px; font-weight: 700; line-height: 1; }}
+
+    .kpi-card.success .kpi-value {{ color: #15803d; }}
+    .kpi-card.danger .kpi-value {{ color: #dc2626; }}
+    .kpi-card.warning .kpi-value {{ color: #d97706; }}
+
+    .card {{
+      background: var(--surface);
+      border: 1px solid var(--line);
+      border-radius: 12px;
+      padding: 16px;
+      margin-bottom: 16px;
+    }}
+
+    .meta-grid {{
+      display: grid;
+      grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
+      gap: 8px 16px;
+      color: var(--muted);
+    }}
+
+    .table-wrap {{
+      width: 100%;
+      overflow-x: auto;
+      overflow-y: auto;
+      max-height: 60vh;
+      border: 1px solid var(--line);
+      border-radius: 10px;
+    }}
+
+    table {{
+      width: max-content;
+      min-width: 100%;
+      border-collapse: collapse;
+      font-size: 13px;
+    }}
+
+    th, td {{
+      border: 1px solid #cfd8e3;
+      padding: 8px;
+      text-align: left;
+      vertical-align: top;
+    }}
+
+    th {{
+      background: #eef4fb;
+      position: sticky;
+      top: 0;
+      z-index: 2;
+      font-weight: 600;
+    }}
+
+    .filters th {{
+      background: #f8fafc;
+      padding: 6px;
+      position: sticky;
+      top: 38px;
+      z-index: 1;
+    }}
+
+    .filters input {{
+      width: 100%;
+      border: 1px solid #cbd5e1;
+      border-radius: 6px;
+      padding: 6px 8px;
+      font-size: 12px;
+    }}
+
+    .filters input:focus {{
+      outline: none;
+      border-color: #3b82f6;
+      box-shadow: 0 0 0 3px rgba(59, 130, 246, 0.1);
+    }}
+
+    .footer {{
+      background: #0b3b66;
+      color: #e2ecf7;
+      padding: 16px 24px;
+      text-align: center;
+      font-size: 14px;
+    }}
+
+    .footer a {{
+      color: #f8bf3b;
+      text-decoration: none;
+      font-weight: 600;
+    }}
+
+    .footer a:hover {{
+      text-decoration: underline;
+    }}
+
+    @media (max-width: 720px) {{
+      .brand-title {{ font-size: 24px; }}
+      .filters th {{ top: 74px; }}
+      .kpi-grid {{ grid-template-columns: repeat(auto-fit, minmax(140px, 1fr)); }}
+    }}
+  </style>
+</head>
+<body>
+  <main class="page">
+    <header class="brand-header">
+      <h1 class="brand-title">PyPlayKit Data Validation Report</h1>
+      <p class="brand-sub">Data Comparison & Validation | Automated Reconciliation</p>
+      <span class="{status_class}">{overall_status}</span>
+    </header>
+
+    <section class="kpi-grid">
+      <article class="kpi-card"><div class="kpi-label">Source Count</div><div class="kpi-value">{self.source_count}</div></article>
+      <article class="kpi-card"><div class="kpi-label">Target Count</div><div class="kpi-value">{self.target_count}</div></article>
+      <article class="kpi-card success"><div class="kpi-label">Passed</div><div class="kpi-value">{self.passed_count}</div></article>
+      <article class="kpi-card danger"><div class="kpi-label">Failed</div><div class="kpi-value">{self.failed_count}</div></article>
+      <article class="kpi-card success"><div class="kpi-label">Pass Rate</div><div class="kpi-value">{pass_rate:.2f}%</div></article>
+      <article class="kpi-card danger"><div class="kpi-label">Fail Rate</div><div class="kpi-value">{fail_rate:.2f}%</div></article>
+      <article class="kpi-card warning"><div class="kpi-label">Source Only</div><div class="kpi-value">{self.source_only_count}</div></article>
+      <article class="kpi-card warning"><div class="kpi-label">Target Only</div><div class="kpi-value">{self.target_only_count}</div></article>
+    </section>
+
+    <section class="card">
+      <div class="meta-grid">
+        <div><strong>Comparison Type:</strong> {self.comparison_type}</div>
+        <div><strong>Generated:</strong> {generated_timestamp}</div>
+        <div><strong>Source:</strong> {self._escape_html(self.source_name)}</div>
+        <div><strong>Target:</strong> {self._escape_html(self.target_name)}</div>
+        {metadata_html}
+      </div>
+      <p style="margin-top:12px;"><strong>Summary:</strong> {self._escape_html(self.validation_summary)}</p>
+    </section>
+
+    <section class="card">
+      <h2 style="margin-top:0;">Discrepancy Details</h2>
+      <p style="color: var(--muted); margin-top: -4px;">Use the filter boxes in each column to search and narrow results. Total discrepancies: <strong>{len(self.mismatches)}</strong></p>
+      <div class="table-wrap">
+        <table id="mismatchTable">
+          <thead>
+            <tr>
+              <th>Type</th>
+              <th>Row</th>
+              <th>Mismatching Fields</th>
+              <th>Source Value</th>
+              <th>Target Value</th>
+              <th>Reason</th>
+            </tr>
+            <tr class="filters">
+              <th><input type="text" oninput="filterTable(0, this.value)" placeholder="Filter type" /></th>
+              <th><input type="text" oninput="filterTable(1, this.value)" placeholder="Filter row" /></th>
+              <th><input type="text" oninput="filterTable(2, this.value)" placeholder="Filter fields" /></th>
+              <th><input type="text" oninput="filterTable(3, this.value)" placeholder="Filter source" /></th>
+              <th><input type="text" oninput="filterTable(4, this.value)" placeholder="Filter target" /></th>
+              <th><input type="text" oninput="filterTable(5, this.value)" placeholder="Filter reason" /></th>
+            </tr>
+          </thead>
+          <tbody>
+{mismatch_rows}
+          </tbody>
+        </table>
+      </div>
+    </section>
+  </main>
+
+  <footer class="footer">
+    <div>PyPlayKit Framework - Enterprise Test Automation | Designed by <a href="https://www.linkedin.com/in/shankonduru" target="_blank" rel="noopener noreferrer">ShanKonduru</a></div>
+    <div>Available at <a href="https://github.com/ShanKonduru/pyplaykit" target="_blank" rel="noopener noreferrer">GitHub</a></div>
+  </footer>
+
+  <script>
+    const activeFilters = ["", "", "", "", "", ""];
+
+    function filterTable(columnIndex, searchValue) {{
+      activeFilters[columnIndex] = (searchValue || "").toLowerCase();
+      const table = document.getElementById("mismatchTable");
+      const rows = table.tBodies[0].rows;
+
+      let visibleCount = 0;
+
+      for (let i = 0; i < rows.length; i += 1) {{
+        let showRow = true;
+
+        for (let col = 0; col < activeFilters.length; col += 1) {{
+          const term = activeFilters[col];
+          if (!term) {{
+            continue;
+          }}
+
+          const cell = rows[i].cells[col];
+          const text = (cell ? cell.textContent : "").toLowerCase();
+          if (text.indexOf(term) === -1) {{
+            showRow = false;
+            break;
+          }}
+        }}
+
+        rows[i].style.display = showRow ? "" : "none";
+        if (showRow) visibleCount++;
+      }}
+    }}
+  </script>
+</body>
+</html>"""
+
+    def _escape_html(self, text: str) -> str:
+        """Escape HTML special characters."""
+        if not isinstance(text, str):
+            text = str(text)
+        return (
+            text.replace("&", "&amp;")
+            .replace("<", "&lt;")
+            .replace(">", "&gt;")
+            .replace('"', "&quot;")
+            .replace("'", "&#39;")
+        )