@diegovelasquezweb/a11y-engine 0.3.0 → 0.4.0

package/assets/generated/discovery/stack-detection.mjs

@@ -0,0 +1 @@
+export default {"platformStructureDetectors":[["wordpress",["wp-content/themes"]],["drupal",["web/themes","themes"]],["shopify",["sections","snippets","layout","templates"]]],"uiLibraryPackageDetectors":[["@radix-ui","radix"],["@headlessui","headless-ui"],["@chakra-ui","chakra"],["@mantine","mantine"],["@mui","material-ui"],["antd","ant-design"],["@shopify/polaris","polaris"],["@react-aria","react-aria"],["ariakit","ariakit"],["primevue","primevue"],["vuetify","vuetify"],["swiper","swiper"]],"frameworkPackageDetectors":[["next","nextjs"],["gatsby","gatsby"],["nuxt","nuxt"],["@nuxt/core","nuxt"],["@angular/core","angular"],["astro","astro"],["@sveltejs/kit","svelte"],["svelte","svelte"],["vue","vue"],["react","react"]],"domFrameworkDetectors":[{"id":"nextjs","type":"framework","signals":[{"kind":"global","key":"__NEXT_DATA__"},{"kind":"global","key":"__next"},{"kind":"selector","value":"script#__NEXT_DATA__"},{"kind":"selector","value":"div#__next"},{"kind":"scriptSrc","pattern":"/_next/"},{"kind":"meta","name":"next-head-count"}]},{"id":"nuxt","type":"framework","signals":[{"kind":"global","key":"__NUXT__"},{"kind":"global","key":"$nuxt"},{"kind":"selector","value":"div#__nuxt"},{"kind":"scriptSrc","pattern":"/_nuxt/"},{"kind":"meta","name":"generator","pattern":"Nuxt"}]},{"id":"gatsby","type":"framework","signals":[{"kind":"global","key":"___gatsby"},{"kind":"selector","value":"div#___gatsby"},{"kind":"meta","name":"generator","pattern":"Gatsby"}]},{"id":"angular","type":"framework","signals":[{"kind":"global","key":"ng"},{"kind":"selector","value":"[ng-version]"},{"kind":"selector","value":"app-root"}]},{"id":"svelte","type":"framework","signals":[{"kind":"global","key":"__svelte"},{"kind":"selector","value":"[data-svelte-h]"},{"kind":"meta","name":"generator","pattern":"Svelte"}]},{"id":"astro","type":"framework","signals":[{"kind":"selector","value":"[data-astro-cid]"},{"kind":"meta","name":"generator","pattern":"Astro"},{"kind":"selector","value":"astro-island"}]},{"id":"remix","type":"framework","signals":[{"kind":"global","key":"__remixContext"},{"kind":"global","key":"__remixManifest"}]},{"id":"vue","type":"framework","signals":[{"kind":"global","key":"__VUE__"},{"kind":"selector","value":"[data-v-]"},{"kind":"selector","value":"div#app[data-v-app]"}]},{"id":"react","type":"framework","signals":[{"kind":"selector","value":"[data-reactroot]"},{"kind":"selector","value":"[data-reactid]"},{"kind":"global","key":"__REACT_DEVTOOLS_GLOBAL_HOOK__"}]}],"domCmsDetectors":[{"id":"wordpress","type":"cms","signals":[{"kind":"meta","name":"generator","pattern":"WordPress"},{"kind":"scriptSrc","pattern":"/wp-content/"},{"kind":"scriptSrc","pattern":"/wp-includes/"},{"kind":"selector","value":"link[href*='wp-content']"},{"kind":"selector","value":"body.wp-site-blocks"}]},{"id":"shopify","type":"cms","signals":[{"kind":"global","key":"Shopify"},{"kind":"scriptSrc","pattern":"cdn.shopify.com"},{"kind":"meta","name":"shopify-digital-wallet"},{"kind":"selector","value":"link[href*='cdn.shopify']"}]},{"id":"drupal","type":"cms","signals":[{"kind":"meta","name":"generator","pattern":"Drupal"},{"kind":"global","key":"Drupal"},{"kind":"scriptSrc","pattern":"/sites/default/files/"}]},{"id":"wix","type":"cms","signals":[{"kind":"meta","name":"generator","pattern":"Wix"},{"kind":"scriptSrc","pattern":"static.parastorage.com"},{"kind":"scriptSrc","pattern":"static.wixstatic.com"}]},{"id":"squarespace","type":"cms","signals":[{"kind":"meta","name":"generator","pattern":"Squarespace"},{"kind":"scriptSrc","pattern":"static1.squarespace.com"}]},{"id":"webflow","type":"cms","signals":[{"kind":"meta","name":"generator","pattern":"Webflow"},{"kind":"selector","value":"html.w-mod-js"},{"kind":"scriptSrc","pattern":"assets.website-files.com"}]},{"id":"joomla","type":"cms","signals":[{"kind":"meta","name":"generator","pattern":"Joomla"},{"kind":"scriptSrc","pattern":"/media/system/js/"}]},{"id":"magento","type":"cms","signals":[{"kind":"scriptSrc","pattern":"/static/version"},{"kind":"selector","value":"script[data-requiremodule]"},{"kind":"global","key":"require"}]}],"domUiLibraryDetectors":[{"id":"bootstrap","signals":[{"kind":"selector","value":"link[href*='bootstrap']"},{"kind":"scriptSrc","pattern":"bootstrap"},{"kind":"selector","value":".container .row .col"}]},{"id":"tailwindcss","signals":[{"kind":"selector","value":"style[data-precedence]"},{"kind":"selector","value":"link[href*='tailwind']"},{"kind":"meta","name":"generator","pattern":"Tailwind"}]},{"id":"material-ui","signals":[{"kind":"selector","value":"[class*='MuiButton']"},{"kind":"selector","value":"[class*='MuiTypography']"},{"kind":"selector","value":"[class*='MuiPaper']"}]},{"id":"jquery","signals":[{"kind":"global","key":"jQuery"},{"kind":"global","key":"$"}]},{"id":"foundation","signals":[{"kind":"global","key":"Foundation"},{"kind":"selector","value":"link[href*='foundation']"}]}]};

package/assets/source/discovery/stack-detection.json

@@ -0,0 +1,235 @@
+{
+  "platformStructureDetectors": [
+    ["wordpress", ["wp-content/themes"]],
+    ["drupal", ["web/themes", "themes"]],
+    ["shopify", ["sections", "snippets", "layout", "templates"]]
+  ],
+  "uiLibraryPackageDetectors": [
+    ["@radix-ui", "radix"],
+    ["@headlessui", "headless-ui"],
+    ["@chakra-ui", "chakra"],
+    ["@mantine", "mantine"],
+    ["@mui", "material-ui"],
+    ["antd", "ant-design"],
+    ["@shopify/polaris", "polaris"],
+    ["@react-aria", "react-aria"],
+    ["ariakit", "ariakit"],
+    ["primevue", "primevue"],
+    ["vuetify", "vuetify"],
+    ["swiper", "swiper"]
+  ],
+  "frameworkPackageDetectors": [
+    ["next", "nextjs"],
+    ["gatsby", "gatsby"],
+    ["nuxt", "nuxt"],
+    ["@nuxt/core", "nuxt"],
+    ["@angular/core", "angular"],
+    ["astro", "astro"],
+    ["@sveltejs/kit", "svelte"],
+    ["svelte", "svelte"],
+    ["vue", "vue"],
+    ["react", "react"]
+  ],
+  "domFrameworkDetectors": [
+    {
+      "id": "nextjs",
+      "type": "framework",
+      "signals": [
+        { "kind": "global", "key": "__NEXT_DATA__" },
+        { "kind": "global", "key": "__next" },
+        { "kind": "selector", "value": "script#__NEXT_DATA__" },
+        { "kind": "selector", "value": "div#__next" },
+        { "kind": "scriptSrc", "pattern": "/_next/" },
+        { "kind": "meta", "name": "next-head-count" }
+      ]
+    },
+    {
+      "id": "nuxt",
+      "type": "framework",
+      "signals": [
+        { "kind": "global", "key": "__NUXT__" },
+        { "kind": "global", "key": "$nuxt" },
+        { "kind": "selector", "value": "div#__nuxt" },
+        { "kind": "scriptSrc", "pattern": "/_nuxt/" },
+        { "kind": "meta", "name": "generator", "pattern": "Nuxt" }
+      ]
+    },
+    {
+      "id": "gatsby",
+      "type": "framework",
+      "signals": [
+        { "kind": "global", "key": "___gatsby" },
+        { "kind": "selector", "value": "div#___gatsby" },
+        { "kind": "meta", "name": "generator", "pattern": "Gatsby" }
+      ]
+    },
+    {
+      "id": "angular",
+      "type": "framework",
+      "signals": [
+        { "kind": "global", "key": "ng" },
+        { "kind": "selector", "value": "[ng-version]" },
+        { "kind": "selector", "value": "app-root" }
+      ]
+    },
+    {
+      "id": "svelte",
+      "type": "framework",
+      "signals": [
+        { "kind": "global", "key": "__svelte" },
+        { "kind": "selector", "value": "[data-svelte-h]" },
+        { "kind": "meta", "name": "generator", "pattern": "Svelte" }
+      ]
+    },
+    {
+      "id": "astro",
+      "type": "framework",
+      "signals": [
+        { "kind": "selector", "value": "[data-astro-cid]" },
+        { "kind": "meta", "name": "generator", "pattern": "Astro" },
+        { "kind": "selector", "value": "astro-island" }
+      ]
+    },
+    {
+      "id": "remix",
+      "type": "framework",
+      "signals": [
+        { "kind": "global", "key": "__remixContext" },
+        { "kind": "global", "key": "__remixManifest" }
+      ]
+    },
+    {
+      "id": "vue",
+      "type": "framework",
+      "signals": [
+        { "kind": "global", "key": "__VUE__" },
+        { "kind": "selector", "value": "[data-v-]" },
+        { "kind": "selector", "value": "div#app[data-v-app]" }
+      ]
+    },
+    {
+      "id": "react",
+      "type": "framework",
+      "signals": [
+        { "kind": "selector", "value": "[data-reactroot]" },
+        { "kind": "selector", "value": "[data-reactid]" },
+        { "kind": "global", "key": "__REACT_DEVTOOLS_GLOBAL_HOOK__" }
+      ]
+    }
+  ],
+  "domCmsDetectors": [
+    {
+      "id": "wordpress",
+      "type": "cms",
+      "signals": [
+        { "kind": "meta", "name": "generator", "pattern": "WordPress" },
+        { "kind": "scriptSrc", "pattern": "/wp-content/" },
+        { "kind": "scriptSrc", "pattern": "/wp-includes/" },
+        { "kind": "selector", "value": "link[href*='wp-content']" },
+        { "kind": "selector", "value": "body.wp-site-blocks" }
+      ]
+    },
+    {
+      "id": "shopify",
+      "type": "cms",
+      "signals": [
+        { "kind": "global", "key": "Shopify" },
+        { "kind": "scriptSrc", "pattern": "cdn.shopify.com" },
+        { "kind": "meta", "name": "shopify-digital-wallet" },
+        { "kind": "selector", "value": "link[href*='cdn.shopify']" }
+      ]
+    },
+    {
+      "id": "drupal",
+      "type": "cms",
+      "signals": [
+        { "kind": "meta", "name": "generator", "pattern": "Drupal" },
+        { "kind": "global", "key": "Drupal" },
+        { "kind": "scriptSrc", "pattern": "/sites/default/files/" }
+      ]
+    },
+    {
+      "id": "wix",
+      "type": "cms",
+      "signals": [
+        { "kind": "meta", "name": "generator", "pattern": "Wix" },
+        { "kind": "scriptSrc", "pattern": "static.parastorage.com" },
+        { "kind": "scriptSrc", "pattern": "static.wixstatic.com" }
+      ]
+    },
+    {
+      "id": "squarespace",
+      "type": "cms",
+      "signals": [
+        { "kind": "meta", "name": "generator", "pattern": "Squarespace" },
+        { "kind": "scriptSrc", "pattern": "static1.squarespace.com" }
+      ]
+    },
+    {
+      "id": "webflow",
+      "type": "cms",
+      "signals": [
+        { "kind": "meta", "name": "generator", "pattern": "Webflow" },
+        { "kind": "selector", "value": "html.w-mod-js" },
+        { "kind": "scriptSrc", "pattern": "assets.website-files.com" }
+      ]
+    },
+    {
+      "id": "joomla",
+      "type": "cms",
+      "signals": [
+        { "kind": "meta", "name": "generator", "pattern": "Joomla" },
+        { "kind": "scriptSrc", "pattern": "/media/system/js/" }
+      ]
+    },
+    {
+      "id": "magento",
+      "type": "cms",
+      "signals": [
+        { "kind": "scriptSrc", "pattern": "/static/version" },
+        { "kind": "selector", "value": "script[data-requiremodule]" },
+        { "kind": "global", "key": "require" }
+      ]
+    }
+  ],
+  "domUiLibraryDetectors": [
+    {
+      "id": "bootstrap",
+      "signals": [
+        { "kind": "selector", "value": "link[href*='bootstrap']" },
+        { "kind": "scriptSrc", "pattern": "bootstrap" },
+        { "kind": "selector", "value": ".container .row .col" }
+      ]
+    },
+    {
+      "id": "tailwindcss",
+      "signals": [
+        { "kind": "selector", "value": "style[data-precedence]" },
+        { "kind": "selector", "value": "link[href*='tailwind']" },
+        { "kind": "meta", "name": "generator", "pattern": "Tailwind" }
+      ]
+    },
+    {
+      "id": "material-ui",
+      "signals": [
+        { "kind": "selector", "value": "[class*='MuiButton']" },
+        { "kind": "selector", "value": "[class*='MuiTypography']" },
+        { "kind": "selector", "value": "[class*='MuiPaper']" }
+      ]
+    },
+    {
+      "id": "jquery",
+      "signals": [
+        { "kind": "global", "key": "jQuery" },
+        { "kind": "global", "key": "$" }
+      ]
+    },
+    {
+      "id": "foundation",
+      "signals": [
+        { "kind": "global", "key": "Foundation" },
+        { "kind": "selector", "value": "link[href*='foundation']" }
+      ]
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegovelasquezweb/a11y-engine",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "WCAG 2.2 AA accessibility audit engine — scanner, analyzer, and report builders",
   "type": "module",
   "license": "MIT",
@@ -14,27 +14,30 @@
   },
   "exports": {
     ".": {
-      "types": "./scripts/index.d.mts",
-      "default": "./scripts/index.mjs"
+      "types": "./src/index.d.mts",
+      "default": "./src/index.mjs"
     },
     "./package.json": "./package.json"
   },
-  "main": "scripts/index.mjs",
-  "types": "scripts/index.d.mts",
+  "main": "src/index.mjs",
+  "types": "src/index.d.mts",
   "bin": {
-    "a11y-audit": "scripts/audit.mjs"
+    "a11y-audit": "src/cli/audit.mjs"
   },
   "files": [
-    "scripts/**",
-    "assets/**",
+    "src/**",
+    "assets/source/**",
+    "assets/generated/**",
     "docs/**",
+    "scripts/sync-assets.mjs",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
   ],
   "scripts": {
+    "sync-assets": "node scripts/sync-assets.mjs",
     "test": "vitest run",
-    "prepublishOnly": "node -e \"console.log('Publishing @diegovelasquezweb/a11y-engine...')\""
+    "prepublishOnly": "node scripts/sync-assets.mjs"
   },
   "dependencies": {
     "@axe-core/playwright": "^4.11.1",

package/scripts/sync-assets.mjs

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+/**
+ * sync-assets.mjs
+ * Generates assets/generated/**\/*.mjs from assets/source/**\/*.json.
+ * Run: node scripts/sync-assets.mjs
+ * Hooked automatically in prepublishOnly.
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const ROOT = path.resolve(__dirname, "..");
+const SOURCE_DIR = path.join(ROOT, "assets", "source");
+const GENERATED_DIR = path.join(ROOT, "assets", "generated");
+
+let synced = 0;
+let skipped = 0;
+
+function syncDir(sourceDir, generatedDir) {
+  fs.mkdirSync(generatedDir, { recursive: true });
+
+  for (const entry of fs.readdirSync(sourceDir, { withFileTypes: true })) {
+    const sourcePath = path.join(sourceDir, entry.name);
+    const generatedPath = path.join(generatedDir, entry.name);
+
+    if (entry.isDirectory()) {
+      syncDir(sourcePath, path.join(generatedDir, entry.name));
+      continue;
+    }
+
+    if (!entry.name.endsWith(".json")) {
+      skipped++;
+      continue;
+    }
+
+    const mjsName = entry.name.replace(/\.json$/, ".mjs");
+    const mjsPath = path.join(generatedDir, mjsName);
+
+    let data;
+    try {
+      data = JSON.parse(fs.readFileSync(sourcePath, "utf-8"));
+    } catch (err) {
+      console.error(`  [ERROR] Failed to parse ${sourcePath}: ${err.message}`);
+      process.exit(1);
+    }
+
+    const content = `export default ${JSON.stringify(data)};\n`;
+
+    // Only write if content changed (avoid unnecessary fs writes)
+    let existing = null;
+    try { existing = fs.readFileSync(mjsPath, "utf-8"); } catch { /* new file */ }
+
+    if (existing !== content) {
+      fs.writeFileSync(mjsPath, content, "utf-8");
+      console.log(`  synced: ${path.relative(ROOT, mjsPath)}`);
+      synced++;
+    } else {
+      skipped++;
+    }
+  }
+}
+
+console.log("Syncing assets/source/*.json → assets/generated/*.mjs");
+syncDir(SOURCE_DIR, GENERATED_DIR);
+console.log(`Done. ${synced} file(s) written, ${skipped} unchanged/skipped.`);

package/{scripts → src/cli}/audit.mjs

@@ -10,7 +10,7 @@ import { spawn, execSync } from "node:child_process";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import fs from "node:fs";
-import { log, DEFAULTS, SKILL_ROOT, getInternalPath } from "./core/utils.mjs";
+import { log, DEFAULTS, SKILL_ROOT, getInternalPath } from "../core/utils.mjs";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
@@ -205,7 +205,7 @@ async function main() {
       log.success("Dependencies ready.");
     }
 
-    await runScript("core/toolchain.mjs");
+    await runScript("../core/toolchain.mjs");
 
     const screenshotsDir = getInternalPath("screenshots");
     fs.rmSync(screenshotsDir, { recursive: true, force: true });
@@ -258,12 +258,12 @@ async function main() {
     }
     if (axeTags) scanArgs.push("--axe-tags", axeTags);
 
-    await runScript("engine/dom-scanner.mjs", scanArgs, childEnv);
+    await runScript("../pipeline/dom-scanner.mjs", scanArgs, childEnv);
 
     const analyzerArgs = [];
     if (ignoreFindings) analyzerArgs.push("--ignore-findings", ignoreFindings);
     if (framework) analyzerArgs.push("--framework", framework);
-    await runScript("engine/analyzer.mjs", analyzerArgs);
+    await runScript("../enrichment/analyzer.mjs", analyzerArgs);
 
     if (projectDir && !skipPatterns) {
       const patternArgs = ["--project-dir", path.resolve(projectDir)];
@@ -275,7 +275,7 @@ async function main() {
         } catch { /* ignore */ }
       }
       if (resolvedFramework) patternArgs.push("--framework", resolvedFramework);
-      await runScript("engine/source-scanner.mjs", patternArgs);
+      await runScript("../source-patterns/source-scanner.mjs", patternArgs);
     }
 
     const mdOutput = getInternalPath("remediation.md");
@@ -283,7 +283,7 @@ async function main() {
     if (target) mdArgs.push("--target", target);
 
     if (skipReports) {
-      await runScript("reports/builders/md.mjs", mdArgs);
+      await runScript("../reports/md.mjs", mdArgs);
     } else {
       const output = getArgValue("output");
       if (!output) {
@@ -307,10 +307,10 @@ async function main() {
       const checklistArgs = ["--output", checklistOutput, "--base-url", baseUrl];
 
       await Promise.all([
-        runScript("reports/builders/html.mjs", buildArgs),
-        runScript("reports/builders/checklist.mjs", checklistArgs),
-        runScript("reports/builders/md.mjs", mdArgs),
-        runScript("reports/builders/pdf.mjs", pdfArgs),
+        runScript("../reports/html.mjs", buildArgs),
+        runScript("../reports/checklist.mjs", checklistArgs),
+        runScript("../reports/md.mjs", mdArgs),
+        runScript("../reports/pdf.mjs", pdfArgs),
       ]);
 
       console.log(`REPORT_PATH=${absoluteOutputPath}`);

package/{scripts → src}/core/asset-loader.mjs

@@ -5,18 +5,18 @@
  * This ensures bundlers (Turbopack, Webpack) can trace them automatically.
  */
 
-import crawlerConfig from "../../assets/discovery/crawler-config.mjs";
-import stackDetection from "../../assets/discovery/stack-detection.mjs";
-import cdpChecks from "../../assets/engine/cdp-checks.mjs";
-import pa11yConfig from "../../assets/engine/pa11y-config.mjs";
-import axeCheckMaps from "../../assets/remediation/axe-check-maps.mjs";
-import codePatterns from "../../assets/remediation/code-patterns.mjs";
-import guardrails from "../../assets/remediation/guardrails.mjs";
-import intelligence from "../../assets/remediation/intelligence.mjs";
-import sourceBoundaries from "../../assets/remediation/source-boundaries.mjs";
-import complianceConfig from "../../assets/reporting/compliance-config.mjs";
-import manualChecks from "../../assets/reporting/manual-checks.mjs";
-import wcagReference from "../../assets/reporting/wcag-reference.mjs";
+import crawlerConfig from "../../assets/generated/discovery/crawler-config.mjs";
+import stackDetection from "../../assets/generated/discovery/stack-detection.mjs";
+import cdpChecks from "../../assets/generated/engine/cdp-checks.mjs";
+import pa11yConfig from "../../assets/generated/engine/pa11y-config.mjs";
+import axeCheckMaps from "../../assets/generated/remediation/axe-check-maps.mjs";
+import codePatterns from "../../assets/generated/remediation/code-patterns.mjs";
+import guardrails from "../../assets/generated/remediation/guardrails.mjs";
+import intelligence from "../../assets/generated/remediation/intelligence.mjs";
+import sourceBoundaries from "../../assets/generated/remediation/source-boundaries.mjs";
+import complianceConfig from "../../assets/generated/reporting/compliance-config.mjs";
+import manualChecks from "../../assets/generated/reporting/manual-checks.mjs";
+import wcagReference from "../../assets/generated/reporting/wcag-reference.mjs";
 
 /**
  * Pre-loaded asset map. Each value is the parsed JSON object, ready to use.

package/{scripts/engine → src/enrichment}/analyzer.mjs

@@ -755,6 +755,7 @@ function computeTestingMethodology(payload) {
     pages_scanned: scanned,
     pages_errored: errored,
     framework_detected: payload.projectContext?.framework || "Not detected",
+    cms_detected: payload.projectContext?.cms || "Not detected",
     manual_testing: "Not performed (automated scan only)",
     assistive_tech_tested: "None (automated scan only)",
   };
@@ -772,6 +773,7 @@ function buildFindings(inputPayload, cliArgs) {
   const routes = inputPayload.routes || [];
   const ctx = inputPayload.projectContext || {
     framework: null,
+    cms: null,
     uiLibraries: [],
   };
   if (cliArgs?.framework) ctx.framework = cliArgs.framework;

package/{scripts → src}/index.mjs

@@ -457,8 +457,8 @@ export function getAuditSummary(findings, payload = null) {
 export async function runAudit(options) {
   if (!options.baseUrl) throw new Error("runAudit requires baseUrl");
 
-  const { runDomScanner } = await import("./engine/dom-scanner.mjs");
-  const { runAnalyzer } = await import("./engine/analyzer.mjs");
+  const { runDomScanner } = await import("./pipeline/dom-scanner.mjs");
+  const { runAnalyzer } = await import("./enrichment/analyzer.mjs");
 
   const onProgress = options.onProgress || null;
 
@@ -481,6 +481,7 @@ export async function runAudit(options) {
       onlyRule: options.onlyRule,
       excludeSelectors: options.excludeSelectors,
       screenshotsDir: options.screenshotsDir,
+      projectDir: options.projectDir,
     },
     { onProgress },
   );
@@ -496,7 +497,7 @@ export async function runAudit(options) {
   // Step 3: Source patterns (optional)
   if (options.projectDir && !options.skipPatterns) {
     try {
-      const { resolveScanDirs, scanPattern } = await import("./engine/source-scanner.mjs");
+      const { resolveScanDirs, scanPattern } = await import("./source-patterns/source-scanner.mjs");
       const { patterns } = loadAssetJson(ASSET_PATHS.remediation.codePatterns, "code-patterns.json");
 
       let resolvedFramework = options.framework;
@@ -892,7 +893,7 @@ export async function getRemediationGuide(payload, options = {}) {
  * @returns {Promise<{ findings: object[], summary: { total: number, confirmed: number, potential: number } }>}
  */
 export async function getSourcePatterns(projectDir, options = {}) {
-  const { scanPattern, resolveScanDirs } = await import("./engine/source-scanner.mjs");
+  const { scanPattern, resolveScanDirs } = await import("./source-patterns/source-scanner.mjs");
 
   const { patterns } = loadAssetJson(ASSET_PATHS.remediation.codePatterns, "code-patterns.json");
 

package/{scripts/engine → src/pipeline}/dom-scanner.mjs

@@ -337,14 +337,18 @@ export async function discoverRoutes(page, baseUrl, maxRoutes, crawlDepth = 2) {
 
 /**
  * Detects the web framework and UI libraries used by analyzing package.json and file structure.
+ * @param {string|null} [explicitProjectDir=null] - Explicit project directory. Falls back to env/cwd.
  * @returns {Object} An object containing detected framework and UI libraries.
  */
-function detectProjectContext() {
+function detectProjectContext(explicitProjectDir = null) {
   const uiLibraries = [];
   let pkgFramework = null;
   let fileFramework = null;
 
-  const projectDir = process.env.A11Y_PROJECT_DIR || process.cwd();
+  const projectDir = explicitProjectDir || process.env.A11Y_PROJECT_DIR || null;
+  if (!projectDir) {
+    return { framework: null, uiLibraries: [] };
+  }
 
   try {
     const pkgPath = path.join(projectDir, "package.json");
@@ -388,6 +392,126 @@ function detectProjectContext() {
   return { framework: resolvedFramework, uiLibraries };
 }
 
+/**
+ * Detects the web framework, CMS, and UI libraries by inspecting the live page DOM,
+ * window globals, script sources, and meta tags. This works for any remote URL
+ * without needing access to the project source code.
+ * @param {import("playwright").Page} page - The Playwright page object (already navigated).
+ * @returns {Promise<{ framework: string|null, cms: string|null, uiLibraries: string[] }>}
+ */
+async function detectProjectContextFromDom(page) {
+  const frameworkDetectors = STACK_DETECTION.domFrameworkDetectors || [];
+  const cmsDetectors = STACK_DETECTION.domCmsDetectors || [];
+  const uiDetectors = STACK_DETECTION.domUiLibraryDetectors || [];
+
+  const result = await page.evaluate(({ frameworkDetectors, cmsDetectors, uiDetectors }) => {
+    function checkSignals(signals) {
+      let matched = 0;
+      for (const signal of signals) {
+        try {
+          if (signal.kind === "global") {
+            if (typeof window[signal.key] !== "undefined" && window[signal.key] !== null) {
+              matched++;
+            }
+          } else if (signal.kind === "selector") {
+            if (document.querySelector(signal.value)) {
+              matched++;
+            }
+          } else if (signal.kind === "scriptSrc") {
+            const scripts = document.querySelectorAll("script[src]");
+            for (const s of scripts) {
+              if (s.getAttribute("src")?.includes(signal.pattern)) {
+                matched++;
+                break;
+              }
+            }
+          } else if (signal.kind === "meta") {
+            const metas = document.querySelectorAll(`meta[name="${signal.name}"],meta[property="${signal.name}"]`);
+            if (metas.length > 0) {
+              if (signal.pattern) {
+                for (const m of metas) {
+                  if (m.getAttribute("content")?.toLowerCase().includes(signal.pattern.toLowerCase())) {
+                    matched++;
+                    break;
+                  }
+                }
+              } else {
+                matched++;
+              }
+            }
+          }
+        } catch {
+          // ignore individual signal errors
+        }
+      }
+      return matched;
+    }
+
+    function detectBest(detectors) {
+      let best = null;
+      let bestScore = 0;
+      for (const detector of detectors) {
+        const score = checkSignals(detector.signals);
+        if (score > 0 && score > bestScore) {
+          bestScore = score;
+          best = detector.id;
+        }
+      }
+      return best;
+    }
+
+    function detectAllUiLibs(detectors) {
+      const found = [];
+      for (const detector of detectors) {
+        let total = 0;
+        let strongSignals = 0;
+        for (const signal of detector.signals) {
+          try {
+            let hit = false;
+            if (signal.kind === "global") {
+              hit = typeof window[signal.key] !== "undefined" && window[signal.key] !== null;
+            } else if (signal.kind === "selector") {
+              hit = !!document.querySelector(signal.value);
+            } else if (signal.kind === "scriptSrc") {
+              const scripts = document.querySelectorAll("script[src]");
+              for (const s of scripts) {
+                if (s.getAttribute("src")?.includes(signal.pattern)) { hit = true; break; }
+              }
+            } else if (signal.kind === "meta") {
+              const metas = document.querySelectorAll(`meta[name="${signal.name}"],meta[property="${signal.name}"]`);
+              for (const m of metas) {
+                if (!signal.pattern || m.getAttribute("content")?.toLowerCase().includes(signal.pattern.toLowerCase())) {
+                  hit = true; break;
+                }
+              }
+            }
+            if (hit) {
+              total++;
+              if (signal.kind !== "selector") strongSignals++;
+            }
+          } catch {}
+        }
+        if (total >= 2 || strongSignals >= 1) {
+          found.push(detector.id);
+        }
+      }
+      return found;
+    }
+
+    const framework = detectBest(frameworkDetectors);
+    const cms = detectBest(cmsDetectors);
+    const uiLibraries = detectAllUiLibs(uiDetectors);
+
+    return { framework, cms, uiLibraries };
+  }, { frameworkDetectors, cmsDetectors, uiDetectors });
+
+  if (result.framework) log.info(`DOM detection: framework=${result.framework}`);
+  if (result.cms) log.info(`DOM detection: cms=${result.cms}`);
+  if (result.uiLibraries.length) log.info(`DOM detection: uiLibraries=${result.uiLibraries.join(", ")}`);
+
+  return result;
+}
+
 /**
  * Navigates to a route and performs an axe-core accessibility analysis.
  * @param {import("playwright").Page} page - The Playwright page object.
@@ -820,6 +944,7 @@ export async function runDomScanner(options = {}, callbacks = {}) {
     crawlDepth: Math.min(Math.max(options.crawlDepth ?? DEFAULTS.crawlDepth, 1), 3),
     viewport: options.viewport || null,
     axeTags: options.axeTags || null,
+    projectDir: options.projectDir || null,
   };
 
   if (!args.baseUrl) throw new Error("Missing required option: baseUrl");
@@ -859,14 +984,33 @@ async function _runDomScannerInternal(args) {
   const page = await context.newPage();
 
   let routes = [];
-  let projectContext = { framework: null, uiLibraries: [] };
+  let projectContext = { framework: null, cms: null, uiLibraries: [] };
   try {
     await page.goto(baseUrl, {
       waitUntil: args.waitUntil,
       timeout: args.timeoutMs,
     });
 
-    projectContext = detectProjectContext();
+    // 1. File-system / package.json detection (works when projectDir is available)
+    const repoCtx = detectProjectContext(args.projectDir || null);
+
+    // 2. DOM/runtime detection (always works for any remote URL)
+    let domCtx = { framework: null, cms: null, uiLibraries: [] };
+    try {
+      domCtx = await detectProjectContextFromDom(page);
+    } catch (err) {
+      log.warn(`DOM stack detection failed (non-fatal): ${err.message}`);
+    }
+
+    // 3. Merge: repo detection takes priority, DOM fills gaps
+    projectContext = {
+      framework: repoCtx.framework || domCtx.framework || null,
+      cms: domCtx.cms || null,
+      uiLibraries: [...new Set([
+        ...(repoCtx.uiLibraries || []),
+        ...(domCtx.uiLibraries || []),
+      ])],
+    };
 
     const cliRoutes = parseRoutesArg(args.routes, origin);
 

package/assets/discovery/stack-detection.json

@@ -1,33 +0,0 @@
-{
-  "platformStructureDetectors": [
-    ["wordpress", ["wp-content/themes"]],
-    ["drupal", ["web/themes", "themes"]],
-    ["shopify", ["sections", "snippets", "layout", "templates"]]
-  ],
-  "uiLibraryPackageDetectors": [
-    ["@radix-ui", "radix"],
-    ["@headlessui", "headless-ui"],
-    ["@chakra-ui", "chakra"],
-    ["@mantine", "mantine"],
-    ["@mui", "material-ui"],
-    ["antd", "ant-design"],
-    ["@shopify/polaris", "polaris"],
-    ["@react-aria", "react-aria"],
-    ["ariakit", "ariakit"],
-    ["primevue", "primevue"],
-    ["vuetify", "vuetify"],
-    ["swiper", "swiper"]
-  ],
-  "frameworkPackageDetectors": [
-    ["next", "nextjs"],
-    ["gatsby", "gatsby"],
-    ["nuxt", "nuxt"],
-    ["@nuxt/core", "nuxt"],
-    ["@angular/core", "angular"],
-    ["astro", "astro"],
-    ["@sveltejs/kit", "svelte"],
-    ["svelte", "svelte"],
-    ["vue", "vue"],
-    ["react", "react"]
-  ]
-}

package/assets/discovery/stack-detection.mjs

@@ -1 +0,0 @@
-export default {"platformStructureDetectors":[["wordpress",["wp-content/themes"]],["drupal",["web/themes","themes"]],["shopify",["sections","snippets","layout","templates"]]],"uiLibraryPackageDetectors":[["@radix-ui","radix"],["@headlessui","headless-ui"],["@chakra-ui","chakra"],["@mantine","mantine"],["@mui","material-ui"],["antd","ant-design"],["@shopify/polaris","polaris"],["@react-aria","react-aria"],["ariakit","ariakit"],["primevue","primevue"],["vuetify","vuetify"],["swiper","swiper"]],"frameworkPackageDetectors":[["next","nextjs"],["gatsby","gatsby"],["nuxt","nuxt"],["@nuxt/core","nuxt"],["@angular/core","angular"],["astro","astro"],["@sveltejs/kit","svelte"],["svelte","svelte"],["vue","vue"],["react","react"]]};