aria-ease 2.8.2 → 2.8.3

package/bin/cli.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import "./chunk-JSBRDJBE.js";
 
 // src/utils/cli/cli.ts
 import { Command } from "commander";
@@ -6,248 +7,6 @@ import chalk from "chalk";
 import path2 from "path";
 import fs2 from "fs-extra";
 
-// src/utils/audit/src/audit/audit.js
-import AxeBuilder from "@axe-core/playwright";
-import { chromium } from "playwright";
-async function runAudit(url, options) {
-  let browser;
-  const timeout = options?.timeout || 6e4;
-  const waitUntil = options?.waitUntil || "domcontentloaded";
-  try {
-    browser = await chromium.launch({ headless: true });
-    const context = await browser.newContext();
-    const page = await context.newPage();
-    await page.goto(url, { waitUntil, timeout });
-    const axe2 = new AxeBuilder({ page });
-    const axeResults = await axe2.analyze();
-    return axeResults;
-  } catch (error) {
-    if (error instanceof Error) {
-      if (error.message.includes("Executable doesn't exist")) {
-        console.error("\n\u274C Playwright browsers not found!\n");
-        console.log("\u{1F4E6} First-time setup required:");
-        console.log("   Run: npx playwright install chromium\n");
-        console.log("\u{1F4A1} This downloads the browser needed for auditing (~200MB)");
-        console.log("   You only need to do this once.\n");
-      } else if (error.message.includes("page.goto: net::ERR_CONNECTION_REFUSED")) {
-        console.error("\n\u274C Server Not Running!\n");
-        console.log("   Make sure your server is running before auditing URL");
-        console.log("   Run: npm run dev # or your start command");
-      } else if (error.message.includes("page.goto: Protocol error (Page.navigate): Cannot navigate to invalid URL")) {
-        console.error("\n\u274C Cannot audit invalid URL\n");
-      } else {
-        console.error("\u274C Audit error:", error.message);
-        console.log("   Make sure you provide a valid URL");
-      }
-    } else {
-      console.error("\u274C Audit error (non-Error):", String(error));
-    }
-    throw error;
-  } finally {
-    if (browser)
-      await browser.close();
-  }
-}
-
-// src/utils/audit/src/formatters/formatters.js
-function formatResults(allResults, format) {
-  switch (format) {
-    case "json":
-      return JSON.stringify(allResults.flatMap(({ url, result }) => result ? result.violations.flatMap((v) => v.nodes.map((n) => ({
-        URL: url,
-        Rule: v.id,
-        Impact: v.impact,
-        Description: v.description,
-        Target: n.target,
-        FailureSummary: n.failureSummary
-      }))) : []), null, 2);
-    case "csv":
-      return toCSV(allResults);
-    case "html":
-      return toHTML(allResults);
-    default:
-      return "";
-  }
-}
-function toCSV(allResults) {
-  const rows = ["URL,Rule,Impact,Description,Target,FailureSummary"];
-  allResults.forEach(({ url, result }) => {
-    if (result) {
-      result.violations.forEach((v) => {
-        v.nodes.forEach((n) => {
-          rows.push(escapeCSV(url) + "," + escapeCSV(v.id) + "," + escapeCSV(v.impact) + "," + escapeCSV(v.description) + "," + escapeCSV(Array.isArray(n.target) ? n.target.join("; ") : String(n.target)) + "," + escapeCSV(n.failureSummary ?? ""));
-        });
-      });
-    }
-  });
-  return rows.join("\n");
-}
-function escapeCSV(value) {
-  const s = String(value ?? "");
-  return `"${s.replace(/"/g, '""')}"`;
-}
-function toHTML(allResults) {
-  const summary = {
-    pagesAudited: 0,
-    pagesWithViolations: 0,
-    totalViolations: 0,
-    distinctRules: /* @__PURE__ */ new Set(),
-    impactCounts: /* @__PURE__ */ new Map()
-  };
-  allResults.forEach(({ result }) => {
-    if (!result)
-      return;
-    summary.pagesAudited++;
-    const pageViolations = result.violations.reduce((acc, v) => {
-      const nodesCount = (v.nodes || []).length;
-      if (nodesCount > 0) {
-        summary.distinctRules.add(v.id);
-        summary.totalViolations += nodesCount;
-        acc += nodesCount;
-        const impact = String(v.impact ?? "unknown");
-        summary.impactCounts.set(impact, (summary.impactCounts.get(impact) || 0) + nodesCount);
-      }
-      return acc;
-    }, 0);
-    if (pageViolations > 0)
-      summary.pagesWithViolations++;
-  });
-  const rows = [];
-  allResults.forEach(({ url, result }) => {
-    if (!result)
-      return;
-    result.violations.forEach((v) => {
-      v.nodes.forEach((n) => {
-        const target = Array.isArray(n.target) ? n.target.join("; ") : String(n.target);
-        rows.push(`
-          <tr>
-            <td class="nowrap">${escapeHTML(url)}</td>
-            <td class="nowrap">${escapeHTML(v.id)}</td>
-            <td class="impact ${escapeClass(String(v.impact ?? "unknown"))}">${escapeHTML(String(v.impact ?? ""))}</td>
-            <td class="desc">${escapeHTML(v.description ?? "")}</td>
-            <td class="target"><code>${escapeHTML(target)}</code></td>
-            <td class="fail">${escapeHTML(n.failureSummary ?? "").split(/\r?\n/).join("<br/>")}</td>
-          </tr>
-        `);
-      });
-    });
-  });
-  const impactSummary = Array.from(summary.impactCounts.entries()).map(([impact, count]) => `<li><strong class="impact ${escapeClass(impact)}">${escapeHTML(impact)}</strong>: ${count}</li>`).join("\n");
-  const d = /* @__PURE__ */ new Date();
-  const pad = (n) => String(n).padStart(2, "0");
-  const reportDateTime = `${pad(d.getDate())}-${pad(d.getMonth() + 1)}-${d.getFullYear()} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`;
-  const headerSummary = `
-    <section class="summary">
-      <h2>Report summary</h2>
-      <ul>
-        <li><strong>Date:</strong> ${reportDateTime}</li>
-        <li><strong>Pages audited:</strong> ${summary.pagesAudited}</li>
-        <li><strong>Pages with violations:</strong> ${summary.pagesWithViolations}</li>
-        <li><strong>Total violations:</strong> ${summary.totalViolations}</li>
-        <li><strong>Distinct rules:</strong> ${summary.distinctRules.size}</li>
-      </ul>
-      <div class="impact-summary">
-        <h3>By impact</h3>
-        <ul class="summary-list">
-          ${impactSummary || "<li>None</li>"}
-        </ul>
-      </div>
-    </section>
-  `.trim();
-  const html = `
-    <!DOCTYPE html>
-    <html lang="en">
-      <head>
-        <meta charset="utf-8"/>
-        <title>Aria-Ease Accessibility Audit Report</title>
-        <meta name="viewport" content="width=device-width, initial-scale=1"/>
-        <style>
-          :root{
-            --bg:#ffffff; --muted:#6b7280; --border:#e6e9ee;
-            --impact-critical: red; --impact-moderate:#fff4dd; --impact-serious:rgb(255, 123, 0);
-          }
-          body{font-family:Inter,ui-sans-serif,system-ui,Segoe UI,Roboto,Helvetica,Arial; background:var(--bg); color:#111827; padding:24px; line-height:1.4}
-          h1{margin:0 0 8px}
-          .summary{background:#f8fafc;border:1px solid var(--border);padding:12px 16px;border-radius:8px;margin-bottom:18px}
-          .summary ul{margin:6px 0 0 0;padding:0 18px}
-          .impact-summary h3{margin:12px 0 6px}
-          table{width:100%; border-collapse:collapse; margin-top:12px}
-          th,td{border:1px solid var(--border); padding:10px; text-align:left; vertical-align:top}
-          th{background:#f3f4f6; font-weight:600; position:sticky; top:0; z-index:1}
-          .nowrap{white-space:nowrap}
-          .target code{font-family:ui-monospace, SFMono-Regular, Menlo, Monaco, "Roboto Mono", "Courier New", monospace; white-space:pre-wrap}
-          .desc{max-width:380px}
-          tr:nth-child(even){background:#fbfbfb}
-          td.fail{color:#7b1e1e}
-          .impact.critical{background:var(--impact-critical); font-weight:600}
-          .impact.moderate{background:var(--impact-moderate); font-weight:600}
-          .impact.serious{background:var(--impact-serious); font-weight:600}
-          @media (max-width:900px){
-            .desc{max-width:200px}
-            table, thead, tbody, th, td, tr{display:block}
-            thead{display:none}
-            tr{margin-bottom:10px; border: 1px solid var(--border);}
-            td{border:1px solid var(--border); padding:6px}
-            td::before{font-weight:600; display:inline-block; width:120px}
-          }
-          .summary-list strong,
-          .summary-list li {
-            padding: 2px 4px;
-          }
-        </style>
-      </head>
-      <body>
-        <h1>Aria-Ease Accessibility Audit Report</h1>
-        ${headerSummary}
-        <table>
-          <thead>
-            <tr>
-              <th>URL</th><th>Rule</th><th>Impact</th><th>Description</th><th>Target</th><th>FailureSummary</th>
-            </tr>
-          </thead>
-          <tbody>
-            ${rows.join("\n") || '<tr><td colspan="6"><em>No violations found.</em></td></tr>'}
-          </tbody>
-        </table>
-      </body>
-    </html>
-  `.trim();
-  return html;
-}
-function escapeHTML(str) {
-  return String(str ?? "").replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&#39;");
-}
-function escapeClass(s) {
-  return String(s ?? "").toLowerCase().replace(/[^a-z0-9]+/g, "-");
-}
-
-// src/utils/test/src/test.ts
-import { axe } from "jest-axe";
-var runTest = async () => {
-};
-if (typeof window === "undefined") {
-  runTest = async () => {
-    console.log(`\u{1F680} Running component accessibility tests...
-`);
-    const { exec } = await import("child_process");
-    exec(
-      `npx vitest --run --reporter verbose`,
-      { cwd: process.cwd() },
-      (error, stdout, stderr) => {
-        if (stdout) {
-          console.log(stdout);
-        }
-        if (stderr) {
-          console.error(stderr);
-        }
-        if (error && error.code) {
-          process.exit(error.code);
-        }
-      }
-    );
-  };
-}
-
 // src/utils/cli/configLoader.js
 import path from "path";
 import fs from "fs-extra";
@@ -369,6 +128,8 @@ var program = new Command();
 program.name("aria-ease").description("Run accessibility tests and audits").version("2.2.3");
 program.command("audit").description("Run axe-core powered accessibility audit on webpages").option("-u, --url <url>", "Single URL to audit").option("-f, --format <format>", "Output format for the audit report: json | csv | html | all", "all").option("-o, --out <path>", "Directory to save the audit report", "./accessibility-reports/audit").action(async (opts) => {
   console.log(chalk.cyanBright("\u{1F680} Starting accessibility audit...\n"));
+  const { runAudit } = await import("./audit-XABLAI36.js");
+  const { formatResults } = await import("./formatters-2RPHPXW2.js");
   const { config, configPath, errors } = await loadConfig(process.cwd());
   if (configPath) {
     console.log(chalk.green(`\u2705 Loaded config from ${path2.basename(configPath)}
@@ -442,7 +203,8 @@ program.command("audit").description("Run axe-core powered accessibility audit o
   }
   console.log(chalk.green("\n\u{1F389} All audits completed."));
 });
-program.command("test").description("Run core a11y accessibility standard tests on UI components").action(() => {
+program.command("test").description("Run core a11y accessibility standard tests on UI components").action(async () => {
+  const { runTest } = await import("./test-S2U633GD.js");
   runTest();
 });
 program.command("help").description("Display help information").action(() => {

package/dist/{contractTestRunnerPlaywright-YNHMLHQ2.js → contractTestRunnerPlaywright-7O2T4JES.js}

@@ -25,8 +25,11 @@ async function runContractTestsPlaywright(componentName, url) {
     browser = await chromium.launch({ headless: true });
     const context = await browser.newContext();
     const page = await context.newPage();
-    await page.goto(url, { waitUntil: "networkidle" });
-    await page.waitForSelector(componentContract.selectors.trigger, { timeout: 3e4 });
+    await page.goto(url, {
+      waitUntil: "domcontentloaded",
+      timeout: 6e4
+    });
+    await page.waitForSelector(componentContract.selectors.trigger, { timeout: 6e4 });
     async function resolveRelativeTarget(selector, relative) {
       const items = await page.locator(selector).all();
       switch (relative) {

package/dist/{contractTestRunnerPlaywright-ZY2T4UTV.js → contractTestRunnerPlaywright-AJ2DOOJT.js}

@@ -25,8 +25,11 @@ async function runContractTestsPlaywright(componentName, url) {
     browser = await chromium.launch({ headless: true });
     const context = await browser.newContext();
     const page = await context.newPage();
-    await page.goto(url, { waitUntil: "networkidle" });
-    await page.waitForSelector(componentContract.selectors.trigger, { timeout: 9e4 });
+    await page.goto(url, {
+      waitUntil: "domcontentloaded",
+      timeout: 6e4
+    });
+    await page.waitForSelector(componentContract.selectors.trigger, { timeout: 6e4 });
     async function resolveRelativeTarget(selector, relative) {
       const items = await page.locator(selector).all();
       switch (relative) {
@@ -148,6 +151,11 @@ async function runContractTestsPlaywright(componentName, url) {
               continue;
             }
             const target = page.locator(keypressSelector).first();
+            const elementCount = await target.count();
+            if (elementCount === 0) {
+              reporter.reportTest(dynamicTest, "skip", `Skipping test - ${act.target} element not found (optional submenu test)`);
+              break;
+            }
             await target.press(keyValue);
           }
         }

package/dist/index.cjs

@@ -9419,8 +9419,11 @@ async function runContractTestsPlaywright(componentName, url) {
     browser = await import_playwright.chromium.launch({ headless: true });
     const context = await browser.newContext();
     const page = await context.newPage();
-    await page.goto(url, { waitUntil: "networkidle" });
-    await page.waitForSelector(componentContract.selectors.trigger, { timeout: 3e4 });
+    await page.goto(url, {
+      waitUntil: "domcontentloaded",
+      timeout: 6e4
+    });
+    await page.waitForSelector(componentContract.selectors.trigger, { timeout: 6e4 });
     async function resolveRelativeTarget(selector, relative) {
       const items = await page.locator(selector).all();
       switch (relative) {
@@ -9542,6 +9545,11 @@ async function runContractTestsPlaywright(componentName, url) {
               continue;
             }
             const target = page.locator(keypressSelector).first();
+            const elementCount = await target.count();
+            if (elementCount === 0) {
+              reporter.reportTest(dynamicTest, "skip", `Skipping test - ${act.target} element not found (optional submenu test)`);
+              break;
+            }
             await target.press(keyValue);
           }
         }

package/dist/index.js

@@ -13171,7 +13171,7 @@ async function testUiComponent(componentName, component, url) {
   let contract;
   if (url) {
     console.log(`\u{1F3AD} Running Playwright E2E tests on ${url}`);
-    const { runContractTestsPlaywright } = await import("./contractTestRunnerPlaywright-YNHMLHQ2.js");
+    const { runContractTestsPlaywright } = await import("./contractTestRunnerPlaywright-AJ2DOOJT.js");
     contract = await runContractTestsPlaywright(componentName, url);
   } else {
     console.log(`\u{1F9EA} Running jsdom tests (limited event handling)`);

package/dist/src/utils/test/{contractTestRunnerPlaywright-I36Y2NHA.js → contractTestRunnerPlaywright-7O2T4JES.js}

@@ -21,8 +21,11 @@ async function runContractTestsPlaywright(componentName, url) {
     browser = await chromium.launch({ headless: true });
     const context = await browser.newContext();
     const page = await context.newPage();
-    await page.goto(url, { waitUntil: "networkidle" });
-    await page.waitForSelector(componentContract.selectors.trigger, { timeout: 5e3 });
+    await page.goto(url, {
+      waitUntil: "domcontentloaded",
+      timeout: 6e4
+    });
+    await page.waitForSelector(componentContract.selectors.trigger, { timeout: 6e4 });
     async function resolveRelativeTarget(selector, relative) {
       const items = await page.locator(selector).all();
       switch (relative) {

package/dist/src/utils/test/{contractTestRunnerPlaywright-YNHMLHQ2.js → contractTestRunnerPlaywright-AJ2DOOJT.js}

@@ -21,8 +21,11 @@ async function runContractTestsPlaywright(componentName, url) {
     browser = await chromium.launch({ headless: true });
     const context = await browser.newContext();
     const page = await context.newPage();
-    await page.goto(url, { waitUntil: "networkidle" });
-    await page.waitForSelector(componentContract.selectors.trigger, { timeout: 3e4 });
+    await page.goto(url, {
+      waitUntil: "domcontentloaded",
+      timeout: 6e4
+    });
+    await page.waitForSelector(componentContract.selectors.trigger, { timeout: 6e4 });
     async function resolveRelativeTarget(selector, relative) {
       const items = await page.locator(selector).all();
       switch (relative) {
@@ -144,6 +147,11 @@ async function runContractTestsPlaywright(componentName, url) {
               continue;
             }
             const target = page.locator(keypressSelector).first();
+            const elementCount = await target.count();
+            if (elementCount === 0) {
+              reporter.reportTest(dynamicTest, "skip", `Skipping test - ${act.target} element not found (optional submenu test)`);
+              break;
+            }
             await target.press(keyValue);
           }
         }

package/dist/src/utils/test/index.cjs

@@ -9257,8 +9257,11 @@ async function runContractTestsPlaywright(componentName, url) {
     browser = await playwright.chromium.launch({ headless: true });
     const context = await browser.newContext();
     const page = await context.newPage();
-    await page.goto(url, { waitUntil: "networkidle" });
-    await page.waitForSelector(componentContract.selectors.trigger, { timeout: 3e4 });
+    await page.goto(url, {
+      waitUntil: "domcontentloaded",
+      timeout: 6e4
+    });
+    await page.waitForSelector(componentContract.selectors.trigger, { timeout: 6e4 });
     async function resolveRelativeTarget(selector, relative) {
       const items = await page.locator(selector).all();
       switch (relative) {
@@ -9380,6 +9383,11 @@ async function runContractTestsPlaywright(componentName, url) {
               continue;
             }
             const target = page.locator(keypressSelector).first();
+            const elementCount = await target.count();
+            if (elementCount === 0) {
+              reporter.reportTest(dynamicTest, "skip", `Skipping test - ${act.target} element not found (optional submenu test)`);
+              break;
+            }
             await target.press(keyValue);
           }
         }

package/dist/src/utils/test/index.js

@@ -12524,7 +12524,7 @@ async function testUiComponent(componentName, component, url) {
   let contract;
   if (url) {
     console.log(`\u{1F3AD} Running Playwright E2E tests on ${url}`);
-    const { runContractTestsPlaywright } = await import('./contractTestRunnerPlaywright-YNHMLHQ2.js');
+    const { runContractTestsPlaywright } = await import('./contractTestRunnerPlaywright-AJ2DOOJT.js');
     contract = await runContractTestsPlaywright(componentName, url);
   } else {
     console.log(`\u{1F9EA} Running jsdom tests (limited event handling)`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aria-ease",
-  "version": "2.8.2",
+  "version": "2.8.3",
   "description": "Out-of-the-box accessibility utility package to develop production ready applications.",
   "main": "dist/index.cjs",
   "type": "module",

package/dist/chunk-PCORWVIQ.js

@@ -1,213 +0,0 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
-var __commonJS = (cb, mod) => function __require2() {
-  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-
-// src/utils/test/contract/contract.json
-var contract_default = {
-  menu: {
-    path: "./contracts/MenuContract.json",
-    component: "menu"
-  }
-};
-
-// src/utils/test/contract/ContractReporter.ts
-var ContractReporter = class {
-  startTime = 0;
-  componentName = "";
-  staticPasses = 0;
-  staticFailures = 0;
-  dynamicResults = [];
-  totalTests = 0;
-  skipped = 0;
-  isPlaywright = false;
-  constructor(isPlaywright = false) {
-    this.isPlaywright = isPlaywright;
-  }
-  log(message) {
-    process.stderr.write(message + "\n");
-  }
-  start(componentName, totalTests) {
-    this.startTime = Date.now();
-    this.componentName = componentName;
-    this.totalTests = totalTests;
-    const mode = this.isPlaywright ? "Playwright (Real Browser)" : "jsdom (Fast)";
-    this.log(`
-${"\u2550".repeat(60)}`);
-    this.log(`\u{1F50D} Testing ${componentName} Component - ${mode}`);
-    this.log(`${"\u2550".repeat(60)}
-`);
-  }
-  reportStatic(passes, failures) {
-    this.staticPasses = passes;
-    this.staticFailures = failures;
-    const icon = failures === 0 ? "\u2705" : "\u274C";
-    const status = failures === 0 ? "PASS" : "FAIL";
-    this.log(`${icon} Static ARIA Tests: ${status}`);
-    this.log(`   ${passes}/${passes + failures} required attributes present
-`);
-  }
-  /**
-   * Report individual dynamic test result
-   */
-  reportTest(test, status, failureMessage) {
-    const result = {
-      description: test.description,
-      status,
-      failureMessage
-    };
-    if (status === "skip" && test.requiresBrowser) {
-      result.skipReason = "Requires real browser (addEventListener events)";
-    }
-    this.dynamicResults.push(result);
-    const icons = { pass: "\u2713", fail: "\u2717", skip: "\u25CB" };
-    this.log(`  ${icons[status]} ${test.description}`);
-    if (status === "skip" && !this.isPlaywright) {
-      this.log(`     \u21B3 Skipped in jsdom (runs in Playwright)`);
-    }
-    if (status === "fail" && failureMessage) {
-      this.log(`     \u21B3 ${failureMessage}`);
-    }
-  }
-  /**
-   * Report all failures with actionable context
-   */
-  reportFailures(failures) {
-    if (failures.length === 0) return;
-    this.log(`
-${"\u2500".repeat(60)}`);
-    this.log(`\u274C Failures (${failures.length}):
-`);
-    failures.forEach((failure, index) => {
-      this.log(`${index + 1}. ${failure}`);
-      if (failure.includes("aria-")) {
-        this.log(`   \u{1F4A1} Add the missing ARIA attribute to improve screen reader support`);
-      } else if (failure.includes("focus")) {
-        this.log(`   \u{1F4A1} Check keyboard event handlers and focus management`);
-      } else if (failure.includes("visible")) {
-        this.log(`   \u{1F4A1} Verify display/visibility styles and state management`);
-      }
-      this.log("");
-    });
-  }
-  /**
-   * Report skipped tests with helpful context
-   */
-  reportSkipped() {
-    if (this.skipped === 0 || this.isPlaywright) return;
-    const skippedTests = this.dynamicResults.filter((r) => r.status === "skip");
-    this.log(`
-${"\u2500".repeat(60)}`);
-    this.log(`\u2139\uFE0F  Skipped Tests (${this.skipped}):
-`);
-    this.log(`These tests use native keyboard events via addEventListener,`);
-    this.log(`which jsdom cannot simulate. They run successfully in Playwright.
-`);
-    skippedTests.forEach((test, index) => {
-      this.log(`${index + 1}. ${test.description}`);
-    });
-    this.log(`
-\u{1F4A1} Run with Playwright for full validation:`);
-    this.log(`   testUiComponent('${this.componentName}', component, 'http://localhost:5173/')
-`);
-  }
-  /**
-   * Generate final summary with statistics
-   */
-  summary(failures) {
-    const duration = Date.now() - this.startTime;
-    const dynamicPasses = this.dynamicResults.filter((r) => r.status === "pass").length;
-    const dynamicFailures = this.dynamicResults.filter((r) => r.status === "fail").length;
-    this.skipped = this.dynamicResults.filter((r) => r.status === "skip").length;
-    const totalPasses = this.staticPasses + dynamicPasses;
-    const totalFailures = this.staticFailures + dynamicFailures;
-    const totalRun = totalPasses + totalFailures;
-    if (failures.length > 0) {
-      this.reportFailures(failures);
-    }
-    this.reportSkipped();
-    this.log(`
-${"\u2550".repeat(60)}`);
-    this.log(`\u{1F4CA} Summary
-`);
-    if (totalFailures === 0 && this.skipped === 0) {
-      this.log(`\u2705 All ${totalRun} tests passed!`);
-      this.log(`   ${this.componentName} component meets APG and WCAG guidelines \u2713`);
-    } else if (totalFailures === 0) {
-      this.log(`\u2705 ${totalPasses}/${totalRun} tests passed`);
-      this.log(`\u25CB  ${this.skipped} tests skipped (jsdom limitation)`);
-      this.log(`   ${this.componentName} component works correctly`);
-    } else {
-      this.log(`\u274C ${totalFailures} test${totalFailures > 1 ? "s" : ""} failed`);
-      this.log(`\u2705 ${totalPasses} test${totalPasses > 1 ? "s" : ""} passed`);
-      if (this.skipped > 0) {
-        this.log(`\u25CB  ${this.skipped} test${this.skipped > 1 ? "s" : ""} skipped`);
-      }
-    }
-    this.log(`\u23F1\uFE0F  Duration: ${duration}ms`);
-    this.log(`${"\u2550".repeat(60)}
-`);
-    if (totalFailures > 0) {
-      this.log(`\u{1F527} Next Steps:`);
-      this.log(`   1. Review the failures above`);
-      this.log(`   2. Fix ARIA attributes and keyboard handlers`);
-      this.log(`   3. Re-run tests to verify fixes
-`);
-    } else if (!this.isPlaywright && this.skipped > 0) {
-      this.log(`\u2728 Optional: Run Playwright tests for complete validation
-`);
-    }
-    return {
-      passes: totalPasses,
-      failures: totalFailures,
-      skipped: this.skipped,
-      duration
-    };
-  }
-  /**
-   * Report an error during test execution
-   */
-  error(message, context) {
-    this.log(`
-\u274C Error: ${message}`);
-    if (context) {
-      this.log(`   Context: ${context}`);
-    }
-    this.log("");
-  }
-};
-
-export {
-  __require,
-  __commonJS,
-  __toESM,
-  contract_default,
-  ContractReporter
-};

package/dist/contractTestRunnerPlaywright-SE6TPWZZ.js

@@ -1,254 +0,0 @@
-import {
-  ContractReporter,
-  contract_default
-} from "./chunk-PCORWVIQ.js";
-
-// src/utils/test/contract/contractTestRunnerPlaywright.ts
-import { chromium } from "playwright";
-import { readFileSync } from "fs";
-async function runContractTestsPlaywright(componentName, url) {
-  const reporter = new ContractReporter(true);
-  const contractTyped = contract_default;
-  const contractPath = contractTyped[componentName]?.path;
-  if (!contractPath) {
-    throw new Error(`Contract path not found for component: ${componentName}`);
-  }
-  const resolvedPath = new URL(contractPath, import.meta.url).pathname;
-  const contractData = readFileSync(resolvedPath, "utf-8");
-  const componentContract = JSON.parse(contractData);
-  const totalTests = componentContract.static[0].assertions.length + componentContract.dynamic.length;
-  reporter.start(componentName, totalTests);
-  const failures = [];
-  const passes = [];
-  let browser = null;
-  try {
-    browser = await chromium.launch({ headless: true });
-    const context = await browser.newContext();
-    const page = await context.newPage();
-    await page.goto(url, { waitUntil: "networkidle" });
-    await page.waitForSelector(componentContract.selectors.trigger, { timeout: 5e3 });
-    async function resolveRelativeTarget(selector, relative) {
-      const items = await page.locator(selector).all();
-      switch (relative) {
-        case "first":
-          return items[0];
-        case "second":
-          return items[1];
-        case "last":
-          return items[items.length - 1];
-        case "next": {
-          const currentIndex = await page.evaluate(([sel]) => {
-            const items2 = Array.from(document.querySelectorAll(sel));
-            return items2.indexOf(document.activeElement);
-          }, [selector]);
-          const nextIndex = (currentIndex + 1) % items.length;
-          return items[nextIndex];
-        }
-        case "previous": {
-          const currentIndex = await page.evaluate(([sel]) => {
-            const items2 = Array.from(document.querySelectorAll(sel));
-            return items2.indexOf(document.activeElement);
-          }, [selector]);
-          const prevIndex = (currentIndex - 1 + items.length) % items.length;
-          return items[prevIndex];
-        }
-        default:
-          return null;
-      }
-    }
-    for (const test of componentContract.static[0]?.assertions || []) {
-      if (test.target === "relative") continue;
-      const targetSelector = componentContract.selectors[test.target];
-      if (!targetSelector) {
-        failures.push(`Selector for target ${test.target} not found.`);
-        continue;
-      }
-      const target = page.locator(targetSelector).first();
-      const exists = await target.count() > 0;
-      if (!exists) {
-        failures.push(`Target ${test.target} not found.`);
-        continue;
-      }
-      if (!test.expectedValue) {
-        const attributes = test.attribute.split(" | ");
-        let hasAny = false;
-        for (const attr of attributes) {
-          const value = await target.getAttribute(attr.trim());
-          if (value !== null) {
-            hasAny = true;
-            break;
-          }
-        }
-        if (!hasAny) {
-          failures.push(test.failureMessage + ` None of the attributes "${test.attribute}" are present.`);
-        } else {
-          passes.push(`At least one of the attributes "${test.attribute}" exists on the element.`);
-        }
-      } else {
-        const attributeValue = await target.getAttribute(test.attribute);
-        const expectedValues = test.expectedValue.split(" | ");
-        if (!attributeValue || !expectedValues.includes(attributeValue)) {
-          failures.push(test.failureMessage + ` Attribute value does not match expected value. Expected: ${test.expectedValue}, Found: ${attributeValue}`);
-        } else {
-          passes.push(`Attribute value matches expected value. Expected: ${test.expectedValue}, Found: ${attributeValue}`);
-        }
-      }
-    }
-    for (const dynamicTest of componentContract.dynamic || []) {
-      const { action, assertions } = dynamicTest;
-      const failuresBeforeTest = failures.length;
-      const containerElement = page.locator(componentContract.selectors.container).first();
-      const triggerElement = page.locator(componentContract.selectors.trigger).first();
-      const isContainerVisible = await containerElement.isVisible();
-      if (isContainerVisible) {
-        await triggerElement.click();
-        await page.waitForTimeout(50);
-      }
-      for (const act of action) {
-        if (act.type === "click") {
-          if (act.target === "document") {
-            await page.mouse.click(10, 10);
-          } else {
-            const actionSelector = componentContract.selectors[act.target];
-            if (!actionSelector) {
-              failures.push(`Selector for action target ${act.target} not found.`);
-              continue;
-            }
-            await page.locator(actionSelector).first().click();
-            await page.waitForTimeout(200);
-          }
-        }
-        if (act.type === "keypress" && act.key) {
-          const keyMap = {
-            "Space": "Space",
-            "Enter": "Enter",
-            "Escape": "Escape",
-            "Arrow Up": "ArrowUp",
-            "Arrow Down": "ArrowDown",
-            "Arrow Left": "ArrowLeft",
-            "Arrow Right": "ArrowRight",
-            "Home": "Home",
-            "End": "End",
-            "Tab": "Tab"
-          };
-          let keyValue = keyMap[act.key] || act.key;
-          if (keyValue === "Space") {
-            keyValue = " ";
-          } else if (keyValue.includes(" ")) {
-            keyValue = keyValue.replace(/ /g, "");
-          }
-          if (act.target === "focusable" && ["ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Escape"].includes(keyValue)) {
-            await page.waitForTimeout(100);
-            await page.keyboard.press(keyValue);
-            await page.waitForTimeout(50);
-          } else {
-            const keypressSelector = componentContract.selectors[act.target];
-            if (!keypressSelector) {
-              failures.push(`Selector for keypress target ${act.target} not found.`);
-              continue;
-            }
-            const target = page.locator(keypressSelector).first();
-            await target.press(keyValue);
-          }
-        }
-        await page.waitForTimeout(100);
-      }
-      for (const assertion of assertions) {
-        let target;
-        if (assertion.target === "relative") {
-          const relativeSelector = componentContract.selectors.relative;
-          if (!relativeSelector) {
-            failures.push("Relative selector is not defined in the contract.");
-            continue;
-          }
-          if (!assertion.expectedValue) {
-            failures.push("Expected value for relative target is not defined.");
-            continue;
-          }
-          target = await resolveRelativeTarget(relativeSelector, assertion.expectedValue);
-        } else {
-          const assertionSelector = componentContract.selectors[assertion.target];
-          if (!assertionSelector) {
-            failures.push(`Selector for assertion target ${assertion.target} not found.`);
-            continue;
-          }
-          target = page.locator(assertionSelector).first();
-        }
-        if (!target) {
-          failures.push(`Target ${assertion.target} not found.`);
-          continue;
-        }
-        if (assertion.assertion === "toBeVisible") {
-          const isVisible = await target.isVisible();
-          if (isVisible) {
-            passes.push(`${assertion.target} is visible as expected. Test: "${dynamicTest.description}".`);
-          } else {
-            failures.push(`${assertion.failureMessage}`);
-          }
-        }
-        if (assertion.assertion === "notToBeVisible") {
-          const isVisible = await target.isVisible();
-          if (!isVisible) {
-            passes.push(`${assertion.target} is not visible as expected. Test: "${dynamicTest.description}".`);
-          } else {
-            failures.push(assertion.failureMessage + ` ${assertion.target} is still visible.`);
-          }
-        }
-        if (assertion.assertion === "toHaveAttribute" && assertion.attribute && assertion.expectedValue) {
-          const attributeValue = await target.getAttribute(assertion.attribute);
-          if (attributeValue === assertion.expectedValue) {
-            passes.push(`${assertion.target} has expected "${assertion.attribute}". Test: "${dynamicTest.description}".`);
-          } else {
-            failures.push(assertion.failureMessage + ` ${assertion.target} "${assertion.attribute}" should be "${assertion.expectedValue}", found "${attributeValue}".`);
-          }
-        }
-        if (assertion.assertion === "toHaveFocus") {
-          const hasFocus = await target.evaluate((el) => el === document.activeElement);
-          if (hasFocus) {
-            passes.push(`${assertion.target} has focus as expected. Test: "${dynamicTest.description}".`);
-          } else {
-            failures.push(`${assertion.failureMessage}`);
-          }
-        }
-        if (assertion.assertion === "toHaveRole" && assertion.expectedValue) {
-          const roleValue = await target.getAttribute("role");
-          if (roleValue === assertion.expectedValue) {
-            passes.push(`${assertion.target} has role "${assertion.expectedValue}". Test: "${dynamicTest.description}".`);
-          } else {
-            failures.push(assertion.failureMessage + ` Expected role "${assertion.expectedValue}", found "${roleValue}".`);
-          }
-        }
-      }
-      const failuresAfterTest = failures.length;
-      const testPassed = failuresAfterTest === failuresBeforeTest;
-      const failureMessage = testPassed ? void 0 : failures[failures.length - 1];
-      reporter.reportTest(dynamicTest, testPassed ? "pass" : "fail", failureMessage);
-    }
-    const staticPassed = componentContract.static[0].assertions.length;
-    const staticFailed = 0;
-    reporter.reportStatic(staticPassed, staticFailed);
-    reporter.summary(failures);
-  } catch (error) {
-    if (error instanceof Error) {
-      if (error.message.includes("Executable doesn't exist")) {
-        console.error("\n\u274C Playwright browsers not found!\n");
-        console.log("\u{1F4E6} Run: npx playwright install chromium\n");
-        failures.push("Playwright browser not installed. Run: npx playwright install chromium");
-      } else if (error.message.includes("net::ERR_CONNECTION_REFUSED")) {
-        console.error("\n\u274C Cannot connect to dev server!\n");
-        console.log(`   Make sure your dev server is running at ${url}
-`);
-        failures.push(`Dev server not running at ${url}`);
-      } else {
-        console.error("\u274C Playwright test error:", error.message);
-        failures.push(`Test error: ${error.message}`);
-      }
-    }
-  } finally {
-    if (browser) await browser.close();
-  }
-  return { passes, failures };
-}
-export {
-  runContractTestsPlaywright
-};

package/dist/src/utils/test/contractTestRunnerPlaywright-ZY2T4UTV.js

@@ -1,249 +0,0 @@
-import { ContractReporter, contract_default } from './chunk-SSBW5VAA.js';
-import { chromium } from 'playwright';
-import { readFileSync } from 'fs';
-
-async function runContractTestsPlaywright(componentName, url) {
-  const reporter = new ContractReporter(true);
-  const contractTyped = contract_default;
-  const contractPath = contractTyped[componentName]?.path;
-  if (!contractPath) {
-    throw new Error(`Contract path not found for component: ${componentName}`);
-  }
-  const resolvedPath = new URL(contractPath, import.meta.url).pathname;
-  const contractData = readFileSync(resolvedPath, "utf-8");
-  const componentContract = JSON.parse(contractData);
-  const totalTests = componentContract.static[0].assertions.length + componentContract.dynamic.length;
-  reporter.start(componentName, totalTests);
-  const failures = [];
-  const passes = [];
-  let browser = null;
-  try {
-    browser = await chromium.launch({ headless: true });
-    const context = await browser.newContext();
-    const page = await context.newPage();
-    await page.goto(url, { waitUntil: "networkidle" });
-    await page.waitForSelector(componentContract.selectors.trigger, { timeout: 9e4 });
-    async function resolveRelativeTarget(selector, relative) {
-      const items = await page.locator(selector).all();
-      switch (relative) {
-        case "first":
-          return items[0];
-        case "second":
-          return items[1];
-        case "last":
-          return items[items.length - 1];
-        case "next": {
-          const currentIndex = await page.evaluate(([sel]) => {
-            const items2 = Array.from(document.querySelectorAll(sel));
-            return items2.indexOf(document.activeElement);
-          }, [selector]);
-          const nextIndex = (currentIndex + 1) % items.length;
-          return items[nextIndex];
-        }
-        case "previous": {
-          const currentIndex = await page.evaluate(([sel]) => {
-            const items2 = Array.from(document.querySelectorAll(sel));
-            return items2.indexOf(document.activeElement);
-          }, [selector]);
-          const prevIndex = (currentIndex - 1 + items.length) % items.length;
-          return items[prevIndex];
-        }
-        default:
-          return null;
-      }
-    }
-    for (const test of componentContract.static[0]?.assertions || []) {
-      if (test.target === "relative") continue;
-      const targetSelector = componentContract.selectors[test.target];
-      if (!targetSelector) {
-        failures.push(`Selector for target ${test.target} not found.`);
-        continue;
-      }
-      const target = page.locator(targetSelector).first();
-      const exists = await target.count() > 0;
-      if (!exists) {
-        failures.push(`Target ${test.target} not found.`);
-        continue;
-      }
-      if (!test.expectedValue) {
-        const attributes = test.attribute.split(" | ");
-        let hasAny = false;
-        for (const attr of attributes) {
-          const value = await target.getAttribute(attr.trim());
-          if (value !== null) {
-            hasAny = true;
-            break;
-          }
-        }
-        if (!hasAny) {
-          failures.push(test.failureMessage + ` None of the attributes "${test.attribute}" are present.`);
-        } else {
-          passes.push(`At least one of the attributes "${test.attribute}" exists on the element.`);
-        }
-      } else {
-        const attributeValue = await target.getAttribute(test.attribute);
-        const expectedValues = test.expectedValue.split(" | ");
-        if (!attributeValue || !expectedValues.includes(attributeValue)) {
-          failures.push(test.failureMessage + ` Attribute value does not match expected value. Expected: ${test.expectedValue}, Found: ${attributeValue}`);
-        } else {
-          passes.push(`Attribute value matches expected value. Expected: ${test.expectedValue}, Found: ${attributeValue}`);
-        }
-      }
-    }
-    for (const dynamicTest of componentContract.dynamic || []) {
-      const { action, assertions } = dynamicTest;
-      const failuresBeforeTest = failures.length;
-      const containerElement = page.locator(componentContract.selectors.container).first();
-      const triggerElement = page.locator(componentContract.selectors.trigger).first();
-      const isContainerVisible = await containerElement.isVisible();
-      if (isContainerVisible) {
-        await triggerElement.click();
-        await page.waitForTimeout(50);
-      }
-      for (const act of action) {
-        if (act.type === "click") {
-          if (act.target === "document") {
-            await page.mouse.click(10, 10);
-          } else {
-            const actionSelector = componentContract.selectors[act.target];
-            if (!actionSelector) {
-              failures.push(`Selector for action target ${act.target} not found.`);
-              continue;
-            }
-            await page.locator(actionSelector).first().click();
-            await page.waitForTimeout(200);
-          }
-        }
-        if (act.type === "keypress" && act.key) {
-          const keyMap = {
-            "Space": "Space",
-            "Enter": "Enter",
-            "Escape": "Escape",
-            "Arrow Up": "ArrowUp",
-            "Arrow Down": "ArrowDown",
-            "Arrow Left": "ArrowLeft",
-            "Arrow Right": "ArrowRight",
-            "Home": "Home",
-            "End": "End",
-            "Tab": "Tab"
-          };
-          let keyValue = keyMap[act.key] || act.key;
-          if (keyValue === "Space") {
-            keyValue = " ";
-          } else if (keyValue.includes(" ")) {
-            keyValue = keyValue.replace(/ /g, "");
-          }
-          if (act.target === "focusable" && ["ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Escape"].includes(keyValue)) {
-            await page.waitForTimeout(100);
-            await page.keyboard.press(keyValue);
-            await page.waitForTimeout(50);
-          } else {
-            const keypressSelector = componentContract.selectors[act.target];
-            if (!keypressSelector) {
-              failures.push(`Selector for keypress target ${act.target} not found.`);
-              continue;
-            }
-            const target = page.locator(keypressSelector).first();
-            await target.press(keyValue);
-          }
-        }
-        await page.waitForTimeout(100);
-      }
-      for (const assertion of assertions) {
-        let target;
-        if (assertion.target === "relative") {
-          const relativeSelector = componentContract.selectors.relative;
-          if (!relativeSelector) {
-            failures.push("Relative selector is not defined in the contract.");
-            continue;
-          }
-          if (!assertion.expectedValue) {
-            failures.push("Expected value for relative target is not defined.");
-            continue;
-          }
-          target = await resolveRelativeTarget(relativeSelector, assertion.expectedValue);
-        } else {
-          const assertionSelector = componentContract.selectors[assertion.target];
-          if (!assertionSelector) {
-            failures.push(`Selector for assertion target ${assertion.target} not found.`);
-            continue;
-          }
-          target = page.locator(assertionSelector).first();
-        }
-        if (!target) {
-          failures.push(`Target ${assertion.target} not found.`);
-          continue;
-        }
-        if (assertion.assertion === "toBeVisible") {
-          const isVisible = await target.isVisible();
-          if (isVisible) {
-            passes.push(`${assertion.target} is visible as expected. Test: "${dynamicTest.description}".`);
-          } else {
-            failures.push(`${assertion.failureMessage}`);
-          }
-        }
-        if (assertion.assertion === "notToBeVisible") {
-          const isVisible = await target.isVisible();
-          if (!isVisible) {
-            passes.push(`${assertion.target} is not visible as expected. Test: "${dynamicTest.description}".`);
-          } else {
-            failures.push(assertion.failureMessage + ` ${assertion.target} is still visible.`);
-          }
-        }
-        if (assertion.assertion === "toHaveAttribute" && assertion.attribute && assertion.expectedValue) {
-          const attributeValue = await target.getAttribute(assertion.attribute);
-          if (attributeValue === assertion.expectedValue) {
-            passes.push(`${assertion.target} has expected "${assertion.attribute}". Test: "${dynamicTest.description}".`);
-          } else {
-            failures.push(assertion.failureMessage + ` ${assertion.target} "${assertion.attribute}" should be "${assertion.expectedValue}", found "${attributeValue}".`);
-          }
-        }
-        if (assertion.assertion === "toHaveFocus") {
-          const hasFocus = await target.evaluate((el) => el === document.activeElement);
-          if (hasFocus) {
-            passes.push(`${assertion.target} has focus as expected. Test: "${dynamicTest.description}".`);
-          } else {
-            failures.push(`${assertion.failureMessage}`);
-          }
-        }
-        if (assertion.assertion === "toHaveRole" && assertion.expectedValue) {
-          const roleValue = await target.getAttribute("role");
-          if (roleValue === assertion.expectedValue) {
-            passes.push(`${assertion.target} has role "${assertion.expectedValue}". Test: "${dynamicTest.description}".`);
-          } else {
-            failures.push(assertion.failureMessage + ` Expected role "${assertion.expectedValue}", found "${roleValue}".`);
-          }
-        }
-      }
-      const failuresAfterTest = failures.length;
-      const testPassed = failuresAfterTest === failuresBeforeTest;
-      const failureMessage = testPassed ? void 0 : failures[failures.length - 1];
-      reporter.reportTest(dynamicTest, testPassed ? "pass" : "fail", failureMessage);
-    }
-    const staticPassed = componentContract.static[0].assertions.length;
-    const staticFailed = 0;
-    reporter.reportStatic(staticPassed, staticFailed);
-    reporter.summary(failures);
-  } catch (error) {
-    if (error instanceof Error) {
-      if (error.message.includes("Executable doesn't exist")) {
-        console.error("\n\u274C Playwright browsers not found!\n");
-        console.log("\u{1F4E6} Run: npx playwright install chromium\n");
-        failures.push("Playwright browser not installed. Run: npx playwright install chromium");
-      } else if (error.message.includes("net::ERR_CONNECTION_REFUSED")) {
-        console.error("\n\u274C Cannot connect to dev server!\n");
-        console.log(`   Make sure your dev server is running at ${url}
-`);
-        failures.push(`Dev server not running at ${url}`);
-      } else {
-        console.error("\u274C Playwright test error:", error.message);
-        failures.push(`Test error: ${error.message}`);
-      }
-    }
-  } finally {
-    if (browser) await browser.close();
-  }
-  return { passes, failures };
-}
-
-export { runContractTestsPlaywright };