aria-ease 6.11.0 → 6.12.0

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

@@ -30,31 +30,6 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
-// src/utils/test/contract/contract.json
-var contract_default;
-var init_contract = __esm({
-  "src/utils/test/contract/contract.json"() {
-    contract_default = {
-      menu: {
-        path: "./aria-contracts/menu/menu.contract.json",
-        component: "menu"
-      },
-      "combobox.listbox": {
-        path: "./aria-contracts/combobox/combobox.listbox.contract.json",
-        component: "combobox.listbox"
-      },
-      accordion: {
-        path: "./aria-contracts/accordion/accordion.contract.json",
-        component: "accordion"
-      },
-      tabs: {
-        path: "./aria-contracts/tabs/tabs.contract.json",
-        component: "tabs"
-      }
-    };
-  }
-});
-
 // src/utils/test/src/ContractReporter.ts
 var ContractReporter;
 var init_ContractReporter = __esm({
@@ -473,8 +448,8 @@ function validateConfig(config) {
               if (typeof comp.name !== "string") {
                 errors.push(`test.components[${idx}].name must be a string`);
               }
-              if (comp.path !== void 0 && typeof comp.path !== "string") {
-                errors.push(`test.components[${idx}].path must be a string when provided`);
+              if (comp.contractPath !== void 0 && typeof comp.contractPath !== "string") {
+                errors.push(`test.components[${idx}].contractPath must be a string when provided`);
               }
               if (comp.strategyPath !== void 0 && typeof comp.strategyPath !== "string") {
                 errors.push(`test.components[${idx}].strategyPath must be a string when provided`);
@@ -848,12 +823,6 @@ var init_StrategyRegistry = __esm({
             (m) => m.TabsComponentStrategy
           )
         );
-        this.builtInStrategies.set(
-          "combobox.listbox",
-          () => Promise.resolve().then(() => (init_ComboboxComponentStrategy(), ComboboxComponentStrategy_exports)).then(
-            (m) => m.ComboboxComponentStrategy
-          )
-        );
       }
       /**
        * Load a strategy - either from custom path or built-in registry
@@ -901,7 +870,6 @@ var init_StrategyRegistry = __esm({
 var ComponentDetector;
 var init_ComponentDetector = __esm({
   "src/utils/test/src/ComponentDetector.ts"() {
-    init_contract();
     init_StrategyRegistry();
     ComponentDetector = class {
       static strategyRegistry = new StrategyRegistry();
@@ -922,11 +890,7 @@ var init_ComponentDetector = __esm({
        */
       static async detect(componentName, componentConfig, actionTimeoutMs = 400, assertionTimeoutMs = 400, configBaseDir) {
         const typedComponentConfig = this.isComponentConfig(componentConfig) ? componentConfig : void 0;
-        let contractPath = typedComponentConfig?.path;
-        if (!contractPath) {
-          const contractTyped = contract_default;
-          contractPath = contractTyped[componentName]?.path;
-        }
+        const contractPath = typedComponentConfig?.contractPath;
         if (!contractPath) {
           throw new Error(`Contract path not found for component: ${componentName}`);
         }
@@ -959,7 +923,7 @@ var init_ComponentDetector = __esm({
         if (!strategyClass) {
           return null;
         }
-        const mainSelector = selectors.trigger || selectors.input || selectors.tablist || selectors.container;
+        const mainSelector = selectors.main;
         if (componentName === "tabs") {
           return new strategyClass(mainSelector, selectors);
         }
@@ -1528,7 +1492,7 @@ __export(contractTestRunnerPlaywright_exports, {
 });
 async function runContractTestsPlaywright(componentName, url, strictness, config, configBaseDir) {
   const componentConfig = config?.test?.components?.find((c) => c.name === componentName);
-  const isCustomContract = !!componentConfig?.path;
+  const isCustomContract = !!componentConfig?.contractPath;
   const reporter = new ContractReporter(true, isCustomContract);
   const defaultTimeouts = {
     actionTimeoutMs: 400,
@@ -1568,11 +1532,7 @@ async function runContractTestsPlaywright(componentName, url, strictness, config
     defaultTimeouts.componentReadyTimeoutMs
   );
   const strictnessMode = normalizeStrictness(strictness);
-  let contractPath = componentConfig?.path;
-  if (!contractPath) {
-    const contractTyped = contract_default;
-    contractPath = contractTyped[componentName]?.path;
-  }
+  const contractPath = componentConfig?.contractPath;
   if (!contractPath) {
     throw new Error(`Contract path not found for component: ${componentName}`);
   }
@@ -2065,7 +2025,6 @@ This usually means:
 }
 var init_contractTestRunnerPlaywright = __esm({
   "src/utils/test/src/contractTestRunnerPlaywright.ts"() {
-    init_contract();
     init_playwrightTestHarness();
     init_ComponentDetector();
     init_ContractReporter();
@@ -2185,19 +2144,15 @@ var init_badgeHelper = __esm({
 });
 
 // src/utils/test/src/contractTestRunner.ts
-init_contract();
 init_ContractReporter();
 init_strictness();
-async function runContractTests(componentName, component, strictness) {
+async function runContractTests(contractPath, componentName, component, strictness) {
   const reporter = new ContractReporter(false);
   const strictnessMode = normalizeStrictness(strictness);
-  const contractTyped = contract_default;
-  const contractPath = contractTyped[componentName]?.path;
   if (!contractPath) {
-    throw new Error(`No contract found for component: ${componentName}`);
+    throw new Error(`No contract path provided for component: ${componentName}`);
   }
-  const resolvedPath = new URL(contractPath, (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href))).pathname;
-  const contractData = await fs__default.default.readFile(resolvedPath, "utf-8");
+  const contractData = await fs__default.default.readFile(contractPath, "utf-8");
   const componentContract = JSON.parse(contractData);
   const totalTests = (componentContract.relationships?.length || 0) + (componentContract.static[0]?.assertions.length || 0) + componentContract.dynamic.length;
   reporter.start(componentName, totalTests);
@@ -2430,7 +2385,16 @@ Please start your dev server and try again.`
       }
     } else if (component) {
       console.log(`\u{1F3AD} Running component contract tests in JSDOM mode`);
-      contract = await runContractTests(componentName, component, strictness);
+      const contractPath = config.test?.components?.find((comp) => comp?.name === componentName)?.contractPath;
+      if (!contractPath) {
+        throw new Error(`\u274C No contract path found for component: ${componentName}`);
+      }
+      contract = await runContractTests(
+        path3__default.default.resolve(configBaseDir, contractPath),
+        componentName,
+        component,
+        strictness
+      );
     } else {
       throw new Error("\u274C Either component or URL must be provided");
     }

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

@@ -1,18 +1,15 @@
-import { normalizeStrictness, closeSharedBrowser, ContractReporter, contract_default, normalizeLevel, resolveEnforcement } from './chunk-XERMSYEH.js';
+import { normalizeStrictness, closeSharedBrowser, ContractReporter, normalizeLevel, resolveEnforcement } from './chunk-FZ7GMIJB.js';
 import { axe } from 'jest-axe';
 import fs from 'fs/promises';
 import path from 'path';
 
-async function runContractTests(componentName, component, strictness) {
+async function runContractTests(contractPath, componentName, component, strictness) {
   const reporter = new ContractReporter(false);
   const strictnessMode = normalizeStrictness(strictness);
-  const contractTyped = contract_default;
-  const contractPath = contractTyped[componentName]?.path;
   if (!contractPath) {
-    throw new Error(`No contract found for component: ${componentName}`);
+    throw new Error(`No contract path provided for component: ${componentName}`);
   }
-  const resolvedPath = new URL(contractPath, import.meta.url).pathname;
-  const contractData = await fs.readFile(resolvedPath, "utf-8");
+  const contractData = await fs.readFile(contractPath, "utf-8");
   const componentContract = JSON.parse(contractData);
   const totalTests = (componentContract.relationships?.length || 0) + (componentContract.static[0]?.assertions.length || 0) + componentContract.dynamic.length;
   reporter.start(componentName, totalTests);
@@ -209,7 +206,7 @@ Error: ${error instanceof Error ? error.message : String(error)}`
   let configBaseDir = typeof process !== "undefined" ? process.cwd() : "";
   if (typeof process !== "undefined" && typeof process.cwd === "function") {
     try {
-      const { loadConfig } = await import('./configLoader-SHJSRG2A.js');
+      const { loadConfig } = await import('./configLoader-NA7IBCS3.js');
       const result2 = await loadConfig(process.cwd());
       config = result2.config;
       if (result2.configPath) {
@@ -231,7 +228,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-Z2AHXSNM.js');
+        const { runContractTestsPlaywright } = await import('./contractTestRunnerPlaywright-CIZOXYRW.js');
         contract = await runContractTestsPlaywright(componentName, devServerUrl, strictness, config, configBaseDir);
       } else {
         throw new Error(
@@ -241,7 +238,16 @@ Please start your dev server and try again.`
       }
     } else if (component) {
       console.log(`\u{1F3AD} Running component contract tests in JSDOM mode`);
-      contract = await runContractTests(componentName, component, strictness);
+      const contractPath = config.test?.components?.find((comp) => comp?.name === componentName)?.contractPath;
+      if (!contractPath) {
+        throw new Error(`\u274C No contract path found for component: ${componentName}`);
+      }
+      contract = await runContractTests(
+        path.resolve(configBaseDir, contractPath),
+        componentName,
+        component,
+        strictness
+      );
     } else {
       throw new Error("\u274C Either component or URL must be provided");
     }

package/dist/{test-O3J4ZPQR.js → test-HBPCSYH5.js}

@@ -1,11 +1,10 @@
 import {
   ContractReporter,
   closeSharedBrowser,
-  contract_default,
   normalizeLevel,
   normalizeStrictness,
   resolveEnforcement
-} from "./chunk-XERMSYEH.js";
+} from "./chunk-FZ7GMIJB.js";
 import "./chunk-I2KLQ2HA.js";
 
 // src/utils/test/src/test.ts
@@ -13,16 +12,13 @@ import { axe } from "jest-axe";
 
 // src/utils/test/src/contractTestRunner.ts
 import fs from "fs/promises";
-async function runContractTests(componentName, component, strictness) {
+async function runContractTests(contractPath, componentName, component, strictness) {
   const reporter = new ContractReporter(false);
   const strictnessMode = normalizeStrictness(strictness);
-  const contractTyped = contract_default;
-  const contractPath = contractTyped[componentName]?.path;
   if (!contractPath) {
-    throw new Error(`No contract found for component: ${componentName}`);
+    throw new Error(`No contract path provided for component: ${componentName}`);
   }
-  const resolvedPath = new URL(contractPath, import.meta.url).pathname;
-  const contractData = await fs.readFile(resolvedPath, "utf-8");
+  const contractData = await fs.readFile(contractPath, "utf-8");
   const componentContract = JSON.parse(contractData);
   const totalTests = (componentContract.relationships?.length || 0) + (componentContract.static[0]?.assertions.length || 0) + componentContract.dynamic.length;
   reporter.start(componentName, totalTests);
@@ -222,7 +218,7 @@ Error: ${error instanceof Error ? error.message : String(error)}`
   let configBaseDir = typeof process !== "undefined" ? process.cwd() : "";
   if (typeof process !== "undefined" && typeof process.cwd === "function") {
     try {
-      const { loadConfig } = await import("./configLoader-UJZHQBYS.js");
+      const { loadConfig } = await import("./configLoader-REHK3S3Q.js");
       const result2 = await loadConfig(process.cwd());
       config = result2.config;
       if (result2.configPath) {
@@ -244,7 +240,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-QDXSK3FE.js");
+        const { runContractTestsPlaywright } = await import("./contractTestRunnerPlaywright-EWAWQVHT.js");
         contract = await runContractTestsPlaywright(componentName, devServerUrl, strictness, config, configBaseDir);
       } else {
         throw new Error(
@@ -254,7 +250,16 @@ Please start your dev server and try again.`
       }
     } else if (component) {
       console.log(`\u{1F3AD} Running component contract tests in JSDOM mode`);
-      contract = await runContractTests(componentName, component, strictness);
+      const contractPath = config.test?.components?.find((comp) => comp?.name === componentName)?.contractPath;
+      if (!contractPath) {
+        throw new Error(`\u274C No contract path found for component: ${componentName}`);
+      }
+      contract = await runContractTests(
+        path.resolve(configBaseDir, contractPath),
+        componentName,
+        component,
+        strictness
+      );
     } else {
       throw new Error("\u274C Either component or URL must be provided");
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aria-ease",
-  "version": "6.11.0",
+  "version": "6.12.0",
   "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",
@@ -22,8 +22,7 @@
     "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:dsl": "tsup ./src/utils/test/dsl/index.ts --format esm,cjs --dts --treeshake --outDir dist/src/utils/test/dsl",
     "build:cli": "tsup ./src/utils/cli/cli.ts --format esm,cjs --dts --outDir dist --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/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:dsl && npm run build:cli && npm run build:contracts"
+    "build": "npm run clean && npm run build:core && npm run build:modules && npm run build:test && npm run build:dsl && npm run build:cli"
   },
   "repository": {
     "type": "git",

package/dist/src/utils/test/aria-contracts/accordion/accordion.contract.json

@@ -1,290 +0,0 @@
-{
-    "meta": {
-        "id": "aria-ease.contract.accordion",
-        "version": "1.0.0",
-        "created": "09-02-2026",
-        "lastUpdated": "19-03-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/",
-            "wcag": ["2.2 AA"]
-        },
-        "W3CName": "Accordion"
-    },
-
-    "selectors": {
-        "trigger": "[data-accordion] [aria-controls][aria-expanded], [aria-controls][aria-expanded]",
-        "focusable": "[data-accordion] [aria-controls][aria-expanded], [aria-controls][aria-expanded]",
-        "relative": "[data-accordion] [aria-controls][aria-expanded], [aria-controls][aria-expanded]",
-        "panel": "[role='region'][aria-labelledby], [role='region'][aria-labelledby]"
-    },
-
-    "observables": {
-        "observable": "focus | visible | attribute | role",
-        "target": "trigger | relative | panel | focusable",
-        "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"
-        }
-    ],
-
-    "static": [
-        {
-            "assertions": [
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-expanded",
-                    "expectedValue": "true | false",
-                    "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-expanded=true | false' attribute. This helps assistive technology to keep track of the open or close state of the accordion panel div that the button controls."
-                },
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "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": "aria-labelledby | aria-label",
-                    "failureMessage": "Accordion panel doesn't conform to the ARIA Accordion pattern as specified in APG 1.2. Accordion panel should have 'aria-labelledby' attribute that points to the id of the trigger button that controls it."
-                }
-            ]
-        }
-    ],
-
-    "dynamic": [
-        {
-            "description": "Clicking the trigger expands a collapsed panel.",
-            "action": [
-                { "type": "click", "target": "trigger" }
-            ],
-            "assertions": [
-                {
-                    "target": "panel",
-                    "assertion": "toBeVisible",
-                    "failureMessage": "Panel should be visible after clicking the trigger."
-                },
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-expanded",
-                    "expectedValue": "true",
-                    "failureMessage": "Trigger's aria-expanded attribute should be true after clicking to expand."
-                }
-            ]
-        },
-        {
-            "description": "Clicking the trigger again collapses an expanded panel.",
-            "action": [
-                { "type": "click", "target": "trigger" },
-                { "type": "click", "target": "trigger" }
-            ],
-            "assertions": [
-                {
-                    "target": "panel",
-                    "assertion": "notToBeVisible",
-                    "failureMessage": "Panel should not be visible after clicking the trigger twice."
-                },
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-expanded",
-                    "expectedValue": "false",
-                    "failureMessage": "Trigger's aria-expanded attribute should be false after collapsing."
-                }
-            ]
-        },
-        {
-            "description": "Pressing Enter on trigger expands a collapsed panel.",
-            "action": [
-                { "type": "keypress", "target": "trigger", "key": "Enter" }
-            ],
-            "assertions": [
-                {
-                    "target": "panel",
-                    "assertion": "toBeVisible",
-                    "failureMessage": "Panel should be visible after pressing Enter on trigger."
-                },
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-expanded",
-                    "expectedValue": "true",
-                    "failureMessage": "Trigger's should have aria-expanded=true after pressing Enter."
-                }
-            ]
-        },
-        {
-            "description": "Pressing Space on trigger expands a collapsed panel.",
-            "action": [
-                { "type": "keypress", "target": "trigger", "key": "Space" }
-            ],
-            "assertions": [
-                {
-                    "target": "panel",
-                    "assertion": "toBeVisible",
-                    "failureMessage": "Panel should be visible after pressing Space on trigger."
-                },
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-expanded",
-                    "expectedValue": "true",
-                    "failureMessage": "Trigger's should have aria-expanded=true after pressing Space."
-                }
-            ]
-        },
-        {
-            "description": "Pressing Enter on trigger collapses an expanded panel.",
-            "action": [
-                { "type": "keypress", "target": "trigger", "key": "Enter" },
-                { "type": "keypress", "target": "trigger", "key": "Enter" }
-            ],
-            "assertions": [
-                {
-                    "target": "panel",
-                    "assertion": "notToBeVisible",
-                    "failureMessage": "Panel should not be visible after pressing Enter on expanded trigger."
-                },
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-expanded",
-                    "expectedValue": "false",
-                    "failureMessage": "Trigger's aria-expanded should be false after collapsing with Enter."
-                }
-            ]
-        },
-        {
-            "description": "Pressing Space on trigger collapses an expanded panel.",
-            "action": [
-                { "type": "keypress", "target": "trigger", "key": "Space" },
-                { "type": "keypress", "target": "trigger", "key": "Space" }
-            ],
-            "assertions": [
-                {
-                    "target": "panel",
-                    "assertion": "notToBeVisible",
-                    "failureMessage": "Panel should not be visible after pressing Space on expanded trigger."
-                },
-                {
-                    "target": "trigger",
-                    "assertion": "toHaveAttribute",
-                    "attribute": "aria-expanded",
-                    "expectedValue": "false",
-                    "failureMessage": "Trigger's aria-expanded should be false after collapsing with Space."
-                }
-            ]
-        },
-        {
-            "description": "Down Arrow moves focus to next accordion trigger.",
-            "isMultiple": true,
-            "level": "optional",
-            "action": [
-                { "type": "keypress", "target": "focusable", "key": "ArrowDown" }
-            ],
-            "assertions": [
-                {
-                    "target": "relative",
-                    "assertion": "toHaveFocus",
-                    "expectedValue": "second",
-                    "failureMessage": "Focus should move to the next accordion trigger after pressing Down Arrow."
-                }
-            ]
-        },
-        {
-            "description": "Up Arrow moves focus to previous accordion trigger.",
-            "isMultiple": true,
-            "level": "optional",
-            "action": [
-                { "type": "keypress", "target": "focusable", "key": "ArrowUp" }
-            ],
-            "assertions": [
-                {
-                    "target": "relative",
-                    "assertion": "toHaveFocus",
-                    "expectedValue": "first",
-                    "failureMessage": "Focus should move to the previous accordion trigger after pressing Up Arrow."
-                }
-            ]
-        },
-        {
-            "description": "Home moves focus to first accordion trigger.",
-            "isMultiple": true,
-            "level": "optional",
-            "action": [
-                { "type": "keypress", "target": "focusable", "key": "Home" }
-            ],
-            "assertions": [
-                {
-                    "target": "relative",
-                    "assertion": "toHaveFocus",
-                    "expectedValue": "first",
-                    "failureMessage": "Focus should move to the first accordion trigger after pressing Home."
-                }
-            ]
-        },
-        {
-            "description": "End moves focus to last accordion trigger.",
-            "isMultiple": true,
-            "level": "optional",
-            "action": [
-                { "type": "keypress", "target": "focusable", "key": "End" }
-            ],
-            "assertions": [
-                {
-                    "target": "relative",
-                    "assertion": "toHaveFocus",
-                    "expectedValue": "last",
-                    "failureMessage": "Focus should move to the last accordion trigger after pressing End."
-                }
-            ]
-        },
-        {
-            "description": "Down Arrow wraps focus from last trigger to first trigger.",
-            "isMultiple": true,
-            "level": "optional",
-            "action": [
-                { "type": "keypress", "target": "focusable", "key": "ArrowDown" }
-            ],
-            "assertions": [
-                {
-                    "target": "relative",
-                    "assertion": "toHaveFocus",
-                    "expectedValue": "first",
-                    "failureMessage": "Focus should wrap from last to first accordion trigger after pressing Down Arrow."
-                }
-            ]
-        },
-        {
-            "description": "Up Arrow wraps focus from first trigger to last trigger.",
-            "isMultiple": true,
-            "level": "optional",
-            "action": [
-                { "type": "keypress", "target": "focusable", "key": "ArrowUp" }
-            ],
-            "assertions": [
-                {
-                    "target": "relative",
-                    "assertion": "toHaveFocus",
-                    "expectedValue": "last",
-                    "failureMessage": "Focus should wrap from first to last accordion trigger after pressing Up Arrow."
-                }
-            ]
-        }
-    ]
-}