@diegovelasquezweb/a11y-engine 0.11.8 → 0.11.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegovelasquezweb/a11y-engine",
-  "version": "0.11.8",
+  "version": "0.11.12",
   "description": "WCAG 2.2 accessibility audit engine — scanner, analyzer, and report builders",
   "type": "module",
   "license": "MIT",

package/src/index.mjs

@@ -852,10 +852,33 @@ export async function getPDFReport(payload, options = {}) {
     buildPdfAuditLimitations,
   } = await import("./reports/renderers/pdf.mjs");
 
-  const args = { baseUrl: options.baseUrl || "", target: options.target || "WCAG 2.2 AA" };
-  const findings = normalizeForReports(payload).filter(
-    (f) => f.wcagClassification !== "AAA" && f.wcagClassification !== "Best Practice",
-  );
+  const deriveConformanceLevel = () => {
+    const tags = payload?.metadata?.testingMethodology?.axe_tags || payload?.axeTags || [];
+    if (Array.isArray(tags)) {
+      if (tags.includes("wcag2aaa")) return "AAA";
+      if (tags.includes("wcag2aa") || tags.includes("wcag21aa") || tags.includes("wcag22aa")) return "AA";
+      if (tags.includes("wcag2a") || tags.includes("wcag21a") || tags.includes("wcag22a")) return "A";
+    }
+
+    const level = payload?.metadata?.testingMethodology?.conformance_level;
+    if (level === "A" || level === "AA" || level === "AAA") return level;
+    return "AA";
+  };
+
+  const filterByConformance = (finding, conformanceLevel) => {
+    const wcag = finding.wcagClassification;
+    if (wcag === "Best Practice") return false;
+    if (conformanceLevel === "A") return wcag !== "AA" && wcag !== "AAA";
+    if (conformanceLevel === "AA") return wcag !== "AAA";
+    return true;
+  };
+
+  const conformanceLevel = deriveConformanceLevel();
+  const args = {
+    baseUrl: options.baseUrl || "",
+    target: options.target || `WCAG 2.2 ${conformanceLevel}`,
+  };
+  const findings = normalizeForReports(payload).filter((f) => filterByConformance(f, conformanceLevel));
 
   const totals = buildSummary(findings);
   const score = computeComplianceScore(totals);
@@ -943,7 +966,6 @@ export async function getChecklist(options = {}) {
     <nav aria-label="Checklist header">
     <div class="max-w-4xl mx-auto px-4 h-16 flex justify-between items-center">
       <div class="flex items-center gap-3">
-        <div class="px-3 h-10 rounded-lg bg-slate-900 text-white font-bold text-base font-mono flex items-center justify-center shadow-md">a11y</div>
         <h1 class="text-xl font-bold">Manual <span class="text-slate-500">Checklist</span></h1>
       </div>
       <span class="text-sm text-slate-500 font-medium">${escapeHtml(siteLabel)}</span>
@@ -957,9 +979,6 @@ export async function getChecklist(options = {}) {
     </div>
     <div class="flex flex-wrap items-center gap-3 mb-8">
       <div class="flex items-center gap-1.5 text-sm font-semibold"><span class="inline-block w-3 h-3 rounded-full bg-slate-300"></span><span id="count-total">${TOTAL}</span> Total</div>
-      <div class="flex items-center gap-1.5 text-sm font-semibold text-emerald-600"><span class="inline-block w-3 h-3 rounded-full bg-emerald-400"></span><span id="count-pass">0</span> Pass</div>
-      <div class="flex items-center gap-1.5 text-sm font-semibold text-rose-600"><span class="inline-block w-3 h-3 rounded-full bg-rose-400"></span><span id="count-fail">0</span> Fail</div>
-      <div class="flex items-center gap-1.5 text-sm font-semibold text-amber-600"><span class="inline-block w-3 h-3 rounded-full bg-amber-400"></span><span id="count-na">0</span> N/A</div>
       <div class="ml-auto flex items-center gap-2">
         <select id="level-filter" class="${selectClasses}">
           <option value="all">All levels</option>
@@ -972,28 +991,41 @@ export async function getChecklist(options = {}) {
     <div id="checklist-items" class="space-y-4">${cards}</div>
   </main>
   <script>
-    const items = document.querySelectorAll('[data-check]');
-    function updateProgress() {
-      let pass=0,fail=0,na=0;
-      items.forEach(el => { const s=el.dataset.status; if(s==='pass')pass++; else if(s==='fail')fail++; else if(s==='na')na++; });
-      document.getElementById('count-pass').textContent=pass;
-      document.getElementById('count-fail').textContent=fail;
-      document.getElementById('count-na').textContent=na;
+    const items = [...document.querySelectorAll('.manual-card')];
+
+    function toggleCard(button) {
+      const card = button.closest('.manual-card');
+      if (!card) return;
+      const body = card.querySelector('.card-body');
+      const chevron = card.querySelector('.card-chevron');
+      const expanded = card.dataset.collapsed === 'false';
+      const nextExpanded = !expanded;
+      card.dataset.collapsed = nextExpanded ? 'false' : 'true';
+      button.setAttribute('aria-expanded', nextExpanded ? 'true' : 'false');
+      if (body) body.style.gridTemplateRows = nextExpanded ? '1fr' : '0fr';
+      if (chevron) chevron.style.transform = nextExpanded ? 'rotate(180deg)' : 'rotate(0deg)';
     }
-    document.getElementById('level-filter').addEventListener('change',e=>{
-      const v=e.target.value;
-      items.forEach(el=>{el.style.display=(v==='all'||el.dataset.level===v)?'':'none';});
-    });
-    items.forEach(el=>{
-      el.querySelectorAll('[data-action]').forEach(btn=>{
-        btn.addEventListener('click',()=>{
-          const action=btn.dataset.action;
-          el.dataset.status=el.dataset.status===action?'none':action;
-          updateProgress();
-        });
+
+    function setManualState(criterion, newState) {
+      const card = document.getElementById('manual-' + criterion.replace(/\./g, '-'));
+      if (!card) return;
+      const current = card.dataset.state || '';
+      card.dataset.state = current === newState ? '' : newState;
+    }
+
+    function applyFilter() {
+      const select = document.getElementById('level-filter');
+      const value = select ? select.value : 'all';
+      items.forEach((card) => {
+        card.style.display = value === 'all' || card.dataset.level === value ? '' : 'none';
       });
-    });
-    updateProgress();
+    }
+
+    window.toggleCard = toggleCard;
+    window.setManualState = setManualState;
+    const levelFilter = document.getElementById('level-filter');
+    if (levelFilter) levelFilter.addEventListener('change', applyFilter);
+    applyFilter();
   <\/script>
 </body>
 </html>`;

package/src/pipeline/dom-scanner.mjs

@@ -1060,22 +1060,18 @@ async function runPa11yChecks(routeUrl, axeTags, sharedBrowser = null, includeWa
         failureSummary: cleanMessage,
       };
 
-      if (groupedByRule.has(ruleId)) {
-        // Add node to existing violation
-        const existing = groupedByRule.get(ruleId);
-        existing.nodes.push(node);
-        // A confirmed error overrides warning-level needs_verification
-        if (!isWarning) {
-          existing.needs_verification = false;
-        }
+      // Group errors and warnings separately — mixing them loses confirmed findings
+      const groupKey = `${ruleId}::${isWarning ? "warning" : "error"}`;
+
+      if (groupedByRule.has(groupKey)) {
+        groupedByRule.get(groupKey).nodes.push(node);
       } else {
-        // Create new violation for this rule
-        groupedByRule.set(ruleId, {
+        groupedByRule.set(groupKey, {
           id: ruleId,
           impact,
           tags: ["pa11y-check", ...(wcagCriterion ? [`wcag${wcagCriterion.replace(/\./g, "")}`] : [])],
           description: cleanMessage,
-          help: cleanMessage.split(".")[0] || "Accessibility issue detected by HTML CodeSniffer",
+          help: cleanMessage,
           helpUrl: wcagCriterion
             ? `https://www.w3.org/WAI/WCAG21/Understanding/${wcagCriterion.replace(/\./g, "")}`
             : "https://squizlabs.github.io/HTML_CodeSniffer/",

package/src/reports/pdf.mjs

@@ -76,6 +76,29 @@ function parseArgs(argv) {
   return args;
 }
 
+function deriveConformanceLevelFromPayload(payload) {
+  const tags = payload?.metadata?.testingMethodology?.axe_tags || payload?.axeTags || [];
+  if (Array.isArray(tags)) {
+    if (tags.includes("wcag2aaa")) return "AAA";
+    if (tags.includes("wcag2aa") || tags.includes("wcag21aa") || tags.includes("wcag22aa")) return "AA";
+    if (tags.includes("wcag2a") || tags.includes("wcag21a") || tags.includes("wcag22a")) return "A";
+  }
+
+  const level = payload?.metadata?.testingMethodology?.conformance_level;
+  if (level === "A" || level === "AA" || level === "AAA") return level;
+  return "AA";
+}
+
+function filterByConformance(findings, conformanceLevel) {
+  return findings.filter((finding) => {
+    const wcag = finding.wcagClassification;
+    if (wcag === "Best Practice") return false;
+    if (conformanceLevel === "A") return wcag !== "AA" && wcag !== "AAA";
+    if (conformanceLevel === "AA") return wcag !== "AAA";
+    return true;
+  });
+}
+
 /**
  * Constructs the HTML structure specifically tailored for PDF rendering.
  * @param {Object} args - The parsed CLI arguments.
@@ -215,9 +238,11 @@ async function main() {
     process.exit(1);
   }
 
-  const findings = normalizeFindings(inputPayload).filter(
-    (f) => f.wcagClassification !== "AAA" && f.wcagClassification !== "Best Practice",
-  );
+  const conformanceLevel = deriveConformanceLevelFromPayload(inputPayload);
+  if (!args.target || args.target === DEFAULTS.complianceTarget) {
+    args.target = `WCAG 2.2 ${conformanceLevel}`;
+  }
+  const findings = filterByConformance(normalizeFindings(inputPayload), conformanceLevel);
   const html = buildPdfHtml(args, findings);
 
   log.info("Generating professional PDF report...");