aria-ease 2.8.3 → 2.9.0

package/bin/audit-XZJXMUPL.js

@@ -0,0 +1,46 @@
+import "./chunk-JSBRDJBE.js";
+
+// src/utils/audit/src/audit/audit.ts
+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 axe = new AxeBuilder({ page });
+    const axeResults = await axe.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();
+  }
+}
+export {
+  runAudit
+};

package/bin/chunk-5Z7PR3VC.js

@@ -0,0 +1,182 @@
+// src/utils/test/contract/contract.json
+var contract_default = {
+  menu: {
+    path: "./contracts/MenuContract.json",
+    component: "menu"
+  },
+  combobox: {
+    path: "./contracts/ComboboxContract.json",
+    component: "combobox"
+  }
+};
+
+// 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 {
+  contract_default,
+  ContractReporter
+};

package/bin/chunk-JSBRDJBE.js

@@ -0,0 +1,30 @@
+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 __commonJS = (cb, mod) => function __require() {
+  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
+));
+
+export {
+  __commonJS,
+  __toESM
+};