${issue.description}
${issue.wcag_criterion ? `
WCAG ${issue.wcag_criterion}
` : ''}
@@ -223,3 +235,133 @@ async function applyFixes() {
btn.innerHTML = '
Retry Auto-Fix';
}
}
+
+function viewOnPage(pageNum, markerNum) {
+ const card = document.getElementById('pageViewerCard');
+ if (card) {
+ card.style.display = 'block';
+ card.scrollIntoView({ behavior: 'smooth', block: 'start' });
+ }
+ loadVisualPage(pageNum);
+ setTimeout(() => highlightMarker(markerNum), 300);
+}
+
+function displayScoreBreakdown(breakdown) {
+ const el = document.getElementById('scoreBreakdown');
+ if (!el || !breakdown) return;
+
+ const pct = breakdown.checks_total > 0
+ ? Math.round(100 * breakdown.checks_passed / breakdown.checks_total)
+ : 0;
+
+ el.innerHTML = `
+
+ ${breakdown.checks_passed} of ${breakdown.checks_total} checks passed · Base: ${breakdown.base_score}% · Penalty: −${breakdown.penalty} · Score: ${breakdown.final_score}
+
+ | Check | Result |
|---|
+
+ ${breakdown.per_check.map(c => `
+
+ | ${c.name} |
+
+ ${c.passed ? '✓ Pass' : '✗ Fail'}
+ |
+
`).join('')}
+
+
+ `;
+}
+
+function displayMatterhorn(summary) {
+ const card = document.getElementById('matterhornCard');
+ const banner = document.getElementById('matterhornBanner');
+ const body = document.getElementById('matterhornBody');
+ if (!card || !summary) return;
+
+ card.style.display = 'block';
+
+ banner.innerHTML = summary.overall_passed
+ ? `
✅ PDF/UA-1 requirements fulfilled
`
+ : `
❌ PDF/UA-1 requirements NOT fulfilled
`;
+
+ const sections = [
+ { label: 'Basic Requirements', ids: ['01','02','03','04','05','06','07','08'] },
+ { label: 'Logical Structure', ids: ['09','10','11','12','13','14','15','16','17','18','19','20'] },
+ { label: 'Document Elements', ids: ['21','22','23','24','25','26','27','28','29','30','31'] },
+ ];
+
+ const cpMap = {};
+ summary.checkpoints.forEach(cp => { cpMap[cp.id] = cp; });
+
+ let html = '';
+ sections.forEach(section => {
+ html += ``;
+ section.ids.forEach(id => {
+ const cp = cpMap[id];
+ if (!cp) return;
+ const statusHtml = cp.status === 'PASS'
+ ? `
✓ PASS`
+ : cp.status === 'FAIL'
+ ? `
✗ FAIL`
+ : `
— Not tested`;
+ const howBadge = cp.how === 'M'
+ ? `
M`
+ : `
H`;
+ html += `
+ | CP${cp.id} ${cp.name} |
+ ${howBadge} |
+ ${statusHtml} |
+
`;
+ });
+ });
+ body.innerHTML = html;
+}
+
+async function dismissIssue(globalIndex) {
+ try {
+ const resp = await fetch('api.php?action=dismiss', {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ job_id: currentJobId, issue_index: globalIndex })
+ });
+ const result = await resp.json();
+ if (result.success) {
+ dismissedIndices.add(globalIndex);
+ const el = document.getElementById('issue-g' + globalIndex);
+ if (el) {
+ el.classList.add('dismissed');
+ el.querySelector('.issue-description').style.textDecoration = 'line-through';
+ const btn = el.querySelector('.btn-dismiss');
+ if (btn) { btn.className = 'btn-undismiss'; btn.textContent = 'Restore'; btn.setAttribute('onclick', `undismissIssue(${globalIndex})`); }
+ }
+ updateDismissCount();
+ }
+ } catch(e) { console.error('Dismiss failed:', e); }
+}
+
+async function undismissIssue(globalIndex) {
+ try {
+ const resp = await fetch('api.php?action=undismiss', {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ job_id: currentJobId, issue_index: globalIndex })
+ });
+ const result = await resp.json();
+ if (result.success) {
+ dismissedIndices.delete(globalIndex);
+ const el = document.getElementById('issue-g' + globalIndex);
+ if (el) {
+ el.classList.remove('dismissed');
+ el.querySelector('.issue-description').style.textDecoration = '';
+ const btn = el.querySelector('.btn-undismiss');
+ if (btn) { btn.className = 'btn-dismiss'; btn.textContent = 'Dismiss'; btn.setAttribute('onclick', `dismissIssue(${globalIndex})`); }
+ }
+ updateDismissCount();
+ }
+ } catch(e) { console.error('Undismiss failed:', e); }
+}
+
+function updateDismissCount() {
+ const countEl = document.getElementById('dismissedCount');
+ if (countEl) countEl.textContent = dismissedIndices.size;
+}
diff --git a/js/upload.js b/js/upload.js
index 6e40b8c..77bc235 100644
--- a/js/upload.js
+++ b/js/upload.js
@@ -56,8 +56,8 @@ async function handleFile(file) {
currentJobId = result.data.job_id;
updateProgress(20, 'Upload complete');
addLog('Upload successful — Job ID: ' + currentJobId, 'success');
- await new Promise(r => setTimeout(r, 500));
- beginCheck();
+ document.getElementById('progressContainer').style.display = 'none';
+ showReadyState(file);
} else {
addLog('Upload failed: ' + result.error, 'error');
alert('Upload failed: ' + result.error);
@@ -70,7 +70,29 @@ async function handleFile(file) {
}
}
+function showReadyState(file) {
+ const readyDiv = document.getElementById('uploadReadyState');
+ if (!readyDiv) return;
+ document.getElementById('readyFilename').textContent = file.name;
+ document.getElementById('readyFilesize').textContent = (file.size / 1024 / 1024).toFixed(2) + ' MB';
+ readyDiv.style.display = 'block';
+ document.getElementById('singleUploadArea').querySelector('.upload-area').style.display = 'none';
+}
+
+function removeFile() {
+ currentJobId = null;
+ const readyDiv = document.getElementById('uploadReadyState');
+ if (readyDiv) readyDiv.style.display = 'none';
+ document.getElementById('singleUploadArea').querySelector('.upload-area').style.display = '';
+ document.getElementById('fileInput').value = '';
+ clearLog();
+}
+
async function beginCheck() {
+ // Hide ready state, show progress
+ const readyDiv = document.getElementById('uploadReadyState');
+ if (readyDiv) readyDiv.style.display = 'none';
+ document.getElementById('progressContainer').style.display = 'block';
updateProgress(25, 'Initializing accessibility check...');
addLog('Preparing accessibility analysis...', 'info');
@@ -186,6 +208,10 @@ function resetCheck() {
document.getElementById('progressContainer').style.display = 'none';
document.getElementById('pageViewerCard').style.display = 'none';
document.getElementById('fileInput').value = '';
+ var readyDiv = document.getElementById('uploadReadyState');
+ if (readyDiv) readyDiv.style.display = 'none';
+ var uploadArea = document.getElementById('singleUploadArea') && document.getElementById('singleUploadArea').querySelector('.upload-area');
+ if (uploadArea) uploadArea.style.display = '';
var remCard = document.getElementById('remediationCard');
if (remCard) remCard.style.display = 'none';
currentJobId = null;
diff --git a/pdf_remediation.py b/pdf_remediation.py
index d2011cb..d6f21b2 100755
--- a/pdf_remediation.py
+++ b/pdf_remediation.py
@@ -347,30 +347,31 @@ def main():
args = parser.parse_args()
- print(f"🔧 PDF Accessibility Remediation")
- print(f"📄 File: {args.pdf_file}")
- print(f"{'='*60}\n")
+ sys.stderr.write(f"PDF Accessibility Remediation\n")
+ sys.stderr.write(f"File: {args.pdf_file}\n")
+ sys.stderr.write(f"{'='*60}\n\n")
# Analyze
remediator = PDFRemediator(args.pdf_file)
suggestions = remediator.analyze_and_suggest_fixes()
- print("📋 Analysis Complete")
- print(f"{'='*60}")
+ sys.stderr.write("Analysis Complete\n")
+ sys.stderr.write(f"{'='*60}\n")
all_suggestions = []
for category, fixes in suggestions.items():
if fixes:
- print(f"\n{category.upper()} Fixes Available:")
+ sys.stderr.write(f"\n{category.upper()} Fixes Available:\n")
for fix in fixes:
- print(f" {'✅' if fix['auto_fixable'] else '⚠️ '} {fix['description']}")
- print(f" Severity: {fix['severity']}")
- print(f" Suggestion: {fix['suggestion']}")
+ fixable_marker = "[auto]" if fix['auto_fixable'] else "[manual]"
+ sys.stderr.write(f" {fixable_marker} {fix['description']}\n")
+ sys.stderr.write(f" Severity: {fix['severity']}\n")
+ sys.stderr.write(f" Suggestion: {fix['suggestion']}\n")
all_suggestions.append(fix['id'])
if not all_suggestions:
- print("\n✅ No automatic fixes needed!")
- return
+ sys.stderr.write("\nNo automatic fixes needed!\n")
+ sys.exit(0)
# Determine which fixes to apply
fixes_to_apply = []
@@ -411,47 +412,63 @@ def main():
fixes_to_apply.append('mark_tagged')
if not fixes_to_apply:
- print("\n⚠️ No fixes specified. Use --all or specify individual fixes.")
- print(" Example: python pdf_remediation.py file.pdf --title 'My Document' --language en-US")
- return
+ sys.stderr.write("\nNo fixes specified. Use --all or specify individual fixes.\n")
+ sys.stderr.write(" Example: python pdf_remediation.py file.pdf --title 'My Document' --language en-US\n")
+ sys.exit(1)
+
+ # Validate output path parent directory exists (or create it)
+ output_path = args.output
+ if output_path:
+ output_dir = Path(output_path).parent
+ if not output_dir.exists():
+ try:
+ output_dir.mkdir(parents=True, exist_ok=True)
+ sys.stderr.write(f"Created output directory: {output_dir}\n")
+ except OSError as e:
+ sys.stderr.write(f"Error: Cannot create output directory '{output_dir}': {e}\n")
+ sys.exit(1)
# Apply fixes
- print(f"\n{'='*60}")
- print("🔧 Applying Fixes...")
- print(f"{'='*60}\n")
+ sys.stderr.write(f"\n{'='*60}\n")
+ sys.stderr.write("Applying Fixes...\n")
+ sys.stderr.write(f"{'='*60}\n\n")
- result = remediator.apply_fixes(fixes_to_apply, args.output, custom_values)
+ result = remediator.apply_fixes(fixes_to_apply, output_path, custom_values)
if result['success']:
- print("✅ Remediation Complete!")
- print(f"\n📄 Output: {result['output_path']}")
- print(f"\n🔧 Fixes Applied:")
+ sys.stderr.write("Remediation Complete!\n")
+ sys.stderr.write(f"\nOutput: {result['output_path']}\n")
+ sys.stderr.write("\nFixes Applied:\n")
for fix in result['fixes_applied']:
- print(f" ✓ {fix}")
+ sys.stderr.write(f" - {fix}\n")
# Optionally run veraPDF validation on result
- if os.isatty(sys.stdout.fileno()): # Only if running interactively (not from web)
- print(f"\n{'='*60}")
- print("🔍 Validating Remediated PDF with veraPDF...")
- print(f"{'='*60}\n")
+ if os.isatty(sys.stderr.fileno()): # Only if running interactively (not from web)
+ sys.stderr.write(f"\n{'='*60}\n")
+ sys.stderr.write("Validating Remediated PDF with veraPDF...\n")
+ sys.stderr.write(f"{'='*60}\n\n")
validator = VeraPDFValidator()
validation = validator.validate(result['output_path'])
if 'error' not in validation:
- print(f"PDF/UA Compliance: {'✅ PASS' if validation['compliant'] else '❌ FAIL'}")
- print(f"Passed Rules: {validation['passed_rules']}")
- print(f"Failed Rules: {validation['failed_rules']}")
+ compliant_str = "PASS" if validation['compliant'] else "FAIL"
+ sys.stderr.write(f"PDF/UA Compliance: {compliant_str}\n")
+ sys.stderr.write(f"Passed Rules: {validation['passed_rules']}\n")
+ sys.stderr.write(f"Failed Rules: {validation['failed_rules']}\n")
if validation['errors']:
- print(f"\nRemaining Issues ({len(validation['errors'])}):")
+ sys.stderr.write(f"\nRemaining Issues ({len(validation['errors'])}):\n")
for i, error in enumerate(validation['errors'][:10], 1):
- print(f" {i}. Clause {error['clause']}: {error['description'][:80]}...")
+ sys.stderr.write(f" {i}. Clause {error['clause']}: {error['description'][:80]}...\n")
if len(validation['errors']) > 10:
- print(f" ... and {len(validation['errors']) - 10} more")
+ sys.stderr.write(f" ... and {len(validation['errors']) - 10} more\n")
+
+ sys.exit(0)
else:
- print("❌ Remediation failed")
+ sys.stderr.write("Remediation failed\n")
+ sys.exit(1)
if __name__ == "__main__":
diff --git a/report_generator.py b/report_generator.py
index 20c24c2..40701bd 100644
--- a/report_generator.py
+++ b/report_generator.py
@@ -226,10 +226,176 @@ def generate_html(data: dict) -> str:
return html
+def generate_pdf(data: dict) -> bytes:
+ """Generate a PAC-style PDF report using WeasyPrint."""
+ try:
+ from weasyprint import HTML, CSS
+ except ImportError:
+ raise RuntimeError("WeasyPrint not installed. Run: pip install weasyprint>=60.0")
+
+ score = data.get("accessibility_score", 0)
+ grade = grade_from_score(score)
+ sc = data.get("severity_counts", {})
+ issues = data.get("issues", [])
+ checks = data.get("checks_performed", [])
+ filename = data.get("filename", "Unknown")
+ total_pages = data.get("total_pages", 0)
+ now = datetime.now().strftime("%Y-%m-%d %H:%M")
+
+ matterhorn = data.get("matterhorn_summary", {})
+ breakdown = data.get("score_breakdown", {})
+
+ score_color = "#059669" if score >= 80 else "#d97706" if score >= 60 else "#dc2626"
+
+ sections_html = ""
+
+ # Matterhorn checkpoints table
+ if matterhorn and matterhorn.get("checkpoints"):
+ mh_rows = ""
+ for cp in matterhorn["checkpoints"]:
+ status = cp["status"]
+ if status == "PASS":
+ status_cell = '
PASS | '
+ elif status == "FAIL":
+ status_cell = '
FAIL | '
+ else:
+ status_cell = '
— | '
+ mh_rows += f'
| CP{cp["id"]} {cp["name"]} | {cp["how"]} | {status_cell}
'
+
+ overall = "FULFILLED" if matterhorn.get("overall_passed") else "NOT FULFILLED"
+ overall_cls = "pass" if matterhorn.get("overall_passed") else "fail"
+ sections_html += f"""
+
+
Matterhorn Protocol — PDF/UA-1
+
PDF/UA-1 requirements: {overall}
+
+ | Checkpoint | How | Status |
|---|
+ {mh_rows}
+
+
"""
+
+ # Issues table
+ if issues:
+ issue_rows = ""
+ for iss in issues:
+ sev = iss.get("severity", "INFO")
+ issue_rows += f"""
+ | {sev} |
+ {iss.get("category", "")} |
+ {iss.get("page_number") or "—"} |
+ {iss.get("description", "")} |
+
"""
+ sections_html += f"""
+
+
Issues ({len(issues)})
+
+ | Severity | Category | Page | Description |
|---|
+ {issue_rows}
+
+
"""
+
+ html_content = f"""
+
+
+
+
+
+
+
+
+
+
{score}
+
+
Accessibility Score — Grade {grade}
+
{sc.get('critical',0)} critical {sc.get('error',0)} errors {sc.get('warning',0)} warnings {sc.get('info',0)} info
+ {f'
{breakdown.get("checks_passed",0)} of {breakdown.get("checks_total",0)} checks passed
' if breakdown else ''}
+
+
+
+
+
{sc.get('critical',0)}
Critical
+
{sc.get('error',0)}
Errors
+
{sc.get('warning',0)}
Warnings
+
+
+
+ {sections_html}
+
+
+
+"""
+
+ pdf_bytes = HTML(string=html_content).write_pdf()
+ return pdf_bytes
+
+
def main():
- parser = argparse.ArgumentParser(description="Generate HTML accessibility report")
+ parser = argparse.ArgumentParser(
+ description="HTML Report Generator — converts JSON accessibility results to standalone HTML."
+ )
parser.add_argument("--input", "-i", required=True, help="Input JSON results file")
- parser.add_argument("--output", "-o", help="Output HTML file (default: stdout)")
+ parser.add_argument("--output", "-o", help="Output file (default: stdout)")
+ parser.add_argument("--format", "-f", choices=["html", "pdf"], default="html", help="Output format: html (default) or pdf")
args = parser.parse_args()
input_path = Path(args.input)
@@ -240,14 +406,24 @@ def main():
with open(input_path) as f:
data = json.load(f)
- html = generate_html(data)
-
- if args.output:
- with open(args.output, "w") as f:
- f.write(html)
- print(f"Report saved to {args.output}", file=sys.stderr)
+ if args.format == "pdf":
+ pdf_bytes = generate_pdf(data)
+ if args.output:
+ output_path = Path(args.output)
+ output_path.parent.mkdir(parents=True, exist_ok=True)
+ output_path.write_bytes(pdf_bytes)
+ print(f"Report saved to {args.output}", file=sys.stderr)
+ else:
+ sys.stdout.buffer.write(pdf_bytes)
else:
- print(html)
+ html = generate_html(data)
+ if args.output:
+ output_path = Path(args.output)
+ output_path.parent.mkdir(parents=True, exist_ok=True)
+ output_path.write_text(html, encoding="utf-8")
+ print(f"Report saved to {args.output}", file=sys.stderr)
+ else:
+ sys.stdout.write(html)
if __name__ == "__main__":
diff --git a/requirements.txt b/requirements.txt
index 803cc81..8802f1f 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -30,3 +30,4 @@ python-dotenv>=1.0.0 # For environment variable management
# Infrastructure (Docker stack)
redis>=5.0.0
psycopg2-binary>=2.9.0
+weasyprint>=60.0