aria-ease 6.4.10 → 6.5.1

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

@@ -35,29 +35,29 @@ var init_contract = __esm({
   "src/utils/test/contract/contract.json"() {
     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;
 var init_ContractReporter = __esm({
-  "src/utils/test/contract/ContractReporter.ts"() {
+  "src/utils/test/src/ContractReporter.ts"() {
     ContractReporter = class {
       startTime = 0;
       componentName = "";
@@ -69,6 +69,8 @@ var init_ContractReporter = __esm({
       optionalSuggestions = 0;
       isPlaywright = false;
       apgUrl = "https://www.w3.org/WAI/ARIA/apg/";
+      hasPrintedStaticSection = false;
+      hasPrintedDynamicSection = false;
       constructor(isPlaywright = false) {
         this.isPlaywright = isPlaywright;
       }
@@ -79,30 +81,32 @@ var init_ContractReporter = __esm({
         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) {
@@ -113,6 +117,13 @@ ${"\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,
@@ -199,7 +210,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')
 `);
       }
       /**
@@ -223,9 +234,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 Interactions \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) {
@@ -234,7 +250,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 Interactions \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`);
@@ -320,7 +336,7 @@ async function closeSharedBrowser() {
 }
 var sharedBrowser, sharedContext;
 var init_playwrightTestHarness = __esm({
-  "src/utils/test/contract/playwrightTestHarness.ts"() {
+  "src/utils/test/src/playwrightTestHarness.ts"() {
     sharedBrowser = null;
     sharedContext = null;
   }
@@ -558,7 +574,7 @@ var init_ComponentDetector = __esm({
         const contractData = fs.readFileSync(resolvedPath, "utf-8");
         const componentContract = JSON.parse(contractData);
         const selectors = componentContract.selectors;
-        if (componentName === "combobox") {
+        if (componentName.includes("combobox")) {
           const mainSelector = selectors.input || selectors.container;
           return new ComboboxComponentStrategy(mainSelector, selectors, actionTimeoutMs, assertionTimeoutMs);
         }
@@ -1074,7 +1090,7 @@ var init_AssertionRunner = __esm({
   }
 });
 
-// src/utils/test/contract/contractTestRunnerPlaywright.ts
+// src/utils/test/src/contractTestRunnerPlaywright.ts
 var contractTestRunnerPlaywright_exports = {};
 __export(contractTestRunnerPlaywright_exports, {
   runContractTestsPlaywright: () => runContractTestsPlaywright
@@ -1118,7 +1134,7 @@ async function runContractTestsPlaywright(componentName, url) {
       throw new Error(`CRITICAL: No selector found in contract for ${componentName}`);
     }
     try {
-      await page.locator(mainSelector).first().waitFor({ state: "attached", timeout: 28e3 });
+      await page.locator(mainSelector).first().waitFor({ state: "attached", timeout: 3e4 });
     } catch (error) {
       throw new Error(
         `
@@ -1133,24 +1149,29 @@ This usually means:
     reporter.start(componentName, totalTests, apgUrl);
     if (componentName === "menu" && componentContract.selectors.trigger) {
       await page.locator(componentContract.selectors.trigger).first().waitFor({
-        state: "visible",
+        state: "attached",
         timeout: 5e3
       }).catch(() => {
-        console.warn("Menu trigger not visible, continuing with tests...");
       });
     }
+    const failuresBeforeStatic = failures.length;
     const staticAssertionRunner = new AssertionRunner(page, componentContract.selectors, assertionTimeoutMs);
     for (const test of componentContract.static[0]?.assertions || []) {
       if (test.target === "relative") continue;
+      const staticDescription = `${test.target}${test.attribute ? ` (${test.attribute})` : ""}`;
       const targetSelector = componentContract.selectors[test.target];
       if (!targetSelector) {
-        failures.push(`Selector for target ${test.target} not found.`);
+        const failure = `Selector for target ${test.target} not found.`;
+        failures.push(failure);
+        reporter.reportStaticTest(staticDescription, false, failure);
         continue;
       }
       const target = page.locator(targetSelector).first();
       const exists = await target.count() > 0;
       if (!exists) {
-        failures.push(`Target ${test.target} not found.`);
+        const failure = `Target ${test.target} not found.`;
+        failures.push(failure);
+        reporter.reportStaticTest(staticDescription, false, failure);
         continue;
       }
       const isRedundantCheck = (selector, attrName, expectedVal) => {
@@ -1184,13 +1205,19 @@ This usually means:
           }
         }
         if (!hasAny && !allRedundant) {
-          failures.push(test.failureMessage + ` None of the attributes "${test.attribute}" are present.`);
+          const failure = test.failureMessage + ` None of the attributes "${test.attribute}" are present.`;
+          failures.push(failure);
+          reporter.reportStaticTest(staticDescription, false, failure);
         } else if (!allRedundant && hasAny) {
           passes.push(`At least one of the attributes "${test.attribute}" exists on the element.`);
+          reporter.reportStaticTest(staticDescription, true);
+        } else {
+          reporter.reportStaticTest(staticDescription, true);
         }
       } else {
         if (isRedundantCheck(targetSelector, test.attribute, test.expectedValue)) {
           passes.push(`${test.attribute}="${test.expectedValue}" on ${test.target} verified by selector (already present in: ${targetSelector}).`);
+          reporter.reportStaticTest(staticDescription, true);
         } else {
           const result = await staticAssertionRunner.validateAttribute(
             target,
@@ -1202,8 +1229,10 @@ This usually means:
           );
           if (result.success && result.passMessage) {
             passes.push(result.passMessage);
+            reporter.reportStaticTest(staticDescription, true);
           } else if (!result.success && result.failMessage) {
             failures.push(result.failMessage);
+            reporter.reportStaticTest(staticDescription, false, result.failMessage);
           }
         }
       }
@@ -1282,8 +1311,9 @@ This usually means:
         reporter.reportTest(dynamicTest, testPassed ? "pass" : "fail", failureMessage);
       }
     }
-    const staticPassed = componentContract.static[0].assertions.length;
-    const staticFailed = 0;
+    const staticTotal = componentContract.static[0].assertions.length;
+    const staticFailed = failures.length - failuresBeforeStatic;
+    const staticPassed = Math.max(0, staticTotal - staticFailed);
     reporter.reportStatic(staticPassed, staticFailed);
     reporter.summary(failures);
   } catch (error) {
@@ -1312,7 +1342,7 @@ Make sure your dev server is running at ${url}`);
   return { passes, failures, skipped };
 }
 var init_contractTestRunnerPlaywright = __esm({
-  "src/utils/test/contract/contractTestRunnerPlaywright.ts"() {
+  "src/utils/test/src/contractTestRunnerPlaywright.ts"() {
     init_contract();
     init_playwrightTestHarness();
     init_ComponentDetector();
@@ -1431,7 +1461,7 @@ var init_badgeHelper = __esm({
   }
 });
 
-// src/utils/test/contract/contractTestRunner.ts
+// src/utils/test/src/contractTestRunner.ts
 init_contract();
 init_ContractReporter();
 async function runContractTests(componentName, component) {
@@ -1449,6 +1479,7 @@ async function runContractTests(componentName, component) {
   const failures = [];
   const passes = [];
   const skipped = [];
+  const failuresBeforeStatic = failures.length;
   for (const test of componentContract.static[0].assertions) {
     if (test.target !== "relative") {
       const selector = componentContract.selectors[test.target];
@@ -1487,8 +1518,9 @@ async function runContractTests(componentName, component) {
     skipped.push(dynamicTest.description);
     reporter.reportTest(dynamicTest, "skip");
   }
-  const staticPassed = componentContract.static[0].assertions.length;
-  const staticFailed = 0;
+  const staticTotal = componentContract.static[0].assertions.length;
+  const staticFailed = failures.length - failuresBeforeStatic;
+  const staticPassed = Math.max(0, staticTotal - staticFailed);
   reporter.reportStatic(staticPassed, staticFailed);
   reporter.summary(failures);
   return { passes, failures, skipped };

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

@@ -1,4 +1,4 @@
-import { closeSharedBrowser, ContractReporter, contract_default } from './chunk-GFKAJHCS.js';
+import { closeSharedBrowser, ContractReporter, contract_default } from './chunk-AUJAN4RK.js';
 import { axe } from 'jest-axe';
 import fs from 'fs/promises';
 
@@ -17,6 +17,7 @@ async function runContractTests(componentName, component) {
   const failures = [];
   const passes = [];
   const skipped = [];
+  const failuresBeforeStatic = failures.length;
   for (const test of componentContract.static[0].assertions) {
     if (test.target !== "relative") {
       const selector = componentContract.selectors[test.target];
@@ -55,8 +56,9 @@ async function runContractTests(componentName, component) {
     skipped.push(dynamicTest.description);
     reporter.reportTest(dynamicTest, "skip");
   }
-  const staticPassed = componentContract.static[0].assertions.length;
-  const staticFailed = 0;
+  const staticTotal = componentContract.static[0].assertions.length;
+  const staticFailed = failures.length - failuresBeforeStatic;
+  const staticPassed = Math.max(0, staticTotal - staticFailed);
   reporter.reportStatic(staticPassed, staticFailed);
   reporter.summary(failures);
   return { passes, failures, skipped };
@@ -106,7 +108,7 @@ Error: ${error instanceof Error ? error.message : String(error)}`
       const devServerUrl = await checkDevServer(url);
       if (devServerUrl) {
         console.log(`\u{1F3AD} Running Playwright tests on ${devServerUrl}`);
-        const { runContractTestsPlaywright } = await import('./contractTestRunnerPlaywright-O7FF3X67.js');
+        const { runContractTestsPlaywright } = await import('./contractTestRunnerPlaywright-HL73FADJ.js');
         contract = await runContractTestsPlaywright(componentName, devServerUrl);
       } else {
         throw new Error(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aria-ease",
-  "version": "6.4.10",
+  "version": "6.5.1",
   "description": "Accessibility infrastructure for the entire frontend engineering lifecycle. Build accessible patterns, run automated audits, verify component interactions, and gate deployments — all in one system.",
   "main": "dist/index.cjs",
   "type": "module",
@@ -21,7 +21,7 @@
     "build:modules": "tsup ./src/combobox/index.ts ./src/accordion/index.ts ./src/block/index.ts ./src/checkbox/index.ts ./src/menu/index.ts ./src/tabs/index.ts ./src/radio/index.ts ./src/toggle/index.ts --format esm,cjs --dts --treeshake --outDir dist/src",
     "build:test": "tsup ./src/utils/test/index.ts --format esm,cjs --dts --treeshake --external jest-axe --external @testing-library/react --external playwright --external @playwright/test --outDir dist/src/utils/test",
     "build:cli": "tsup ./src/utils/cli/cli.ts --format esm,cjs --dts --outDir bin --external commander --external chalk --external jest-axe --external @testing-library/react --external @axe-core/playwright --external playwright",
-    "build:contracts": "mkdir -p ./dist/src/utils/test && cp -r ./src/utils/test/contract/contracts ./dist/src/utils/test/",
+    "build:contracts": "mkdir -p ./dist/src/utils/test && cp -r ./src/utils/test/contract/aria-contracts ./dist/src/utils/test/",
     "build": "npm run clean && npm run build:core && npm run build:modules && npm run build:test && npm run build:cli && npm run build:contracts"
   },
   "repository": {

package/dist/src/chunk-ZJXZZDUR.js

@@ -1,127 +0,0 @@
-// src/utils/handleKeyPress/handleKeyPress.ts
-function isTextInput(el) {
-  if (el.tagName !== "INPUT") return false;
-  const type = el.type;
-  return ["text", "email", "password", "tel", "number"].includes(type);
-}
-function isTextArea(el) {
-  return el.tagName === "TEXTAREA";
-}
-function isNativeButton(el) {
-  return el.tagName === "BUTTON" || el.tagName === "INPUT" && ["button", "submit", "reset"].includes(el.type);
-}
-function isLink(el) {
-  return el.tagName === "A";
-}
-function moveFocus(elementItems, currentIndex, direction) {
-  const len = elementItems.length;
-  const nextIndex = (currentIndex + direction + len) % len;
-  elementItems.item(nextIndex).focus();
-}
-function isClickableButNotSemantic(el) {
-  return el.getAttribute("data-custom-click") !== null && el.getAttribute("data-custom-click") !== void 0;
-}
-function handleMenuClose(menuElement, menuTriggerButton) {
-  menuElement.style.display = "none";
-  const menuTriggerButtonId = menuTriggerButton.getAttribute("id");
-  if (!menuTriggerButtonId) {
-    console.error("[aria-ease] Menu trigger button must have an id attribute to properly set aria attributes.");
-    return;
-  }
-  menuTriggerButton.setAttribute("aria-expanded", "false");
-}
-function hasSubmenu(menuItem) {
-  return menuItem.getAttribute("aria-haspopup") === "true" || menuItem.getAttribute("aria-haspopup") === "menu";
-}
-function getSubmenuId(menuItem) {
-  return menuItem.getAttribute("aria-controls");
-}
-function handleKeyPress(event, elementItems, elementItemIndex, menuElementDiv, triggerButton, openSubmenu, closeSubmenu, onOpenChange) {
-  const currentEl = elementItems.item(elementItemIndex);
-  switch (event.key) {
-    case "ArrowUp":
-    case "ArrowLeft": {
-      if (event.key === "ArrowLeft" && menuElementDiv && closeSubmenu) {
-        const labelledBy = menuElementDiv.getAttribute("aria-labelledby");
-        if (labelledBy) {
-          const parentTrigger = document.getElementById(labelledBy);
-          if (parentTrigger && parentTrigger.getAttribute("role") === "menuitem") {
-            event.preventDefault();
-            closeSubmenu();
-            parentTrigger.focus();
-            return;
-          }
-        }
-      }
-      if (!isTextInput(currentEl) && !isTextArea(currentEl)) {
-        event.preventDefault();
-        moveFocus(elementItems, elementItemIndex, -1);
-      } else if (isTextInput(currentEl) || isTextArea(currentEl)) {
-        const cursorStart = currentEl.selectionStart;
-        if (cursorStart === 0) {
-          event.preventDefault();
-          moveFocus(elementItems, elementItemIndex, -1);
-        }
-      }
-      break;
-    }
-    case "ArrowDown":
-    case "ArrowRight": {
-      if (event.key === "ArrowRight" && hasSubmenu(currentEl) && openSubmenu) {
-        event.preventDefault();
-        const submenuId = getSubmenuId(currentEl);
-        if (submenuId) {
-          openSubmenu(submenuId);
-          return;
-        }
-      }
-      if (!isTextInput(currentEl) && !isTextArea(currentEl)) {
-        event.preventDefault();
-        moveFocus(elementItems, elementItemIndex, 1);
-      } else if (isTextInput(currentEl) || isTextArea(currentEl)) {
-        const value = currentEl.value;
-        const cursorEnd = currentEl.selectionStart;
-        if (cursorEnd === value.length) {
-          event.preventDefault();
-          moveFocus(elementItems, elementItemIndex, 1);
-        }
-      }
-      break;
-    }
-    case "Escape": {
-      event.preventDefault();
-      if (menuElementDiv && triggerButton) {
-        if (getComputedStyle(menuElementDiv).display === "block") {
-          handleMenuClose(menuElementDiv, triggerButton);
-          if (onOpenChange) {
-            onOpenChange(false);
-          }
-        }
-        triggerButton.focus();
-      }
-      break;
-    }
-    case "Enter":
-    case " ": {
-      if (!isNativeButton(currentEl) && !isLink(currentEl) && isClickableButNotSemantic(currentEl)) {
-        event.preventDefault();
-        currentEl.click();
-      } else if (isNativeButton(currentEl)) {
-        event.preventDefault();
-        currentEl.click();
-      }
-      break;
-    }
-    case "Tab": {
-      if (menuElementDiv && triggerButton && (!event.shiftKey || event.shiftKey)) {
-        handleMenuClose(menuElementDiv, triggerButton);
-        if (onOpenChange) {
-          onOpenChange(false);
-        }
-      }
-      break;
-    }
-  }
-}
-
-export { handleKeyPress };