aria-ease 6.10.0 → 6.12.0

package/README.md

@@ -60,7 +60,7 @@ npx aria-ease audit --url https://yoursite.com
 
 #### 3. **Contract Testing** (Available Now)
 
-This is the game-changer. Encoded a deterministic, testable interpretation of WAI-ARIA APG guidance into JSON "contracts" using Aria-Ease DSL API, and validate your contract against your component using Aria-Ease's Playwright runner with isolated test-harness architecture. Run it locally or in CI/CD.
+This is the game-changer. Encode a deterministic, testable interpretation of WAI-ARIA APG guidance into JSON "contracts" using Aria-Ease DSL API, and validate your contract against your component using Aria-Ease's Playwright runner with isolated test-harness architecture. Run it locally or in CI/CD.
 
 Teams and experts can enforce their own standards and maintain reusability and consistency.
 
@@ -195,7 +195,7 @@ export default {
     strictness: "balanced",
     components: [
       {
-        name: "combobox.listbox",
+        name: "combobox",
         path: "./tests/external-contracts/combobox.listbox.contract.json",
         strategyPath: "./tests/external-strategies/CustomComboboxStrategy.js",
       },

package/{bin/buildContracts-S22V7AGV.js → dist/buildContracts-FT6KWUJN.js}

@@ -1,12 +1,12 @@
 import "./chunk-I2KLQ2HA.js";
 
-// src/utils/cli/buildContracts.ts
+// src/utils/test/dsl/src/buildContracts.ts
 import path from "path";
 import fs from "fs-extra";
 import { glob } from "fs/promises";
 import chalk from "chalk";
 
-// src/utils/cli/contractValidator.ts
+// src/utils/test/dsl/src/contractValidator.ts
 function validateContractSchema(contract) {
   const errors = [];
   if (!contract || typeof contract !== "object") {
@@ -348,7 +348,7 @@ function validateTargetReferences(contract, selectorKeys) {
   return errors;
 }
 
-// src/utils/cli/buildContracts.ts
+// src/utils/test/dsl/src/buildContracts.ts
 async function buildContracts(cwd, config) {
   const errors = [];
   const built = [];

package/dist/{chunk-XERMSYEH.js → chunk-FZ7GMIJB.js}

@@ -1,23 +1,3 @@
-// src/utils/test/contract/contract.json
-var 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 = class {
   startTime = 0;
@@ -353,7 +333,6 @@ async function closeSharedBrowser() {
 }
 
 export {
-  contract_default,
   ContractReporter,
   normalizeLevel,
   normalizeStrictness,

package/{bin/chunk-NI3MQCAS.js → dist/chunk-GJGUY643.js}

@@ -68,8 +68,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`);

package/{bin → dist}/cli.cjs

@@ -103,8 +103,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`);
@@ -586,31 +586,6 @@ var init_formatters = __esm({
   }
 });
 
-// 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({
@@ -914,16 +889,13 @@ var init_strictness = __esm({
 });
 
 // src/utils/test/src/contractTestRunner.ts
-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 import_promises.default.readFile(resolvedPath, "utf-8");
+  const contractData = await import_promises.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);
@@ -1078,15 +1050,13 @@ async function runContractTests(componentName, component, strictness) {
   reporter.summary(failures);
   return { passes, failures, skipped, warnings };
 }
-var import_promises, import_meta;
+var import_promises;
 var init_contractTestRunner = __esm({
   "src/utils/test/src/contractTestRunner.ts"() {
     "use strict";
-    init_contract();
     import_promises = __toESM(require("fs/promises"), 1);
     init_ContractReporter();
     init_strictness();
-    import_meta = {};
   }
 });
 
@@ -1428,12 +1398,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
@@ -1480,15 +1444,14 @@ var init_StrategyRegistry = __esm({
 });
 
 // src/utils/test/src/ComponentDetector.ts
-var import_fs, import_path4, import_meta2, ComponentDetector;
+var import_fs, import_path4, import_meta, ComponentDetector;
 var init_ComponentDetector = __esm({
   "src/utils/test/src/ComponentDetector.ts"() {
     "use strict";
     import_fs = require("fs");
     import_path4 = __toESM(require("path"), 1);
-    init_contract();
     init_StrategyRegistry();
-    import_meta2 = {};
+    import_meta = {};
     ComponentDetector = class {
       static strategyRegistry = new StrategyRegistry();
       static isComponentConfig(value) {
@@ -1508,11 +1471,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}`);
         }
@@ -1531,7 +1490,7 @@ var init_ComponentDetector = __esm({
             (0, import_fs.readFileSync)(cwdResolved, "utf-8");
             return cwdResolved;
           } catch {
-            return new URL(contractPath, import_meta2.url).pathname;
+            return new URL(contractPath, import_meta.url).pathname;
           }
         })();
         const contractData = (0, import_fs.readFileSync)(resolvedPath, "utf-8");
@@ -1545,7 +1504,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);
         }
@@ -2120,7 +2079,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,
@@ -2160,11 +2119,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}`);
   }
@@ -2183,7 +2138,7 @@ async function runContractTestsPlaywright(componentName, url, strictness, config
       (0, import_fs2.readFileSync)(cwdResolved, "utf-8");
       return cwdResolved;
     } catch {
-      return new URL(contractPath, import_meta3.url).pathname;
+      return new URL(contractPath, import_meta2.url).pathname;
     }
   })();
   const contractData = (0, import_fs2.readFileSync)(resolvedPath, "utf-8");
@@ -2655,20 +2610,19 @@ This usually means:
   }
   return { passes, failures, skipped, warnings };
 }
-var import_fs2, import_path5, import_meta3;
+var import_fs2, import_path5, import_meta2;
 var init_contractTestRunnerPlaywright = __esm({
   "src/utils/test/src/contractTestRunnerPlaywright.ts"() {
     "use strict";
     import_fs2 = require("fs");
     import_path5 = __toESM(require("path"), 1);
-    init_contract();
     init_playwrightTestHarness();
     init_ComponentDetector();
     init_ContractReporter();
     init_ActionExecutor();
     init_AssertionRunner();
     init_strictness();
-    import_meta3 = {};
+    import_meta2 = {};
   }
 });
 
@@ -2747,7 +2701,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(
+        import_path6.default.resolve(configBaseDir, contractPath),
+        componentName,
+        component,
+        strictness
+      );
     } else {
       throw new Error("\u274C Either component or URL must be provided");
     }
@@ -2865,7 +2828,7 @@ var init_test3 = __esm({
   }
 });
 
-// src/utils/cli/contractValidator.ts
+// src/utils/test/dsl/src/contractValidator.ts
 function validateContractSchema(contract) {
   const errors = [];
   if (!contract || typeof contract !== "object") {
@@ -3207,12 +3170,12 @@ function validateTargetReferences(contract, selectorKeys) {
   return errors;
 }
 var init_contractValidator = __esm({
-  "src/utils/cli/contractValidator.ts"() {
+  "src/utils/test/dsl/src/contractValidator.ts"() {
     "use strict";
   }
 });
 
-// src/utils/cli/buildContracts.ts
+// src/utils/test/dsl/src/buildContracts.ts
 var buildContracts_exports = {};
 __export(buildContracts_exports, {
   buildContracts: () => buildContracts
@@ -3330,7 +3293,7 @@ ${errorLines}`;
 }
 var import_path7, import_fs_extra3, import_promises2, import_chalk2;
 var init_buildContracts = __esm({
-  "src/utils/cli/buildContracts.ts"() {
+  "src/utils/test/dsl/src/buildContracts.ts"() {
     "use strict";
     import_path7 = __toESM(require("path"), 1);
     import_fs_extra3 = __toESM(require("fs-extra"), 1);

package/{bin → dist}/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   loadConfig
-} from "./chunk-NI3MQCAS.js";
+} from "./chunk-GJGUY643.js";
 import {
   displayBadgeInfo,
   promptAddBadge
@@ -122,13 +122,13 @@ program.command("audit").description("Run axe-core powered accessibility audit o
   process.exit(1);
 });
 program.command("test").description("Run core a11y accessibility standard tests on UI components").action(async () => {
-  const { runTest } = await import("./test-O3J4ZPQR.js");
+  const { runTest } = await import("./test-HBPCSYH5.js");
   runTest();
 });
 program.command("build").description("Build accessibility artifacts").addCommand(
   new Command("contracts").description("Build DSL contracts to JSON").action(async () => {
-    const { buildContracts } = await import("./buildContracts-S22V7AGV.js");
-    const { loadConfig: loadConfig2 } = await import("./configLoader-UJZHQBYS.js");
+    const { buildContracts } = await import("./buildContracts-FT6KWUJN.js");
+    const { loadConfig: loadConfig2 } = await import("./configLoader-REHK3S3Q.js");
     const cwd = process.cwd();
     const { config, configPath, errors } = await loadConfig2(cwd);
     if (configPath) {

package/dist/{configLoader-DWHOHXHL.js → configLoader-Q7N5XV4P.js}

@@ -70,8 +70,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`);

package/{bin/configLoader-UJZHQBYS.js → dist/configLoader-REHK3S3Q.js}

@@ -1,6 +1,6 @@
 import {
   loadConfig
-} from "./chunk-NI3MQCAS.js";
+} from "./chunk-GJGUY643.js";
 import "./chunk-I2KLQ2HA.js";
 export {
   loadConfig

package/{bin/contractTestRunnerPlaywright-QDXSK3FE.js → dist/contractTestRunnerPlaywright-DIXP5DQ3.js}

@@ -1,11 +1,10 @@
 import {
   ContractReporter,
-  contract_default,
   createTestPage,
   normalizeLevel,
   normalizeStrictness,
   resolveEnforcement
-} from "./chunk-XERMSYEH.js";
+} from "./chunk-FZ7GMIJB.js";
 import {
   test_exports
 } from "./chunk-PK5L2SAF.js";
@@ -55,12 +54,6 @@ var StrategyRegistry = class {
         (m) => m.TabsComponentStrategy
       )
     );
-    this.builtInStrategies.set(
-      "combobox.listbox",
-      () => import("./ComboboxComponentStrategy-OGRVZXAF.js").then(
-        (m) => m.ComboboxComponentStrategy
-      )
-    );
   }
   /**
    * Load a strategy - either from custom path or built-in registry
@@ -124,11 +117,7 @@ var ComponentDetector = class {
    */
   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}`);
     }
@@ -161,7 +150,7 @@ var ComponentDetector = class {
     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);
     }
@@ -709,7 +698,7 @@ var AssertionRunner = class {
 // src/utils/test/src/contractTestRunnerPlaywright.ts
 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,
@@ -749,11 +738,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}`);
   }

package/dist/{contractTestRunnerPlaywright-WNWQYSXZ.js → contractTestRunnerPlaywright-EWAWQVHT.js}

@@ -1,11 +1,10 @@
 import {
   ContractReporter,
-  contract_default,
   createTestPage,
   normalizeLevel,
   normalizeStrictness,
   resolveEnforcement
-} from "./chunk-XERMSYEH.js";
+} from "./chunk-FZ7GMIJB.js";
 import {
   test_exports
 } from "./chunk-PK5L2SAF.js";
@@ -55,12 +54,6 @@ var StrategyRegistry = class {
         (m) => m.TabsComponentStrategy
       )
     );
-    this.builtInStrategies.set(
-      "combobox.listbox",
-      () => import("./ComboboxComponentStrategy-OGRVZXAF.js").then(
-        (m) => m.ComboboxComponentStrategy
-      )
-    );
   }
   /**
    * Load a strategy - either from custom path or built-in registry
@@ -124,11 +117,7 @@ var ComponentDetector = class {
    */
   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}`);
     }
@@ -161,7 +150,7 @@ var ComponentDetector = class {
     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);
     }
@@ -709,7 +698,7 @@ var AssertionRunner = class {
 // src/utils/test/src/contractTestRunnerPlaywright.ts
 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,
@@ -749,11 +738,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}`);
   }