aria-ease 6.4.8 → 6.5.0

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   ContractReporter,
   closeSharedBrowser,
   contract_default
-} from "./chunk-TQBS54MM.js";
+} from "./chunk-AUJAN4RK.js";
 import "./chunk-I2KLQ2HA.js";
 
 // src/accordion/src/makeAccordionAccessible/makeAccordionAccessible.ts
@@ -539,6 +539,13 @@ function makeMenuAccessible({ menuId, menuItemsClass, triggerId, callback }) {
     };
     return nodeListLike;
   }
+  function intializeMenuItems() {
+    const items = getItems();
+    items.forEach((item) => {
+      item.setAttribute("role", "menuitem");
+    });
+  }
+  intializeMenuItems();
   function isItemInNestedSubmenu(item) {
     let parent = item.parentElement;
     while (parent && parent !== menuDiv) {
@@ -651,13 +658,6 @@ function makeMenuAccessible({ menuId, menuItemsClass, triggerId, callback }) {
       }
     }
   }
-  function intializeMenuItems() {
-    const items = getItems();
-    items.forEach((item) => {
-      item.setAttribute("role", "menuitem");
-    });
-  }
-  intializeMenuItems();
   function handleTriggerClick() {
     const isOpen = triggerButton.getAttribute("aria-expanded") === "true";
     if (isOpen) {
@@ -1433,7 +1433,7 @@ function makeTabsAccessible({ tabListId, tabsClass, tabPanelsClass, orientation
 // src/utils/test/src/test.ts
 import { axe } from "jest-axe";
 
-// src/utils/test/contract/contractTestRunner.ts
+// src/utils/test/src/contractTestRunner.ts
 import fs from "fs/promises";
 async function runContractTests(componentName, component) {
   const reporter = new ContractReporter(false);
@@ -1450,6 +1450,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];
@@ -1488,8 +1489,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 };
@@ -1539,7 +1541,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-D57V4RSU.js");
+        const { runContractTestsPlaywright } = await import("./contractTestRunnerPlaywright-7F756CFB.js");
         contract = await runContractTestsPlaywright(componentName, devServerUrl);
       } else {
         throw new Error(
@@ -1594,6 +1596,11 @@ ${violationDetails}
   return result;
 }
 var runTest = async () => {
+  return {
+    passes: [],
+    failures: [],
+    skipped: []
+  };
 };
 if (typeof window === "undefined") {
   runTest = async () => {
@@ -1601,36 +1608,36 @@ if (typeof window === "undefined") {
 `);
     const { exec } = await import("child_process");
     const chalk = (await import("chalk")).default;
-    exec(
-      `npx vitest --run --reporter verbose`,
-      { cwd: process.cwd() },
-      async (error, stdout, stderr) => {
-        if (stdout) {
+    return new Promise((resolve, reject) => {
+      exec(
+        `npx vitest --run --reporter verbose`,
+        async (error, stdout, stderr) => {
           console.log(stdout);
-        }
-        if (stderr) {
-          console.error(stderr);
-        }
-        if (!error || error.code === 0) {
-          try {
-            const { displayBadgeInfo, promptAddBadge } = await import("./badgeHelper-RDOMCC6E.js");
-            displayBadgeInfo("component");
-            await promptAddBadge("component", process.cwd());
-            console.log(chalk.dim("\n" + "\u2500".repeat(60)));
-            console.log(chalk.cyan("\u{1F499} Found aria-ease helpful?"));
-            console.log(chalk.white("   \u2022 Star us on GitHub: ") + chalk.blue.underline("https://github.com/aria-ease/aria-ease"));
-            console.log(chalk.white("   \u2022 Share feedback: ") + chalk.blue.underline("https://github.com/aria-ease/aria-ease/discussions"));
-            console.log(chalk.dim("\u2500".repeat(60) + "\n"));
-          } catch (badgeError) {
-            console.error("Warning: Could not display badge prompt:", badgeError);
+          if (stderr) console.error(stderr);
+          const testsPassed = !error || error.code === 0;
+          if (testsPassed) {
+            try {
+              const { displayBadgeInfo, promptAddBadge } = await import("./badgeHelper-RDOMCC6E.js");
+              displayBadgeInfo("component");
+              await promptAddBadge("component", process.cwd());
+              console.log(chalk.dim("\n" + "\u2500".repeat(60)));
+              console.log(chalk.cyan("\u{1F499} Found aria-ease helpful?"));
+              console.log(chalk.white("   \u2022 Star us on GitHub: ") + chalk.blue.underline("https://github.com/aria-ease/aria-ease"));
+              console.log(chalk.white("   \u2022 Share feedback: ") + chalk.blue.underline("https://github.com/aria-ease/aria-ease/discussions"));
+              console.log(chalk.dim("\u2500".repeat(60) + "\n"));
+            } catch (badgeError) {
+              console.error("Warning: Could not display badge prompt:", badgeError);
+            }
+            resolve({ passes: [], failures: [], skipped: [] });
+            process.exit(0);
+          } else {
+            const exitCode = error?.code || 1;
+            reject(new Error(`Tests failed with code ${exitCode}`));
+            process.exit(exitCode);
           }
-          process.exit(0);
-        } else {
-          const exitCode = error?.code || 1;
-          process.exit(exitCode);
         }
-      }
-    );
+      );
+    });
   };
 }
 async function cleanupTests() {

package/dist/src/{Types.d-DYfYR3Vc.d.cts → Types.d-yGC2bBaB.d.cts}

@@ -88,4 +88,4 @@ interface MenuCallback {
     onOpenChange?: (isOpen: boolean) => void;
 }
 
-export type { AccordionConfig as A, ComboboxConfig as C, MenuConfig as M, TabsConfig as T, AccessibilityInstance as a };
+export type { AccessibilityInstance as A, ComboboxConfig as C, MenuConfig as M, TabsConfig as T, AccordionConfig as a };

package/dist/src/{Types.d-DYfYR3Vc.d.ts → Types.d-yGC2bBaB.d.ts}

@@ -88,4 +88,4 @@ interface MenuCallback {
     onOpenChange?: (isOpen: boolean) => void;
 }
 
-export type { AccordionConfig as A, ComboboxConfig as C, MenuConfig as M, TabsConfig as T, AccessibilityInstance as a };
+export type { AccessibilityInstance as A, ComboboxConfig as C, MenuConfig as M, TabsConfig as T, AccordionConfig as a };

package/dist/src/accordion/index.d.cts

@@ -1,4 +1,4 @@
-import { A as AccordionConfig, a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.cjs';
+import { a as AccordionConfig, A as AccessibilityInstance } from '../Types.d-yGC2bBaB.cjs';
 
 /**
  * Makes an accordion accessible by managing ARIA attributes, keyboard interaction, and state.

package/dist/src/accordion/index.d.ts

@@ -1,4 +1,4 @@
-import { A as AccordionConfig, a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.js';
+import { a as AccordionConfig, A as AccessibilityInstance } from '../Types.d-yGC2bBaB.js';
 
 /**
  * Makes an accordion accessible by managing ARIA attributes, keyboard interaction, and state.

package/dist/src/block/index.d.cts

@@ -1,4 +1,4 @@
-import { a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.cjs';
+import { A as AccessibilityInstance } from '../Types.d-yGC2bBaB.cjs';
 
 /**
  * Adds keyboard interaction to block. The block traps focus and can be interacted with using the keyboard.

package/dist/src/block/index.d.ts

@@ -1,4 +1,4 @@
-import { a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.js';
+import { A as AccessibilityInstance } from '../Types.d-yGC2bBaB.js';
 
 /**
  * Adds keyboard interaction to block. The block traps focus and can be interacted with using the keyboard.

package/dist/src/checkbox/index.d.cts

@@ -1,4 +1,4 @@
-import { a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.cjs';
+import { A as AccessibilityInstance } from '../Types.d-yGC2bBaB.cjs';
 
 /**
  * Makes a checkbox group accessible by managing ARIA attributes and keyboard interaction.

package/dist/src/checkbox/index.d.ts

@@ -1,4 +1,4 @@
-import { a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.js';
+import { A as AccessibilityInstance } from '../Types.d-yGC2bBaB.js';
 
 /**
  * Makes a checkbox group accessible by managing ARIA attributes and keyboard interaction.

package/dist/src/combobox/index.d.cts

@@ -1,4 +1,4 @@
-import { C as ComboboxConfig, a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.cjs';
+import { C as ComboboxConfig, A as AccessibilityInstance } from '../Types.d-yGC2bBaB.cjs';
 
 /**
  * Makes a Combobox accessible by adding appropriate ARIA attributes, keyboard interactions and focus management.

package/dist/src/combobox/index.d.ts

@@ -1,4 +1,4 @@
-import { C as ComboboxConfig, a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.js';
+import { C as ComboboxConfig, A as AccessibilityInstance } from '../Types.d-yGC2bBaB.js';
 
 /**
  * Makes a Combobox accessible by adding appropriate ARIA attributes, keyboard interactions and focus management.

package/dist/src/menu/index.cjs

@@ -198,6 +198,13 @@ function makeMenuAccessible({ menuId, menuItemsClass, triggerId, callback }) {
     };
     return nodeListLike;
   }
+  function intializeMenuItems() {
+    const items = getItems();
+    items.forEach((item) => {
+      item.setAttribute("role", "menuitem");
+    });
+  }
+  intializeMenuItems();
   function isItemInNestedSubmenu(item) {
     let parent = item.parentElement;
     while (parent && parent !== menuDiv) {
@@ -310,13 +317,6 @@ function makeMenuAccessible({ menuId, menuItemsClass, triggerId, callback }) {
       }
     }
   }
-  function intializeMenuItems() {
-    const items = getItems();
-    items.forEach((item) => {
-      item.setAttribute("role", "menuitem");
-    });
-  }
-  intializeMenuItems();
   function handleTriggerClick() {
     const isOpen = triggerButton.getAttribute("aria-expanded") === "true";
     if (isOpen) {

package/dist/src/menu/index.d.cts

@@ -1,4 +1,4 @@
-import { M as MenuConfig, a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.cjs';
+import { M as MenuConfig, A as AccessibilityInstance } from '../Types.d-yGC2bBaB.cjs';
 
 /**
   * Adds keyboard interaction to toggle menu. The menu traps focus and can be interacted with using the keyboard. The first interactive item of the menu has focus when menu open.

package/dist/src/menu/index.d.ts

@@ -1,4 +1,4 @@
-import { M as MenuConfig, a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.js';
+import { M as MenuConfig, A as AccessibilityInstance } from '../Types.d-yGC2bBaB.js';
 
 /**
   * Adds keyboard interaction to toggle menu. The menu traps focus and can be interacted with using the keyboard. The first interactive item of the menu has focus when menu open.

package/dist/src/menu/index.js

@@ -72,6 +72,13 @@ function makeMenuAccessible({ menuId, menuItemsClass, triggerId, callback }) {
     };
     return nodeListLike;
   }
+  function intializeMenuItems() {
+    const items = getItems();
+    items.forEach((item) => {
+      item.setAttribute("role", "menuitem");
+    });
+  }
+  intializeMenuItems();
   function isItemInNestedSubmenu(item) {
     let parent = item.parentElement;
     while (parent && parent !== menuDiv) {
@@ -184,13 +191,6 @@ function makeMenuAccessible({ menuId, menuItemsClass, triggerId, callback }) {
       }
     }
   }
-  function intializeMenuItems() {
-    const items = getItems();
-    items.forEach((item) => {
-      item.setAttribute("role", "menuitem");
-    });
-  }
-  intializeMenuItems();
   function handleTriggerClick() {
     const isOpen = triggerButton.getAttribute("aria-expanded") === "true";
     if (isOpen) {

package/dist/src/radio/index.d.cts

@@ -1,4 +1,4 @@
-import { a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.cjs';
+import { A as AccessibilityInstance } from '../Types.d-yGC2bBaB.cjs';
 
 /**
  * Makes a radio group accessible by managing ARIA attributes, keyboard interaction, and state.

package/dist/src/radio/index.d.ts

@@ -1,4 +1,4 @@
-import { a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.js';
+import { A as AccessibilityInstance } from '../Types.d-yGC2bBaB.js';
 
 /**
  * Makes a radio group accessible by managing ARIA attributes, keyboard interaction, and state.

package/dist/src/tabs/index.d.cts

@@ -1,4 +1,4 @@
-import { T as TabsConfig, a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.cjs';
+import { T as TabsConfig, A as AccessibilityInstance } from '../Types.d-yGC2bBaB.cjs';
 
 /**
  * Makes tabs accessible by managing ARIA attributes, keyboard interaction, and state.

package/dist/src/tabs/index.d.ts

@@ -1,4 +1,4 @@
-import { T as TabsConfig, a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.js';
+import { T as TabsConfig, A as AccessibilityInstance } from '../Types.d-yGC2bBaB.js';
 
 /**
  * Makes tabs accessible by managing ARIA attributes, keyboard interaction, and state.

package/dist/src/toggle/index.d.cts

@@ -1,4 +1,4 @@
-import { a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.cjs';
+import { A as AccessibilityInstance } from '../Types.d-yGC2bBaB.cjs';
 
 /**
  * Makes a toggle button accessible by managing ARIA attributes and keyboard interactions.

package/dist/src/toggle/index.d.ts

@@ -1,4 +1,4 @@
-import { a as AccessibilityInstance } from '../Types.d-DYfYR3Vc.js';
+import { A as AccessibilityInstance } from '../Types.d-yGC2bBaB.js';
 
 /**
  * Makes a toggle button accessible by managing ARIA attributes and keyboard interactions.

package/dist/src/utils/test/{contracts/AccordionContract.json → aria-contracts/accordion/accordion.contract.json}

@@ -26,6 +26,26 @@
         "relative": "first | last | next | previous"
     },
 
+    "relationships": [
+        {
+            "type": "aria-reference",
+            "from": "trigger",
+            "attribute": "aria-controls",
+            "to": "panel"
+        },
+        {
+            "type": "aria-reference",
+            "from": "panel",
+            "attribute": "aria-labelledby",
+            "to": "trigger"
+        },
+        {
+            "type": "contains",
+            "parent": "container",
+            "child": "trigger"
+        }
+    ],
+
     "static": [
         {
             "assertions": [
@@ -42,13 +62,6 @@
                     "attribute": "aria-controls",
                     "failureMessage": "Accordion trigger button doesn't conform to the ARIA Accordion Button pattern as specified in APG 1.2. Accordion trigger button should have 'aria-controls' attribute that points to the id of the accordion panel div it controls with 'role=region'. This helps assistive technology to identify the accordion panel div that the button controls."
                 },
-                {
-                    "target": "panel",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "role",
-                    "expectedValue": "region",
-                    "failureMessage": "Accordion panel doesn't conform to the ARIA Accordion pattern as specified in APG 1.2. Each accordion panel should have 'role=region' attribute. This helps assistive technology identify the panel as a significant region of the page."
-                },
                 {
                     "target": "panel",
                     "assertion": "toHaveAttribute",

package/dist/src/utils/test/{contracts/ComboboxContract.json → aria-contracts/combobox/combobox.listbox.contract.json}

@@ -1,15 +1,15 @@
 {
     "meta": {
-        "id": "aria-ease.combobox",
+        "id": "aria-ease.combobox.listbox",
         "version": "1.0.0",
         "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.",
+        "description": "ARIA Combobox with Listbox popup interaction contract. Validates the ARIA and interaction contract for a custom combobox with listbox component following the ARIA Authoring Practices Guide combobox with listbox popup pattern.",
         "source": {
             "apg": "https://www.w3.org/WAI/ARIA/apg/patterns/combobox/",
             "wcag": ["2.2 AA"]
         },
-        "W3CName": "Combobox"
+        "W3CName": "Combobox Listbox Popup"
     },
 
     "selectors": {
@@ -28,6 +28,20 @@
         "relative": "first | last | next | previous"
     },
 
+    "relationships": [
+        {
+            "type": "aria-reference",
+            "from": "input",
+            "attribute": "aria-controls",
+            "to": "listbox"
+        },
+        {
+            "type": "contains",
+            "parent": "listbox",
+            "child": "options"
+        }
+    ],
+
     "static": [
         {
             "assertions": [
@@ -49,6 +63,7 @@
                     "target": "input",
                     "assertion": "toHaveAttribute",
                     "attribute": "aria-controls",
+                    "expectedValue": "!empty",
                     "failureMessage": "Combobox input doesn't conform to the ARIA Combobox pattern. Input should have 'aria-controls' attribute that points to the id of the listbox it controls."
                 },
                 {
@@ -65,20 +80,6 @@
                     "expectedValue": "listbox",
                     "failureMessage": "Combobox input should have 'aria-haspopup=listbox' to indicate that it can trigger a listbox popup."
                 },
-                {
-                    "target": "listbox",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "role",
-                    "expectedValue": "listbox",
-                    "failureMessage": "Listbox element should have 'role=listbox' attribute."
-                },
-                {
-                    "target": "options",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "role",
-                    "expectedValue": "option",
-                    "failureMessage": "Each option in the listbox should have 'role=option' attribute."
-                },
                 {
                     "target": "options",
                     "assertion": "toHaveAttribute",

package/dist/src/utils/test/{contracts/MenuContract.json → aria-contracts/menu/menu.contract.json}

@@ -16,7 +16,7 @@
         "trigger": "[data-test-id=menu-trigger]",
         "container": "[role=menu]",
         "items": "[role=menuitem], [role=menuitemradio], [role=menuitemcheckbox]",
-        "submenuTrigger": "[role=menuitem][aria-haspopup=true], [role=menuitemradio][aria-haspopup=true], [role=menuitemcheckbox][aria-haspopup=true]",
+        "submenuTrigger": "[role=menu] [role=menuitem][aria-haspopup=true], [role=menu] [role=menuitemradio][aria-haspopup=true], [role=menu] [role=menuitemcheckbox][aria-haspopup=true], [role=menu] [role=menuitem][aria-haspopup=menu], [role=menu] [role=menuitemradio][aria-haspopup=menu], [role=menu] [role=menuitemcheckbox][aria-haspopup=menu]",
         "submenu": "[role=menu][aria-labelledby]",
         "focusable": "[role=menuitem], [role=menuitemradio], [role=menuitemcheckbox]",
         "relative": "[role=menuitem], [role=menuitemradio], [role=menuitemcheckbox]",
@@ -29,6 +29,26 @@
         "relative": "first | last | next | previous"
     },
 
+    "relationships": [
+        {
+            "type": "aria-reference",
+            "from": "trigger",
+            "attribute": "aria-controls",
+            "to": "container"
+        },
+        {
+            "type": "aria-reference",
+            "from": "container",
+            "attribute": "aria-labelledby",
+            "to": "trigger"
+        },
+        {
+            "type": "contains",
+            "parent": "container",
+            "child": "items"
+        }
+    ],
+
     "static": [
         {
             "assertions": [
@@ -57,6 +77,27 @@
                     "assertion": "toHaveAttribute",
                     "attribute": "aria-labelledby | aria-label",
                     "failureMessage": "Menu container doesn't conform to the ARIA Menu pattern as specified in APG 1.2. Menu container should have 'aria-labelledby' attribute that points to the id of the trigger button that controls it, or 'aria-label' that describes the purpose of the container."
+                },
+                {
+                    "target": "container",
+                    "assertion": "toHaveAttribute",
+                    "attribute": "role",
+                    "expectedValue": "menu",
+                    "failureMessage": "Menu container doesn't conform to the ARIA Menu pattern as specified in APG 1.2. Menu container should have role of 'menu'"
+                }, 
+                {
+                    "target": "items",
+                    "assertion": "toHaveAttribute",
+                    "attribute": "role",
+                    "expectedValue": "menuitem | menuitemcheckbox | menuitemradio",
+                    "failureMessage": "Menu items do not conform to the ARIA Menu pattern as specified in APG 1.2. Menu items should have role of 'menuitem', 'menuitemcheckbox', or 'menuitemradio'"
+                },
+                {
+                    "target": "items",
+                    "assertion": "toHaveAttribute",
+                    "attribute": "tabindex",
+                    "expectedValue": "-1",
+                    "failureMessage": "Menu items do not conform to the ARIA Menu pattern as specified in APG 1.2. Menu items' tabindex should have value of '-1'. This ensures the menu items are excluded from the page's Tab sequence"
                 }
             ]
         }

package/dist/src/utils/test/{contracts/TabsContract.json → aria-contracts/tabs/tabs.contract.json}

@@ -26,6 +26,26 @@
         "relative": "first | last | next | previous"
     }, 
 
+    "relationships": [
+        {
+            "type": "aria-reference",
+            "from": "tab",
+            "attribute": "aria-controls",
+            "to": "panel"
+        },
+        {
+            "type": "aria-reference",
+            "from": "panel",
+            "attribute": "aria-labelledby",
+            "to": "tab"
+        },
+        {
+            "type": "contains",
+            "parent": "tablist",
+            "child": "tab"
+        }
+    ],
+
     "static": [
         {
             "assertions": [
@@ -48,13 +68,6 @@
                     "attribute": "aria-controls",
                     "failureMessage": "Tab element doesn't conform to the ARIA Tab pattern as specified in APG 1.2. Tab element should have 'aria-controls' attribute that points to the id of the tab panel it controls. This helps assistive technology to associate the tab with its corresponding tab panel."
                 },
-                {
-                    "target": "panel",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "role",
-                    "expectedValue": "tabpanel",
-                    "failureMessage": "Tab panel doesn't conform to the ARIA Tab pattern as specified in APG 1.2. Each tab panel should have 'role=tabpanel' attribute. This helps assistive technology identify the panel as a significant region of the page."
-                },
                 {
                     "target": "panel",
                     "assertion": "toHaveAttribute",