aria-ease 6.4.8 → 6.5.0

package/README.md

@@ -1,8 +1,8 @@
 # Aria-Ease
 
-**Accessibility infrastructure for the entire frontend engineering lifecycle.**
+### Accessibility infrastructure for the entire frontend engineering lifecycle.
 
-Stop treating accessibility as an afterthought. Aria-Ease engineers technical integrity into every phase of frontend development — from local development to production monitoring — so accessibility violations never reach your users.
+Stop treating accessibility as an afterthought. Aria-Ease engineers accessibility integrity into every phase of frontend development lifecycle — from local development to production monitoring — so accessibility violations never reach your users.
 
 [![npm version](https://img.shields.io/npm/v/aria-ease.svg)](https://www.npmjs.com/package/aria-ease)
 [![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
@@ -64,13 +64,14 @@ npx aria-ease audit --url https://yoursite.com
 
 #### 3. **Contract Testing** (Available Now)
 
-This is the game-changer. We encoded the WAI-ARIA APG into deterministic JSON "contracts" and built a custom Playwright runner with isolated test-harness architecture.
+This is the game-changer. We encoded the WAI-ARIA APG into deterministic JSON "contracts" and built a custom Playwright runner with isolated test-harness architecture. Run it locally or in CI/CD.
 
 **The result?** Component interaction testing that feels closer to unit testing than manual QA.
 
 ```bash
-npx aria-ease test --component combobox --url http://localhost:3000
+npx aria-ease test
 # ✓ 26 assertions in ~4 seconds
+# ✓ 26 assertions in ~1 second in CI
 ```
 
 **Why this matters:** Before, verifying a combobox meant manual keyboard testing across browsers. Now, it's automated, fast, and repeatable. You can boast about executing 26 combobox interaction assertions in ~4 seconds.
@@ -650,7 +651,7 @@ describe("Shopify User Menu Accessibility Test", () => {
       null,
       "http://localhost:5173/test-harness?component=menu",
     ); // For full component interaction test. Uses Playwright to test interaction and behaviors
-  }, 6000);
+  });
 });
 
 describe("Shopify User Menu Accessibility Test", () => {
@@ -764,7 +765,7 @@ Until now, accessibility testing often happened manually, late in the cycle, or
 **Aria-Ease changes the equation:**
 
 - ✅ Automated = no human bottleneck
-- ✅ Fast = ~4 seconds for comprehensive component testing
+- ✅ Fast = ~6 seconds for 90 accessibility interaction assertions
 - ✅ Deterministic = same results every time
 - ✅ Blocking = deploy fails if tests fail
 
@@ -875,21 +876,12 @@ Create `ariaease.config.js` in your project root:
 ```javascript
 export default {
   audit: {
-    urls: [
-      "http://localhost:5173", // Homepage
-      "http://localhost:5173/docs", // Docs
-      "http://localhost:5173/examples", // Examples
-    ],
+    urls: ["http://localhost:5173/", "http://localhost:5173/changelog"],
     output: {
-      format: "all", // Generate JSON, CSV, and HTML reports
-      out: "./accessibility-reports",
+      format: "html",
+      out: "./accessibility-reports/audit",
     },
   },
-  test: {
-    components: ["menu", "accordion", "tabs", "combobox"], // Components to test
-    baseUrl: "http://localhost:5173/test-harness",
-    browser: "chromium",
-  },
 };
 ```
 
@@ -898,8 +890,8 @@ Add to `package.json`:
 ```json
 {
   "scripts": {
-    "audit": "aria-ease audit",
-    "test:a11y": "aria-ease test",
+    "audit": "npx aria-ease audit -f html",
+    "test:a11y": "npx aria-ease test",
     "ci": "npm run audit && npm run test:a11y"
   }
 }
@@ -980,14 +972,10 @@ One of the biggest blockers to adding accessibility testing to CI/CD is **speed*
 **Aria-Ease contract testing is fast:**
 
 ```bash
-npx aria-ease test --component combobox
-# ✓ 26 interaction assertions in ~4 seconds
-
-npx aria-ease test --component menu
-# ✓ 15 interaction assertions in ~2.8 seconds
+npx aria-ease test
+# ✓ 26 combobox interaction assertions in ~1 seconds in CI
+# ✓ 90 accessibility interaction assertions in ~6 seconds in CI
 
-npx aria-ease test  # All components
-# ✓ 80+ assertions in ~12 seconds
 ```
 
 **Why so fast?**

package/bin/{chunk-TQBS54MM.js → chunk-AUJAN4RK.js}

@@ -1,24 +1,24 @@
 // src/utils/test/contract/contract.json
 var contract_default = {
   menu: {
-    path: "./contracts/MenuContract.json",
+    path: "./aria-contracts/menu/menu.contract.json",
     component: "menu"
   },
-  combobox: {
-    path: "./contracts/ComboboxContract.json",
-    component: "combobox"
+  "combobox.listbox": {
+    path: "./aria-contracts/combobox/combobox.listbox.contract.json",
+    component: "combobox.listbox"
   },
   accordion: {
-    path: "./contracts/AccordionContract.json",
+    path: "./aria-contracts/accordion/accordion.contract.json",
     component: "accordion"
   },
   tabs: {
-    path: "./contracts/TabsContract.json",
+    path: "./aria-contracts/tabs/tabs.contract.json",
     component: "tabs"
   }
 };
 
-// src/utils/test/contract/ContractReporter.ts
+// src/utils/test/src/ContractReporter.ts
 var ContractReporter = class {
   startTime = 0;
   componentName = "";
@@ -30,6 +30,8 @@ var ContractReporter = class {
   optionalSuggestions = 0;
   isPlaywright = false;
   apgUrl = "https://www.w3.org/WAI/ARIA/apg/";
+  hasPrintedStaticSection = false;
+  hasPrintedDynamicSection = false;
   constructor(isPlaywright = false) {
     this.isPlaywright = isPlaywright;
   }
@@ -40,30 +42,32 @@ var ContractReporter = class {
     this.startTime = Date.now();
     this.componentName = componentName;
     this.totalTests = totalTests;
+    this.hasPrintedStaticSection = false;
+    this.hasPrintedDynamicSection = false;
     if (apgUrl) {
       this.apgUrl = apgUrl;
     }
     const mode = this.isPlaywright ? "Playwright (Real Browser)" : "jsdom (Fast)";
     this.log(`
 ${"\u2550".repeat(60)}`);
-    this.log(`\u{1F50D} Testing ${componentName} Component - ${mode}`);
+    this.log(`\u{1F50D} Testing ${componentName.charAt(0).toUpperCase() + componentName.slice(1)} 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("");
-    this.log(`${icon} Static ARIA Tests: ${status}`);
-    this.log(`   ${passes}/${passes + failures} required attributes present
-`);
   }
   /**
    * Report individual static test pass
    */
   reportStaticTest(description, passed, failureMessage) {
+    if (!this.hasPrintedStaticSection) {
+      this.log(`${"\u2500".repeat(60)}`);
+      this.log(`\u{1F9EA} Static Assertions`);
+      this.log(`${"\u2500".repeat(60)}`);
+      this.hasPrintedStaticSection = true;
+    }
     const icon = passed ? "\u2713" : "\u2717";
     this.log(`  ${icon} ${description}`);
     if (!passed && failureMessage) {
@@ -74,13 +78,20 @@ ${"\u2550".repeat(60)}`);
    * Report individual dynamic test result
    */
   reportTest(test, status, failureMessage) {
+    if (!this.hasPrintedDynamicSection) {
+      this.log("");
+      this.log(`${"\u2500".repeat(60)}`);
+      this.log(`\u2328\uFE0F Dynamic Interaction Tests`);
+      this.log(`${"\u2500".repeat(60)}`);
+      this.hasPrintedDynamicSection = true;
+    }
     const result = {
       description: test.description,
       status,
       failureMessage,
       isOptional: test.isOptional
     };
-    if (status === "skip" && test.requiresBrowser) {
+    if (status === "skip") {
       result.skipReason = "Requires real browser (addEventListener events)";
     }
     this.dynamicResults.push(result);
@@ -160,7 +171,7 @@ ${"\u2500".repeat(60)}`);
     });
     this.log(`
 \u{1F4A1} Run with Playwright for full validation:`);
-    this.log(`   testUiComponent('${this.componentName}', component, 'http://localhost:5173/')
+    this.log(`   testUiComponent('${this.componentName}', null, 'http://localhost:5173/test-harness?component=component_name')
 `);
   }
   /**
@@ -184,9 +195,14 @@ ${"\u2500".repeat(60)}`);
 ${"\u2550".repeat(60)}`);
     this.log(`\u{1F4CA} Summary
 `);
+    const staticIcon = this.staticFailures === 0 ? "\u2705" : "\u274C";
+    const staticStatus = this.staticFailures === 0 ? "PASS" : "FAIL";
+    this.log(`${staticIcon} Static ARIA Tests: ${staticStatus}`);
+    this.log(`   ${this.staticPasses}/${this.staticPasses + this.staticFailures} required attributes present`);
+    this.log("");
     if (totalFailures === 0 && this.skipped === 0 && this.optionalSuggestions === 0) {
       this.log(`\u2705 All ${totalRun} tests passed!`);
-      this.log(`   ${this.componentName} component meets WAI-ARIA expectations for Roles, States, Properties, and Keyboard Interaction \u2713`);
+      this.log(`   ${this.componentName.charAt(0).toUpperCase()}${this.componentName.slice(1)} component meets WAI-ARIA expectations for Roles, States, Properties, and Keyboard Interactions \u2713`);
     } else if (totalFailures === 0) {
       this.log(`\u2705 ${totalPasses}/${totalRun} required tests passed`);
       if (this.skipped > 0) {
@@ -195,7 +211,7 @@ ${"\u2550".repeat(60)}`);
       if (this.optionalSuggestions > 0) {
         this.log(`\u{1F4A1} ${this.optionalSuggestions} optional enhancement${this.optionalSuggestions > 1 ? "s" : ""} suggested`);
       }
-      this.log(`   ${this.componentName} component meets WAI-ARIA expectations for Roles, States, Properties, and Keyboard Interaction \u2713`);
+      this.log(`   ${this.componentName.charAt(0).toUpperCase()}${this.componentName.slice(1)} component meets WAI-ARIA expectations for Roles, States, Properties, and Keyboard Interactions \u2713`);
     } else {
       this.log(`\u274C ${totalFailures} test${totalFailures > 1 ? "s" : ""} failed`);
       this.log(`\u2705 ${totalPasses} test${totalPasses > 1 ? "s" : ""} passed`);
@@ -239,7 +255,7 @@ ${"\u2550".repeat(60)}`);
   }
 };
 
-// src/utils/test/contract/playwrightTestHarness.ts
+// src/utils/test/src/playwrightTestHarness.ts
 import { chromium } from "playwright";
 var sharedBrowser = null;
 var sharedContext = null;