@holmdigital/engine 1.4.5 → 1.4.6

package/README.md

@@ -21,6 +21,8 @@ It handles the heavy lifting of:
 - **Regulatory Mapping**: Maps technical failures to EU laws (EN 301 549, EAA).
 - **HTML Structure Validation**: Built-in `html-validate` checks to prevent false positives/negatives.
 - **Internationalization (i18n)**: Supports English (`en`), Swedish (`sv`), German (`de`), French (`fr`), Spanish (`es`), and Dutch (`nl`).
+- **Configurable Severity Threshold**: Fail CI only on critical/high issues (configurable).
+- **Rich Metadata**: Includes scan duration, page title, language, and version info.
 - **Pseudo-Automation**: Automatically generates Playwright/Puppeteer test scripts for manual verification steps.
 - **PDF Reporting**: Generates beautiful, compliant PDF reports out of the box.
 - **TypeScript**: Written in TypeScript with full type definitions included.
@@ -38,33 +40,71 @@ npx hd-a11y-scan <url> [options]
 ```
 
 **Options:**
-- `--lang <code>` - Language code (`en`, `sv`, `de`, `fr`, `es`, `nl`, `en-us`, `en-gb`)
-- `--ci` - Run in CI mode (exit code 1 on failure)
-- `--json` - Output results as JSON
-- `--pdf <path>` - Generate a PDF report
-- `--viewport <size>` - Set viewport size (`mobile`, `tablet`, `desktop`, or custom `1024x768`)
-- `--generate-tests` - Generate Pseudo-Automation tests
-- `--api-key <key>` - API Key for HolmDigital Cloud (sends results to dashboard)
-- `--cloud-url <url>` - Custom URL for HolmDigital Cloud API (default: `https://cloud.holmdigital.se`)
+| Option | Description |
+|--------|-------------|
+| `--lang <code>` | Language code (`en`, `sv`, `de`, `fr`, `es`, `nl`, `en-us`, `en-gb`) |
+| `--threshold <level>` | Severity threshold for compliance (`critical`, `high`, `medium`, `low`). Default: `high` |
+| `--ci` | Run in CI mode (exit code 1 on failure) |
+| `--json` | Output results as JSON |
+| `--pdf <path>` | Generate a PDF report |
+| `--viewport <size>` | Set viewport size (`mobile`, `tablet`, `desktop`, or custom `1024x768`) |
+| `--generate-tests` | Generate Pseudo-Automation tests |
+| `--api-key <key>` | API Key for HolmDigital Cloud |
+| `--cloud-url <url>` | Custom URL for HolmDigital Cloud API |
+
+**Example:**
+```bash
+# Fail only on critical issues in CI
+npx hd-a11y-scan https://example.com --ci --threshold critical
+
+# Full JSON output with metadata
+npx hd-a11y-scan https://example.com --json
+```
+
+## JSON Output
+
+```json
+{
+  "url": "https://example.com",
+  "timestamp": "2026-01-13T17:05:11.749Z",
+  "metadata": {
+    "engineVersion": "1.4.6",
+    "axeCoreVersion": "4.10.2",
+    "standardsVersion": "1.2.2",
+    "scanDuration": 2891,
+    "pageTitle": "Example Domain",
+    "pageLanguage": "en"
+  },
+  "stats": {
+    "passed": 13,
+    "critical": 0,
+    "high": 0,
+    "medium": 2,
+    "low": 0,
+    "total": 2
+  },
+  "score": 90,
+  "complianceStatus": "PASS"
+}
+```
 
 ## Programmatic Usage
 
 ```typescript
 import { RegulatoryScanner, setLanguage } from '@holmdigital/engine';
 
-// Initialize Scanner
 const scanner = new RegulatoryScanner({
   url: 'https://example.com',
-  failOnCritical: false
+  severityThreshold: 'high' // critical, high, medium, low
 });
 
-// Set Language context (optional, defaults to 'en')
 setLanguage('sv');
 
-// Run Scan
 const result = await scanner.scan();
 
 console.log(`Score: ${result.score}`);
+console.log(`Duration: ${result.metadata.scanDuration}ms`);
+console.log(`Passed: ${result.stats.passed}, Failed: ${result.stats.total}`);
 ```
 
 ## License

package/dist/{chunk-VTSEAYGK.mjs → chunk-SH2EU7XX.mjs}

@@ -158,6 +158,10 @@ var RegulatoryScanner = class {
    * Kör en fullständig regulatorisk scan
    */
   async scan() {
+    const startTime = Date.now();
+    let pageTitle;
+    let pageLanguage;
+    let passedCount = 0;
     try {
       await this.initBrowser();
       const page = await this.getPage();
@@ -188,6 +192,8 @@ var RegulatoryScanner = class {
       } catch (e) {
         this.log("Network busy, proceeding with scan anyway...");
       }
+      pageTitle = await page.title();
+      pageLanguage = await page.evaluate(() => document.documentElement.lang || void 0);
       const pageContent = await page.content();
       const htmlValidation = await this.htmlValidator.validate(pageContent);
       if (!htmlValidation.valid) {
@@ -199,7 +205,7 @@ var RegulatoryScanner = class {
       this.log("Axe injected. Running analysis...");
       const axeResults = await page.evaluate(async () => {
         if (!document || !document.documentElement) {
-          return { violations: [] };
+          return { violations: [], passes: [] };
         }
         return await window.axe.run(document, {
           iframes: false
@@ -214,8 +220,10 @@ var RegulatoryScanner = class {
         });
       });
       this.log(`Raw Axe Violations: ${axeResults.violations?.length || 0}`);
+      passedCount = axeResults.passes?.length || 0;
       const regulatoryReports = await this.enrichResults(axeResults);
-      const result = this.generateResultPackage(regulatoryReports);
+      const scanDuration = Date.now() - startTime;
+      const result = this.generateResultPackage(regulatoryReports, passedCount, scanDuration, pageTitle, pageLanguage);
       result.htmlValidation = htmlValidation;
       return result;
     } finally {
@@ -302,8 +310,9 @@ var RegulatoryScanner = class {
     }
     return reports;
   }
-  generateResultPackage(reports) {
+  generateResultPackage(reports, passedCount, scanDuration, pageTitle, pageLanguage) {
     const stats = {
+      passed: passedCount,
       critical: reports.filter((r) => r.holmdigitalInsight.diggRisk === "critical").length,
       high: reports.filter((r) => r.holmdigitalInsight.diggRisk === "high").length,
       medium: reports.filter((r) => r.holmdigitalInsight.diggRisk === "medium").length,
@@ -315,10 +324,35 @@ var RegulatoryScanner = class {
     stats.medium * 5 + // Medium annoyance
     stats.low * 1;
     const score = Math.max(0, 100 - weightedScore);
-    const complianceStatus = stats.total === 0 ? "PASS" : "FAIL";
+    const threshold = this.options.severityThreshold || "high";
+    let complianceStatus = "PASS";
+    switch (threshold) {
+      case "critical":
+        complianceStatus = stats.critical > 0 ? "FAIL" : "PASS";
+        break;
+      case "high":
+        complianceStatus = stats.critical > 0 || stats.high > 0 ? "FAIL" : "PASS";
+        break;
+      case "medium":
+        complianceStatus = stats.critical > 0 || stats.high > 0 || stats.medium > 0 ? "FAIL" : "PASS";
+        break;
+      case "low":
+        complianceStatus = stats.total > 0 ? "FAIL" : "PASS";
+        break;
+    }
+    const axeCore = __require("axe-core");
+    const metadata = {
+      engineVersion: "1.4.6",
+      axeCoreVersion: axeCore.version || "4.10.2",
+      standardsVersion: "1.2.2",
+      scanDuration,
+      pageTitle,
+      pageLanguage
+    };
     return {
       url: this.options.url,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      metadata,
       reports,
       stats,
       score,

package/dist/cli/index.js

@@ -507,6 +507,10 @@ var RegulatoryScanner = class {
    * Kör en fullständig regulatorisk scan
    */
   async scan() {
+    const startTime = Date.now();
+    let pageTitle;
+    let pageLanguage;
+    let passedCount = 0;
     try {
       await this.initBrowser();
       const page = await this.getPage();
@@ -537,6 +541,8 @@ var RegulatoryScanner = class {
       } catch (e) {
         this.log("Network busy, proceeding with scan anyway...");
       }
+      pageTitle = await page.title();
+      pageLanguage = await page.evaluate(() => document.documentElement.lang || void 0);
       const pageContent = await page.content();
       const htmlValidation = await this.htmlValidator.validate(pageContent);
       if (!htmlValidation.valid) {
@@ -548,7 +554,7 @@ var RegulatoryScanner = class {
       this.log("Axe injected. Running analysis...");
       const axeResults = await page.evaluate(async () => {
         if (!document || !document.documentElement) {
-          return { violations: [] };
+          return { violations: [], passes: [] };
         }
         return await window.axe.run(document, {
           iframes: false
@@ -563,8 +569,10 @@ var RegulatoryScanner = class {
         });
       });
       this.log(`Raw Axe Violations: ${axeResults.violations?.length || 0}`);
+      passedCount = axeResults.passes?.length || 0;
       const regulatoryReports = await this.enrichResults(axeResults);
-      const result = this.generateResultPackage(regulatoryReports);
+      const scanDuration = Date.now() - startTime;
+      const result = this.generateResultPackage(regulatoryReports, passedCount, scanDuration, pageTitle, pageLanguage);
       result.htmlValidation = htmlValidation;
       return result;
     } finally {
@@ -651,8 +659,9 @@ var RegulatoryScanner = class {
     }
     return reports;
   }
-  generateResultPackage(reports) {
+  generateResultPackage(reports, passedCount, scanDuration, pageTitle, pageLanguage) {
     const stats = {
+      passed: passedCount,
       critical: reports.filter((r) => r.holmdigitalInsight.diggRisk === "critical").length,
       high: reports.filter((r) => r.holmdigitalInsight.diggRisk === "high").length,
       medium: reports.filter((r) => r.holmdigitalInsight.diggRisk === "medium").length,
@@ -664,10 +673,35 @@ var RegulatoryScanner = class {
     stats.medium * 5 + // Medium annoyance
     stats.low * 1;
     const score = Math.max(0, 100 - weightedScore);
-    const complianceStatus = stats.total === 0 ? "PASS" : "FAIL";
+    const threshold = this.options.severityThreshold || "high";
+    let complianceStatus = "PASS";
+    switch (threshold) {
+      case "critical":
+        complianceStatus = stats.critical > 0 ? "FAIL" : "PASS";
+        break;
+      case "high":
+        complianceStatus = stats.critical > 0 || stats.high > 0 ? "FAIL" : "PASS";
+        break;
+      case "medium":
+        complianceStatus = stats.critical > 0 || stats.high > 0 || stats.medium > 0 ? "FAIL" : "PASS";
+        break;
+      case "low":
+        complianceStatus = stats.total > 0 ? "FAIL" : "PASS";
+        break;
+    }
+    const axeCore = require("axe-core");
+    const metadata = {
+      engineVersion: "1.4.6",
+      axeCoreVersion: axeCore.version || "4.10.2",
+      standardsVersion: "1.2.2",
+      scanDuration,
+      pageTitle,
+      pageLanguage
+    };
     return {
       url: this.options.url,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      metadata,
       reports,
       stats,
       score,
@@ -1094,7 +1128,7 @@ function isValidUrl(urlString) {
 }
 var program = new import_commander.Command();
 program.name("hd-a11y-scan").description("HolmDigital Regulatory Scanner").version("0.1.0");
-program.argument("<url>", "URL to scan").option("--lang <code>", "Language code (en, sv)", "en").option("--ci", "Run in CI/CD mode (exit code 1 on critical failures)").option("--generate-tests", "Generate Pseudo-Automation tests").option("--json", "Output as JSON").option("--pdf <path>", "Generate PDF report to path").option("--viewport <size>", 'Set viewport (e.g. "mobile", "desktop", "1024x768")').option("--api-key <key>", "API key for HolmDigital Cloud authentication").option("--cloud-url <url>", "Cloud API URL", "https://cloud.holmdigital.se").action(async (url, options) => {
+program.argument("<url>", "URL to scan").option("--lang <code>", "Language code (en, sv)", "en").option("--ci", "Run in CI/CD mode (exit code 1 on critical failures)").option("--generate-tests", "Generate Pseudo-Automation tests").option("--json", "Output as JSON").option("--pdf <path>", "Generate PDF report to path").option("--viewport <size>", 'Set viewport (e.g. "mobile", "desktop", "1024x768")').option("--threshold <level>", "Severity threshold for compliance (critical, high, medium, low)", "high").option("--api-key <key>", "API key for HolmDigital Cloud authentication").option("--cloud-url <url>", "Cloud API URL", "https://cloud.holmdigital.se").action(async (url, options) => {
   setLanguage(options.lang);
   if (!isValidUrl(url)) {
     console.error(import_chalk.default.red(`Error: Invalid URL format '${url}'`));
@@ -1122,8 +1156,9 @@ program.argument("<url>", "URL to scan").option("--lang <code>", "Language code
       url,
       failOnCritical: options.ci,
       viewport,
-      silent: options.json
+      silent: options.json,
       // Suppress debug output for JSON mode
+      severityThreshold: options.threshold
     });
     if (spinner) spinner.text = t("cli.analyzing");
     const result = await scanner.scan();

package/dist/cli/index.mjs

@@ -2,7 +2,7 @@
 import {
   PseudoAutomationEngine,
   RegulatoryScanner
-} from "../chunk-VTSEAYGK.mjs";
+} from "../chunk-SH2EU7XX.mjs";
 import {
   getCurrentLang,
   setLanguage,
@@ -351,7 +351,7 @@ function isValidUrl(urlString) {
 }
 var program = new Command();
 program.name("hd-a11y-scan").description("HolmDigital Regulatory Scanner").version("0.1.0");
-program.argument("<url>", "URL to scan").option("--lang <code>", "Language code (en, sv)", "en").option("--ci", "Run in CI/CD mode (exit code 1 on critical failures)").option("--generate-tests", "Generate Pseudo-Automation tests").option("--json", "Output as JSON").option("--pdf <path>", "Generate PDF report to path").option("--viewport <size>", 'Set viewport (e.g. "mobile", "desktop", "1024x768")').option("--api-key <key>", "API key for HolmDigital Cloud authentication").option("--cloud-url <url>", "Cloud API URL", "https://cloud.holmdigital.se").action(async (url, options) => {
+program.argument("<url>", "URL to scan").option("--lang <code>", "Language code (en, sv)", "en").option("--ci", "Run in CI/CD mode (exit code 1 on critical failures)").option("--generate-tests", "Generate Pseudo-Automation tests").option("--json", "Output as JSON").option("--pdf <path>", "Generate PDF report to path").option("--viewport <size>", 'Set viewport (e.g. "mobile", "desktop", "1024x768")').option("--threshold <level>", "Severity threshold for compliance (critical, high, medium, low)", "high").option("--api-key <key>", "API key for HolmDigital Cloud authentication").option("--cloud-url <url>", "Cloud API URL", "https://cloud.holmdigital.se").action(async (url, options) => {
   setLanguage(options.lang);
   if (!isValidUrl(url)) {
     console.error(chalk.red(`Error: Invalid URL format '${url}'`));
@@ -379,8 +379,9 @@ program.argument("<url>", "URL to scan").option("--lang <code>", "Language code
       url,
       failOnCritical: options.ci,
       viewport,
-      silent: options.json
+      silent: options.json,
       // Suppress debug output for JSON mode
+      severityThreshold: options.threshold
     });
     if (spinner) spinner.text = t("cli.analyzing");
     const result = await scanner.scan();

package/dist/index.d.mts

@@ -22,12 +22,23 @@ interface ScannerOptions {
         height: number;
     };
     silent?: boolean;
+    severityThreshold?: 'critical' | 'high' | 'medium' | 'low';
+}
+interface ScanMetadata {
+    engineVersion: string;
+    axeCoreVersion: string;
+    standardsVersion: string;
+    scanDuration: number;
+    pageTitle?: string;
+    pageLanguage?: string;
 }
 interface ScanResult {
     url: string;
     timestamp: string;
+    metadata: ScanMetadata;
     reports: RegulatoryReport[];
     stats: {
+        passed: number;
         critical: number;
         high: number;
         medium: number;
@@ -131,4 +142,4 @@ declare function setLanguage(lang: string): void;
 declare function t(key: LocaleKey, params?: Record<string, string | number>): string;
 declare function getCurrentLang(): string;
 
-export { PseudoAutomationEngine, RegulatoryScanner, type ScanResult, type ScannerOptions, VirtualDOMBuilder, type VirtualDOMConfig, type VirtualNode, getCurrentLang, setLanguage, t };
+export { PseudoAutomationEngine, RegulatoryScanner, type ScanMetadata, type ScanResult, type ScannerOptions, VirtualDOMBuilder, type VirtualDOMConfig, type VirtualNode, getCurrentLang, setLanguage, t };

package/dist/index.d.ts

@@ -22,12 +22,23 @@ interface ScannerOptions {
         height: number;
     };
     silent?: boolean;
+    severityThreshold?: 'critical' | 'high' | 'medium' | 'low';
+}
+interface ScanMetadata {
+    engineVersion: string;
+    axeCoreVersion: string;
+    standardsVersion: string;
+    scanDuration: number;
+    pageTitle?: string;
+    pageLanguage?: string;
 }
 interface ScanResult {
     url: string;
     timestamp: string;
+    metadata: ScanMetadata;
     reports: RegulatoryReport[];
     stats: {
+        passed: number;
         critical: number;
         high: number;
         medium: number;
@@ -131,4 +142,4 @@ declare function setLanguage(lang: string): void;
 declare function t(key: LocaleKey, params?: Record<string, string | number>): string;
 declare function getCurrentLang(): string;
 
-export { PseudoAutomationEngine, RegulatoryScanner, type ScanResult, type ScannerOptions, VirtualDOMBuilder, type VirtualDOMConfig, type VirtualNode, getCurrentLang, setLanguage, t };
+export { PseudoAutomationEngine, RegulatoryScanner, type ScanMetadata, type ScanResult, type ScannerOptions, VirtualDOMBuilder, type VirtualDOMConfig, type VirtualNode, getCurrentLang, setLanguage, t };

package/dist/index.js

@@ -514,6 +514,10 @@ var RegulatoryScanner = class {
    * Kör en fullständig regulatorisk scan
    */
   async scan() {
+    const startTime = Date.now();
+    let pageTitle;
+    let pageLanguage;
+    let passedCount = 0;
     try {
       await this.initBrowser();
       const page = await this.getPage();
@@ -544,6 +548,8 @@ var RegulatoryScanner = class {
       } catch (e) {
         this.log("Network busy, proceeding with scan anyway...");
       }
+      pageTitle = await page.title();
+      pageLanguage = await page.evaluate(() => document.documentElement.lang || void 0);
       const pageContent = await page.content();
       const htmlValidation = await this.htmlValidator.validate(pageContent);
       if (!htmlValidation.valid) {
@@ -555,7 +561,7 @@ var RegulatoryScanner = class {
       this.log("Axe injected. Running analysis...");
       const axeResults = await page.evaluate(async () => {
         if (!document || !document.documentElement) {
-          return { violations: [] };
+          return { violations: [], passes: [] };
         }
         return await window.axe.run(document, {
           iframes: false
@@ -570,8 +576,10 @@ var RegulatoryScanner = class {
         });
       });
       this.log(`Raw Axe Violations: ${axeResults.violations?.length || 0}`);
+      passedCount = axeResults.passes?.length || 0;
       const regulatoryReports = await this.enrichResults(axeResults);
-      const result = this.generateResultPackage(regulatoryReports);
+      const scanDuration = Date.now() - startTime;
+      const result = this.generateResultPackage(regulatoryReports, passedCount, scanDuration, pageTitle, pageLanguage);
       result.htmlValidation = htmlValidation;
       return result;
     } finally {
@@ -658,8 +666,9 @@ var RegulatoryScanner = class {
     }
     return reports;
   }
-  generateResultPackage(reports) {
+  generateResultPackage(reports, passedCount, scanDuration, pageTitle, pageLanguage) {
     const stats = {
+      passed: passedCount,
       critical: reports.filter((r) => r.holmdigitalInsight.diggRisk === "critical").length,
       high: reports.filter((r) => r.holmdigitalInsight.diggRisk === "high").length,
       medium: reports.filter((r) => r.holmdigitalInsight.diggRisk === "medium").length,
@@ -671,10 +680,35 @@ var RegulatoryScanner = class {
     stats.medium * 5 + // Medium annoyance
     stats.low * 1;
     const score = Math.max(0, 100 - weightedScore);
-    const complianceStatus = stats.total === 0 ? "PASS" : "FAIL";
+    const threshold = this.options.severityThreshold || "high";
+    let complianceStatus = "PASS";
+    switch (threshold) {
+      case "critical":
+        complianceStatus = stats.critical > 0 ? "FAIL" : "PASS";
+        break;
+      case "high":
+        complianceStatus = stats.critical > 0 || stats.high > 0 ? "FAIL" : "PASS";
+        break;
+      case "medium":
+        complianceStatus = stats.critical > 0 || stats.high > 0 || stats.medium > 0 ? "FAIL" : "PASS";
+        break;
+      case "low":
+        complianceStatus = stats.total > 0 ? "FAIL" : "PASS";
+        break;
+    }
+    const axeCore = require("axe-core");
+    const metadata = {
+      engineVersion: "1.4.6",
+      axeCoreVersion: axeCore.version || "4.10.2",
+      standardsVersion: "1.2.2",
+      scanDuration,
+      pageTitle,
+      pageLanguage
+    };
     return {
       url: this.options.url,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      metadata,
       reports,
       stats,
       score,

package/dist/index.mjs

@@ -2,7 +2,7 @@ import {
   PseudoAutomationEngine,
   RegulatoryScanner,
   VirtualDOMBuilder
-} from "./chunk-VTSEAYGK.mjs";
+} from "./chunk-SH2EU7XX.mjs";
 import {
   getCurrentLang,
   setLanguage,

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@holmdigital/engine",
-    "version": "1.4.5",
+    "version": "1.4.6",
     "private": false,
     "publishConfig": {
         "access": "public",
@@ -61,12 +61,12 @@
     "license": "MIT",
     "dependencies": {
         "@holmdigital/standards": "*",
-        "axe-core": "^4.10.2",
+        "axe-core": "4.10.2",
         "chalk": "^5.3.0",
         "commander": "^12.1.0",
-        "html-validate": "^10.4.0",
+        "html-validate": "10.4.0",
         "ora": "^8.1.1",
-        "puppeteer": "^23.10.4",
+        "puppeteer": "23.10.4",
         "ws": "^8.18.0"
     },
     "devDependencies": {