aria-ease 6.2.2 → 6.3.0

package/dist/src/utils/test/{contractTestRunnerPlaywright-7BPRTIN4.js → contractTestRunnerPlaywright-N77NEY25.js}

@@ -1,4 +1,4 @@
-import { ContractReporter, contract_default, createTestPage } from './chunk-7RMRFSJL.js';
+import { ContractReporter, contract_default, createTestPage } from './chunk-XLG3MIPQ.js';
 import { expect } from '@playwright/test';
 import { readFileSync } from 'fs';
 
@@ -39,9 +39,9 @@ async function runContractTestsPlaywright(componentName, url) {
       }
       await page.addStyleTag({ content: `* { transition: none !important; animation: none !important; }` });
     }
-    const mainSelector = componentContract.selectors.trigger || componentContract.selectors.input || componentContract.selectors.container;
+    const mainSelector = componentContract.selectors.trigger || componentContract.selectors.input || componentContract.selectors.container || componentContract.selectors.tablist || componentContract.selectors.tab;
     if (!mainSelector) {
-      throw new Error(`CRITICAL: No main selector (trigger, input, or container) found in contract for ${componentName}`);
+      throw new Error(`CRITICAL: No main selector (trigger, input, container, tablist, or tab) found in contract for ${componentName}`);
     }
     try {
       await page.locator(mainSelector).first().waitFor({ state: "attached", timeout: 3e4 });
@@ -103,28 +103,52 @@ async function runContractTestsPlaywright(componentName, url) {
         failures.push(`Target ${test.target} not found.`);
         continue;
       }
+      const isRedundantCheck = (selector, attrName, expectedVal) => {
+        const attrPattern = new RegExp(`\\[${attrName}(?:=["']?([^\\]"']+)["']?)?\\]`);
+        const match = selector.match(attrPattern);
+        if (!match) return false;
+        if (!expectedVal) return true;
+        const selectorValue = match[1];
+        if (selectorValue) {
+          const expectedValues = expectedVal.split(" | ");
+          return expectedValues.includes(selectorValue);
+        }
+        return false;
+      };
       if (!test.expectedValue) {
         const attributes = test.attribute.split(" | ");
         let hasAny = false;
+        let allRedundant = true;
         for (const attr of attributes) {
-          const value = await target.getAttribute(attr.trim());
+          const attrTrimmed = attr.trim();
+          if (isRedundantCheck(targetSelector, attrTrimmed)) {
+            passes.push(`${attrTrimmed} on ${test.target} verified by selector (already present in: ${targetSelector}).`);
+            hasAny = true;
+            continue;
+          }
+          allRedundant = false;
+          const value = await target.getAttribute(attrTrimmed);
           if (value !== null) {
             hasAny = true;
             break;
           }
         }
-        if (!hasAny) {
+        if (!hasAny && !allRedundant) {
           failures.push(test.failureMessage + ` None of the attributes "${test.attribute}" are present.`);
-        } else {
+        } else if (!allRedundant && hasAny) {
           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}`);
+        if (isRedundantCheck(targetSelector, test.attribute, test.expectedValue)) {
+          passes.push(`${test.attribute}="${test.expectedValue}" on ${test.target} verified by selector (already present in: ${targetSelector}).`);
         } else {
-          passes.push(`Attribute value matches expected value. Expected: ${test.expectedValue}, Found: ${attributeValue}`);
+          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}`);
+          }
         }
       }
     }
@@ -233,6 +257,19 @@ This indicates a problem with the menu component's close functionality.`
       if (shouldSkipTest) {
         continue;
       }
+      if (componentContract.selectors.panel && componentContract.selectors.tab && componentContract.selectors.tablist) {
+        if (dynamicTest.isVertical !== void 0 && componentContract.selectors.tablist) {
+          const tablistSelector = componentContract.selectors.tablist;
+          const tablist = page.locator(tablistSelector).first();
+          const orientation = await tablist.getAttribute("aria-orientation");
+          const isVertical = orientation === "vertical";
+          if (dynamicTest.isVertical !== isVertical) {
+            const skipReason = dynamicTest.isVertical ? `Skipping vertical tabs test - component has horizontal orientation` : `Skipping horizontal tabs test - component has vertical orientation`;
+            reporter.reportTest(dynamicTest, "skip", skipReason);
+            continue;
+          }
+        }
+      }
       for (const act of action) {
         if (!page || page.isClosed()) {
           failures.push(`CRITICAL: Browser/page closed during test execution. Remaining actions skipped.`);

package/dist/src/utils/test/contracts/AccordionContract.json

@@ -2,7 +2,8 @@
     "meta": {
         "id": "aria-ease.accordion",
         "version": "1.0.0",
-        "lastUpdated": "09-06-2026",
+        "created": "09-02-2026",
+        "lastUpdated": "28-02-2026",
         "description": "ARIA Accordion interaction contract. Validates the ARIA and interaction contract for a custom accordion component following the ARIA Authoring Practices Guide accordion with show/hide pattern.",
         "source": {
             "apg": "https://www.w3.org/WAI/ARIA/apg/patterns/accordion/",
@@ -101,7 +102,7 @@
             ]
         },
         {
-            "description": "Pressing Enter key on trigger expands a collapsed panel.",
+            "description": "Pressing Enter on trigger expands a collapsed panel.",
             "action": [
                 { "type": "keypress", "target": "trigger", "key": "Enter" }
             ],
@@ -116,12 +117,12 @@
                     "assertion": "toHaveAttribute",
                     "attribute": "aria-expanded",
                     "expectedValue": "true",
-                    "failureMessage": "Trigger's aria-expanded should be true after pressing Enter."
+                    "failureMessage": "Trigger's should have aria-expanded=true after pressing Enter."
                 }
             ]
         },
         {
-            "description": "Pressing Space key on trigger expands a collapsed panel.",
+            "description": "Pressing Space on trigger expands a collapsed panel.",
             "action": [
                 { "type": "keypress", "target": "trigger", "key": "Space" }
             ],
@@ -136,12 +137,12 @@
                     "assertion": "toHaveAttribute",
                     "attribute": "aria-expanded",
                     "expectedValue": "true",
-                    "failureMessage": "Trigger's aria-expanded should be true after pressing Space."
+                    "failureMessage": "Trigger's should have aria-expanded=true after pressing Space."
                 }
             ]
         },
         {
-            "description": "Pressing Enter key on trigger collapses an expanded panel.",
+            "description": "Pressing Enter on trigger collapses an expanded panel.",
             "action": [
                 { "type": "keypress", "target": "trigger", "key": "Enter" },
                 { "type": "keypress", "target": "trigger", "key": "Enter" }
@@ -162,7 +163,7 @@
             ]
         },
         {
-            "description": "Pressing Space key on trigger collapses an expanded panel.",
+            "description": "Pressing Space on trigger collapses an expanded panel.",
             "action": [
                 { "type": "keypress", "target": "trigger", "key": "Space" },
                 { "type": "keypress", "target": "trigger", "key": "Space" }
@@ -183,7 +184,7 @@
             ]
         },
         {
-            "description": "Arrow Down key moves focus to next accordion trigger.",
+            "description": "Down Arrow moves focus to next accordion trigger.",
             "isMultiple": true,
             "isOptional": true,
             "action": [
@@ -194,12 +195,12 @@
                     "target": "relative",
                     "assertion": "toHaveFocus",
                     "expectedValue": "second",
-                    "failureMessage": "Focus should move to the next accordion trigger after pressing ArrowDown."
+                    "failureMessage": "Focus should move to the next accordion trigger after pressing Down Arrow."
                 }
             ]
         },
         {
-            "description": "Arrow Up key moves focus to previous accordion trigger.",
+            "description": "Up Arrow moves focus to previous accordion trigger.",
             "isMultiple": true,
             "isOptional": true,
             "action": [
@@ -210,12 +211,12 @@
                     "target": "relative",
                     "assertion": "toHaveFocus",
                     "expectedValue": "first",
-                    "failureMessage": "Focus should move to the previous accordion trigger after pressing ArrowUp."
+                    "failureMessage": "Focus should move to the previous accordion trigger after pressing Up Arrow."
                 }
             ]
         },
         {
-            "description": "Home key moves focus to first accordion trigger.",
+            "description": "Home moves focus to first accordion trigger.",
             "isMultiple": true,
             "isOptional": true,
             "action": [
@@ -231,7 +232,7 @@
             ]
         },
         {
-            "description": "End key moves focus to last accordion trigger.",
+            "description": "End moves focus to last accordion trigger.",
             "isMultiple": true,
             "isOptional": true,
             "action": [
@@ -247,7 +248,7 @@
             ]
         },
         {
-            "description": "Arrow Down wraps focus from last trigger to first trigger.",
+            "description": "Down Arrow wraps focus from last trigger to first trigger.",
             "isMultiple": true,
             "isOptional": true,
             "action": [
@@ -258,12 +259,12 @@
                     "target": "relative",
                     "assertion": "toHaveFocus",
                     "expectedValue": "first",
-                    "failureMessage": "Focus should wrap from last to first accordion trigger after pressing ArrowDown."
+                    "failureMessage": "Focus should wrap from last to first accordion trigger after pressing Down Arrow."
                 }
             ]
         },
         {
-            "description": "Arrow Up wraps focus from first trigger to last trigger.",
+            "description": "Up Arrow wraps focus from first trigger to last trigger.",
             "isMultiple": true,
             "isOptional": true,
             "action": [
@@ -274,7 +275,7 @@
                     "target": "relative",
                     "assertion": "toHaveFocus",
                     "expectedValue": "last",
-                    "failureMessage": "Focus should wrap from first to last accordion trigger after pressing ArrowUp."
+                    "failureMessage": "Focus should wrap from first to last accordion trigger after pressing Up Arrow."
                 }
             ]
         }

package/dist/src/utils/test/contracts/ComboboxContract.json

@@ -2,7 +2,8 @@
     "meta": {
         "id": "aria-ease.combobox",
         "version": "1.0.0",
-        "lastUpdated": "11-06-2026",
+        "created": "11-02-2026",
+        "lastUpdated": "28-02-2026",
         "description": "ARIA Combobox interaction contract. Validates the ARIA and interaction contract for a custom combobox component following the ARIA Authoring Practices Guide combobox with listbox popup pattern.",
         "source": {
             "apg": "https://www.w3.org/WAI/ARIA/apg/patterns/combobox/",
@@ -91,37 +92,35 @@
 
     "dynamic": [
         {
-            "description": "Pressing ArrowDown on closed combobox opens the listbox without selecting first item.",
+            "description": "Pressing Down Arrow on closed combobox opens the listbox without selecting first item.",
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" }
             ],
             "assertions": [
                 {
                     "target": "listbox",
                     "assertion": "toBeVisible",
-                    "failureMessage": "Listbox should be visible after pressing ArrowDown on closed combobox."
+                    "failureMessage": "Listbox should be visible after pressing Down Arrow on closed combobox."
                 },
                 {
                     "target": "input",
                     "assertion": "toHaveAttribute",
                     "attribute": "aria-expanded",
                     "expectedValue": "true",
-                    "failureMessage": "Combobox input's aria-expanded should be true after pressing ArrowDown."
+                    "failureMessage": "Combobox input's should have aria-expanded=true after pressing Down Arrow."
                 },
                 {
                     "target": "input",
                     "assertion": "toHaveAttribute",
                     "attribute": "aria-activedescendant",
                     "expectedValue": "",
-                    "failureMessage": "First ArrowDown should open listbox without setting active descendant (no item selected yet)."
+                    "failureMessage": "First Down  Arrow should open listbox without setting active descendant (no item selected yet)."
                 }
             ]
         },
         {
-            "description": "Second ArrowDown press navigates to first listbox option.",
+            "description": "Second Down Arrow press navigates to first listbox option.",
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" }
             ],
@@ -131,7 +130,7 @@
                     "assertion": "toHaveAttribute",
                     "attribute": "aria-activedescendant",
                     "expectedValue": "!empty",
-                    "failureMessage": "Second ArrowDown should set first listbox option as active descendant."
+                    "failureMessage": "Second Down Arrow should set first listbox option as active descendant."
                 },
                 {
                     "target": "relative",
@@ -139,14 +138,13 @@
                     "attribute": "aria-selected",
                     "expectedValue": "true",
                     "relativeTarget": "first",
-                    "failureMessage": "First listbox option should have aria-selected=true after second ArrowDown."
+                    "failureMessage": "First listbox option should have aria-selected=true after second Down Arrow."
                 }
             ]
         },
         {
-            "description": "ArrowDown navigates to next listbox option with wrapping.",
+            "description": "Down Arrow navigates to next listbox option with wrapping.",
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" }
@@ -158,14 +156,13 @@
                     "attribute": "aria-selected",
                     "expectedValue": "true",
                     "relativeTarget": "second",
-                    "failureMessage": "Second listbox option should be selected after third ArrowDown."
+                    "failureMessage": "Second listbox option should be selected after third Down Arrow."
                 }
             ]
         },
         {
-            "description": "ArrowUp does not open closed listbox.",
+            "description": "Up Arrow does not open closed listbox.",
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "keypress", "target": "input", "key": "ArrowUp" }
             ],
             "assertions": [
@@ -174,14 +171,13 @@
                     "assertion": "toHaveAttribute",
                     "attribute": "aria-expanded",
                     "expectedValue": "false",
-                    "failureMessage": "ArrowUp should not open a closed listbox."
+                    "failureMessage": "Up Arrow should not open a closed listbox. Combobox input should have aria-expanded=false."
                 }
             ]
         },
         {
             "description": "ArrowUp navigates to previous option when listbox is open.",
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
@@ -199,10 +195,9 @@
             ]
         },
         {
-            "description": "Home key navigates to first listbox option.",
+            "description": "Home navigates to first listbox option.",
             "isOptional": true,
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "keypress", "target": "input", "key": "End" },
                 { "type": "keypress", "target": "input", "key": "Home" }
@@ -214,15 +209,14 @@
                     "attribute": "aria-selected",
                     "expectedValue": "true",
                     "relativeTarget": "first",
-                    "failureMessage": "Home key should navigate to first listbox option."
+                    "failureMessage": "Home should navigate to first listbox option."
                 }
             ]
         },
         {
-            "description": "End key navigates to last listbox option.",
+            "description": "End navigates to last listbox option.",
             "isOptional": true,
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "keypress", "target": "input", "key": "End" }
             ],
@@ -233,14 +227,13 @@
                     "attribute": "aria-selected",
                     "expectedValue": "true",
                     "relativeTarget": "last",
-                    "failureMessage": "End key should navigate to last listbox option."
+                    "failureMessage": "End should navigate to last listbox option."
                 }
             ]
         },
         {
-            "description": "Enter key selects active option and closes listbox.",
+            "description": "Enter selects active option and closes listbox.",
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "keypress", "target": "input", "key": "Enter" }
@@ -256,7 +249,7 @@
                     "assertion": "toHaveAttribute",
                     "attribute": "aria-expanded",
                     "expectedValue": "false",
-                    "failureMessage": "Combobox input's aria-expanded should be false after selection."
+                    "failureMessage": "Combobox input's should have aria-expanded=false after selection."
                 },
                 {
                     "target": "input",
@@ -267,9 +260,8 @@
             ]
         },
         {
-            "description": "Escape key closes open listbox.",
+            "description": "Escape closes open listbox.",
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "keypress", "target": "input", "key": "Escape" }
             ],
@@ -284,14 +276,13 @@
                     "assertion": "toHaveAttribute",
                     "attribute": "aria-expanded",
                     "expectedValue": "false",
-                    "failureMessage": "Combobox input's aria-expanded should be false after Escape."
+                    "failureMessage": "Combobox input's should have aria-expanded=false after Escape."
                 }
             ]
         },
         {
-            "description": "Escape key clears input value when listbox is closed.",
+            "description": "Escape clears input value when listbox is closed.",
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "type", "target": "input", "value": "test" },
                 { "type": "keypress", "target": "input", "key": "Escape" }
             ],
@@ -305,9 +296,8 @@
             ]
         },
         {
-            "description": "Tab key closes the listbox.",
+            "description": "Tab closes the listbox.",
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "keypress", "target": "input", "key": "Tab" }
             ],
@@ -317,14 +307,13 @@
                     "assertion": "toHaveAttribute",
                     "attribute": "aria-expanded",
                     "expectedValue": "false",
-                    "failureMessage": "Tab key should close the listbox."
+                    "failureMessage": "Tab should close the listbox, and should have aria-expanded=false."
                 }
             ]
         },
         {
             "description": "Clicking option selects it and closes listbox.",
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "click", "target": "relative", "relativeTarget": "first" }
             ],
@@ -339,7 +328,7 @@
                     "assertion": "toHaveAttribute",
                     "attribute": "aria-expanded",
                     "expectedValue": "false",
-                    "failureMessage": "Combobox input's aria-expanded should be false after clicking option."
+                    "failureMessage": "Combobox input's should have aria-expanded=false after clicking option."
                 },
                 {
                     "target": "input",
@@ -351,9 +340,7 @@
         },
         {
             "description": "Mouse hover sets aria-selected on hovered listbox option.",
-            "requiresBrowser": true,
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "hover", "target": "relative", "relativeTarget": "second" }
             ],
@@ -371,7 +358,6 @@
         {
             "description": "Clicking outside closes the listbox.",
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "click", "target": "document" }
             ],
@@ -386,7 +372,7 @@
                     "assertion": "toHaveAttribute",
                     "attribute": "aria-expanded",
                     "expectedValue": "false",
-                    "failureMessage": "Combobox input's aria-expanded should be false after clicking outside."
+                    "failureMessage": "Combobox input's should have aria-expanded=false after clicking outside."
                 }
             ]
         },
@@ -406,7 +392,7 @@
                     "assertion": "toHaveAttribute",
                     "attribute": "aria-expanded",
                     "expectedValue": "true",
-                    "failureMessage": "Combobox input's aria-expanded should be true after clicking button."
+                    "failureMessage": "Combobox input's should have aria-expanded=true after clicking button."
                 },
                 {
                     "target": "input",
@@ -432,14 +418,13 @@
                     "assertion": "toHaveAttribute",
                     "attribute": "aria-expanded",
                     "expectedValue": "false",
-                    "failureMessage": "Combobox input's aria-expanded should be false after toggling closed."
+                    "failureMessage": "Combobox input's should have aria-expanded=false after toggling closed."
                 }
             ]
         },
         {
-            "description": "Navigation wraps from last to first listbox option on ArrowDown.",
+            "description": "Navigation wraps from last to first listbox option on Down Arrow.",
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "keypress", "target": "input", "key": "End" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" }
@@ -451,14 +436,13 @@
                     "attribute": "aria-selected",
                     "expectedValue": "true",
                     "relativeTarget": "first",
-                    "failureMessage": "Navigation should wrap from last to first listbox option on ArrowDown."
+                    "failureMessage": "Navigation should wrap from last to first listbox option on Down Arrow."
                 }
             ]
         },
         {
-            "description": "Navigation wraps from first to last listbox option on ArrowUp.",
+            "description": "Navigation wraps from first to last listbox option on Up Arrow.",
             "action": [
-                { "type": "focus", "target": "input" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "keypress", "target": "input", "key": "ArrowDown" },
                 { "type": "keypress", "target": "input", "key": "ArrowUp" }
@@ -470,7 +454,7 @@
                     "attribute": "aria-selected",
                     "expectedValue": "true",
                     "relativeTarget": "last",
-                    "failureMessage": "Navigation should wrap from first to last listbox option on ArrowUp."
+                    "failureMessage": "Navigation should wrap from first to last listbox option on Up Arrow."
                 }
             ]
         }