aria-ease 6.9.1 → 6.11.0

package/README.md

@@ -60,9 +60,9 @@ npx aria-ease audit --url https://yoursite.com
 
 #### 3. **Contract Testing** (Available Now)
 
-This is the game-changer. We encoded a deterministic, testable baseline interpretation of WAI-ARIA APG guidance into JSON "contracts" and built a custom 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.
 
-Today, Aria-Ease maintains this baseline contract set. Down the line, contracts are being designed to be extendable and overridable so teams and experts can enforce their own standards without losing consistency.
+Teams and experts can enforce their own standards and maintain reusability and consistency.
 
 **The result?** Component interaction testing that feels closer to unit testing than manual QA.
 
@@ -72,7 +72,7 @@ npx aria-ease test
 # ✓ 26 assertions in ~1 second in CI
 ```
 
-**Why this matters:** Before, verifying a combobox meant testing every interaction manually. Now, Aria-Ease automates the repeatable baseline aspects of testing a combobox: keyboard interaction, ARIA state updates, visibility, and semantic roles.
+**Why this matters:** Before, verifying a combobox meant testing every interaction manually. Now, Aria-Ease automates the repeatable, deterministic aspects of testing a combobox: keyboard interaction, ARIA state updates, visibility, and semantic roles.
 
 #### 4. **CI/CD Integration** (Available Now)
 

package/{bin/buildContracts-GBOY7UXG.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") {
@@ -214,6 +214,25 @@ function validateContractSchema(contract) {
       });
     }
   }
+  if (c.states !== void 0) {
+    if (!Array.isArray(c.states)) {
+      errors.push({ path: "$.states", message: "states must be an array" });
+    } else {
+      c.states.forEach((state, idx) => {
+        if (typeof state !== "object" || state === null) {
+          errors.push({ path: `$.states[${idx}]`, message: "state must be an object" });
+          return;
+        }
+        const s = state;
+        if (typeof s.name !== "string") {
+          errors.push({ path: `$.states[${idx}].name`, message: "name is required and must be a string" });
+        }
+        if (!Array.isArray(s.requires)) {
+          errors.push({ path: `$.states[${idx}].requires`, message: "requires is required and must be an array" });
+        }
+      });
+    }
+  }
   return {
     valid: errors.length === 0,
     errors
@@ -289,8 +308,17 @@ function validateTargetReferences(contract, selectorKeys) {
     });
   }
   const dynamicItems = c.dynamic;
+  const states = c.states;
+  const stateNames = new Set((states || []).map((s) => String(s.name)));
   if (Array.isArray(dynamicItems)) {
     dynamicItems.forEach((item, itemIdx) => {
+      const given = item.given;
+      if (given && !stateNames.has(given)) {
+        errors.push({
+          path: `$.dynamic[${itemIdx}].given`,
+          message: `State '${given}' not found in states`
+        });
+      }
       const actions = item.action;
       if (Array.isArray(actions)) {
         actions.forEach((action, actIdx) => {
@@ -320,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/{bin/chunk-LMSKLN5O.js → dist/chunk-NI3MQCAS.js}

@@ -40,6 +40,23 @@ function validateConfig(config) {
     if (typeof cfg.test !== "object" || cfg.test === null) {
       errors.push("test must be an object");
     } else {
+      if (cfg.test.disableTimeouts !== void 0 && typeof cfg.test.disableTimeouts !== "boolean") {
+        errors.push("test.disableTimeouts must be a boolean when provided");
+      }
+      const testTimeoutFields = [
+        "actionTimeoutMs",
+        "assertionTimeoutMs",
+        "navigationTimeoutMs",
+        "componentReadyTimeoutMs"
+      ];
+      for (const field of testTimeoutFields) {
+        const value = cfg.test[field];
+        if (value !== void 0) {
+          if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+            errors.push(`test.${field} must be a non-negative number when provided`);
+          }
+        }
+      }
       if (cfg.test.components !== void 0) {
         if (!Array.isArray(cfg.test.components)) {
           errors.push("test.components must be an array");
@@ -60,6 +77,23 @@ function validateConfig(config) {
               if (comp.strictness !== void 0 && !["minimal", "balanced", "strict", "paranoid"].includes(comp.strictness)) {
                 errors.push(`test.components[${idx}].strictness must be one of: minimal, balanced, strict, paranoid`);
               }
+              if (comp.disableTimeouts !== void 0 && typeof comp.disableTimeouts !== "boolean") {
+                errors.push(`test.components[${idx}].disableTimeouts must be a boolean when provided`);
+              }
+              const componentTimeoutFields = [
+                "actionTimeoutMs",
+                "assertionTimeoutMs",
+                "navigationTimeoutMs",
+                "componentReadyTimeoutMs"
+              ];
+              for (const field of componentTimeoutFields) {
+                const value = comp[field];
+                if (value !== void 0) {
+                  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+                    errors.push(`test.components[${idx}].${field} must be a non-negative number when provided`);
+                  }
+                }
+              }
             }
           });
         }

package/{bin → dist}/cli.cjs

@@ -75,6 +75,23 @@ function validateConfig(config) {
     if (typeof cfg.test !== "object" || cfg.test === null) {
       errors.push("test must be an object");
     } else {
+      if (cfg.test.disableTimeouts !== void 0 && typeof cfg.test.disableTimeouts !== "boolean") {
+        errors.push("test.disableTimeouts must be a boolean when provided");
+      }
+      const testTimeoutFields = [
+        "actionTimeoutMs",
+        "assertionTimeoutMs",
+        "navigationTimeoutMs",
+        "componentReadyTimeoutMs"
+      ];
+      for (const field of testTimeoutFields) {
+        const value = cfg.test[field];
+        if (value !== void 0) {
+          if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+            errors.push(`test.${field} must be a non-negative number when provided`);
+          }
+        }
+      }
       if (cfg.test.components !== void 0) {
         if (!Array.isArray(cfg.test.components)) {
           errors.push("test.components must be an array");
@@ -95,6 +112,23 @@ function validateConfig(config) {
               if (comp.strictness !== void 0 && !["minimal", "balanced", "strict", "paranoid"].includes(comp.strictness)) {
                 errors.push(`test.components[${idx}].strictness must be one of: minimal, balanced, strict, paranoid`);
               }
+              if (comp.disableTimeouts !== void 0 && typeof comp.disableTimeouts !== "boolean") {
+                errors.push(`test.components[${idx}].disableTimeouts must be a boolean when provided`);
+              }
+              const componentTimeoutFields = [
+                "actionTimeoutMs",
+                "assertionTimeoutMs",
+                "navigationTimeoutMs",
+                "componentReadyTimeoutMs"
+              ];
+              for (const field of componentTimeoutFields) {
+                const value = comp[field];
+                if (value !== void 0) {
+                  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+                    errors.push(`test.components[${idx}].${field} must be a non-negative number when provided`);
+                  }
+                }
+              }
             }
           });
         }
@@ -1593,8 +1627,41 @@ var init_ActionExecutor = __esm({
       /**
        * Execute focus action
        */
-      async focus(target) {
+      /**
+       * Execute focus action (supports absolute, relative, and virtual focus)
+       * @param target - selector key (e.g. "input", "button", "relative", or "virtual")
+       * @param relativeTarget - for relative focus (e.g. "first", "last")
+       * @param virtualId - for virtual focus (aria-activedescendant value)
+       */
+      async focus(target, relativeTarget, virtualId) {
         try {
+          if (target === "virtual" && virtualId) {
+            const inputSelector = this.selectors.input;
+            if (!inputSelector) {
+              return { success: false, error: `Input selector not defined for virtual focus.` };
+            }
+            const input = this.page.locator(inputSelector).first();
+            const exists = await input.count();
+            if (!exists) {
+              return { success: false, error: `Input element not found for virtual focus.` };
+            }
+            await input.evaluate((el, id) => {
+              el.setAttribute("aria-activedescendant", id);
+            }, virtualId);
+            return { success: true };
+          }
+          if (target === "relative" && relativeTarget) {
+            const relativeSelector = this.selectors.relative;
+            if (!relativeSelector) {
+              return { success: false, error: `Relative selector not defined for focus action.` };
+            }
+            const element = await RelativeTargetResolver.resolve(this.page, relativeSelector, relativeTarget);
+            if (!element) {
+              return { success: false, error: `Could not resolve relative target ${relativeTarget} for focus.` };
+            }
+            await element.focus({ timeout: this.timeoutMs });
+            return { success: true };
+          }
           const selector = this.selectors[target];
           if (!selector) {
             return { success: false, error: `Selector for focus target ${target} not found.` };
@@ -1795,10 +1862,10 @@ var init_AssertionRunner = __esm({
       /**
        * Resolve the target element for an assertion
        */
-      async resolveTarget(targetName, relativeTarget) {
+      async resolveTarget(targetName, relativeTarget, selectorKey) {
         try {
           if (targetName === "relative") {
-            const relativeSelector = this.selectors.relative;
+            const relativeSelector = selectorKey ? this.selectors[selectorKey] : this.selectors.relative;
             if (!relativeSelector) {
               return { target: null, error: "Relative selector is not defined in the contract." };
             }
@@ -1985,10 +2052,30 @@ var init_AssertionRunner = __esm({
             failMessage: `CRITICAL: Browser/page closed before completing all tests. Increase test timeout or reduce test complexity.`
           };
         }
-        const { target, error } = await this.resolveTarget(assertion.target, assertion.relativeTarget || assertion.expectedValue);
+        const { target, error } = await this.resolveTarget(
+          assertion.target,
+          assertion.relativeTarget || assertion.expectedValue,
+          assertion.selectorKey
+        );
         if (error || !target) {
           return { success: false, failMessage: error || `Target ${assertion.target} not found.`, target: null };
         }
+        if (assertion.target === "input" && assertion.attribute === "aria-activedescendant" && assertion.expectedValue === "!empty" && assertion.relativeTarget && assertion.selectorKey) {
+          const optionLocator = await RelativeTargetResolver.resolve(this.page, this.selectors[assertion.selectorKey], assertion.relativeTarget);
+          const optionId = optionLocator ? await optionLocator.getAttribute("id") : null;
+          const inputId = await target.getAttribute("aria-activedescendant");
+          if (optionId && inputId === optionId) {
+            return {
+              success: true,
+              passMessage: `input[aria-activedescendant] matches id of ${assertion.relativeTarget}(${assertion.selectorKey}). Test: "${testDescription}".`
+            };
+          } else {
+            return {
+              success: false,
+              failMessage: `input[aria-activedescendant] should match id of ${assertion.relativeTarget}(${assertion.selectorKey}), found "${inputId}".`
+            };
+          }
+        }
         switch (assertion.assertion) {
           case "toBeVisible":
             return this.validateVisibility(target, assertion.target, true, assertion.failureMessage || "", testDescription);
@@ -2035,8 +2122,43 @@ async function runContractTestsPlaywright(componentName, url, strictness, config
   const componentConfig = config?.test?.components?.find((c) => c.name === componentName);
   const isCustomContract = !!componentConfig?.path;
   const reporter = new ContractReporter(true, isCustomContract);
-  const actionTimeoutMs = 400;
-  const assertionTimeoutMs = 400;
+  const defaultTimeouts = {
+    actionTimeoutMs: 400,
+    assertionTimeoutMs: 400,
+    navigationTimeoutMs: 3e4,
+    componentReadyTimeoutMs: 5e3
+  };
+  const globalDisableTimeouts = config?.test?.disableTimeouts === true;
+  const componentDisableTimeouts = componentConfig?.disableTimeouts === true;
+  const disableTimeouts = componentDisableTimeouts || globalDisableTimeouts;
+  const resolveTimeout = (componentValue, globalValue, fallback) => {
+    if (disableTimeouts) return 0;
+    const value = componentValue ?? globalValue;
+    if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+      return fallback;
+    }
+    return value;
+  };
+  const actionTimeoutMs = resolveTimeout(
+    componentConfig?.actionTimeoutMs,
+    config?.test?.actionTimeoutMs,
+    defaultTimeouts.actionTimeoutMs
+  );
+  const assertionTimeoutMs = resolveTimeout(
+    componentConfig?.assertionTimeoutMs,
+    config?.test?.assertionTimeoutMs,
+    defaultTimeouts.assertionTimeoutMs
+  );
+  const navigationTimeoutMs = resolveTimeout(
+    componentConfig?.navigationTimeoutMs,
+    config?.test?.navigationTimeoutMs,
+    defaultTimeouts.navigationTimeoutMs
+  );
+  const componentReadyTimeoutMs = resolveTimeout(
+    componentConfig?.componentReadyTimeoutMs,
+    config?.test?.componentReadyTimeoutMs,
+    defaultTimeouts.componentReadyTimeoutMs
+  );
   const strictnessMode = normalizeStrictness(strictness);
   let contractPath = componentConfig?.path;
   if (!contractPath) {
@@ -2094,7 +2216,7 @@ async function runContractTestsPlaywright(componentName, url, strictness, config
       try {
         await page.goto(url, {
           waitUntil: "domcontentloaded",
-          timeout: 3e4
+          timeout: navigationTimeoutMs
         });
       } catch (error) {
         throw new Error(
@@ -2112,7 +2234,7 @@ async function runContractTestsPlaywright(componentName, url, strictness, config
       throw new Error(`CRITICAL: No selector found in contract for ${componentName}`);
     }
     try {
-      await page.locator(mainSelector).first().waitFor({ state: "attached", timeout: 3e4 });
+      await page.locator(mainSelector).first().waitFor({ state: "attached", timeout: componentReadyTimeoutMs });
     } catch (error) {
       throw new Error(
         `
@@ -2126,18 +2248,26 @@ This usually means:
     }
     reporter.start(componentName, totalTests, apgUrl);
     if (componentName === "menu" && componentContract.selectors.trigger) {
-      await page.locator(componentContract.selectors.trigger).first().waitFor({
-        state: "attached",
-        timeout: 5e3
-      }).catch(() => {
+      await page.locator(componentContract.selectors.trigger).first().waitFor({ state: "attached", timeout: componentReadyTimeoutMs }).catch(() => {
       });
     }
     const hasSubmenuCapability = componentName === "menu" && !!componentContract.selectors.submenuTrigger ? await page.locator(componentContract.selectors.submenuTrigger).count() > 0 : false;
+    const isSubmenuRelation = (rel) => rel.type === "aria-reference" && [rel.from, rel.to].some((name) => ["submenu", "submenuTrigger", "submenuItems"].includes(name || "")) || rel.type === "contains" && [rel.parent, rel.child].some((name) => ["submenu", "submenuTrigger", "submenuItems"].includes(name || ""));
     let staticPassed = 0;
     let staticFailed = 0;
     let staticWarnings = 0;
     for (const rel of componentContract.relationships || []) {
       const relationshipLevel = normalizeLevel(rel.level);
+      if (componentName === "menu" && !hasSubmenuCapability) {
+        const involvesSubmenu = isSubmenuRelation(rel);
+        if (involvesSubmenu) {
+          const relDescription = rel.type === "aria-reference" ? `${rel.from}.${rel.attribute} references ${rel.to}` : `${rel.parent} contains ${rel.child}`;
+          const skipMessage = `Skipping submenu relationship assertion: no submenu capability detected in rendered component.`;
+          skipped.push(skipMessage);
+          reporter.reportStaticTest(relDescription, "skip", skipMessage, relationshipLevel);
+          continue;
+        }
+      }
       if (rel.type === "aria-reference") {
         const relDescription = `${rel.from}.${rel.attribute} references ${rel.to}`;
         const fromSelector = componentContract.selectors[rel.from];
@@ -2157,6 +2287,12 @@ This usually means:
         const fromExists = await fromTarget.count() > 0;
         const toExists = await toTarget.count() > 0;
         if (!fromExists || !toExists) {
+          if (componentName === "menu" && isSubmenuRelation(rel)) {
+            const skipMessage = "Skipping submenu relationship assertion in static phase: submenu elements are not present until submenu is opened.";
+            skipped.push(skipMessage);
+            reporter.reportStaticTest(relDescription, "skip", skipMessage, relationshipLevel);
+            continue;
+          }
           const outcome = classifyFailure(
             `Relationship target not found: ${!fromExists ? rel.from : rel.to}.`,
             rel.level
@@ -2212,6 +2348,12 @@ This usually means:
         const parent = page.locator(parentSelector).first();
         const parentExists = await parent.count() > 0;
         if (!parentExists) {
+          if (componentName === "menu" && isSubmenuRelation(rel)) {
+            const skipMessage = "Skipping submenu relationship assertion in static phase: submenu container is not present until submenu is opened.";
+            skipped.push(skipMessage);
+            reporter.reportStaticTest(relDescription, "skip", skipMessage, relationshipLevel);
+            continue;
+          }
           const outcome = classifyFailure(`Relationship parent target not found: ${rel.parent}.`, rel.level);
           if (outcome.status === "fail") staticFailed += 1;
           if (outcome.status === "warn") staticWarnings += 1;
@@ -2221,6 +2363,12 @@ This usually means:
         const descendants = parent.locator(childSelector);
         const descendantCount = await descendants.count();
         if (descendantCount < 1) {
+          if (componentName === "menu" && isSubmenuRelation(rel)) {
+            const skipMessage = "Skipping submenu relationship assertion in static phase: submenu descendants are not present until submenu is opened.";
+            skipped.push(skipMessage);
+            reporter.reportStaticTest(relDescription, "skip", skipMessage, relationshipLevel);
+            continue;
+          }
           const outcome = classifyFailure(
             `Expected ${rel.parent} to contain descendant matching selector for ${rel.child}.`,
             rel.level
@@ -2344,11 +2492,6 @@ This usually means:
         failures.push(`CRITICAL: Browser/page closed before completing all tests. ${componentContract.dynamic.length - componentContract.dynamic.indexOf(dynamicTest)} tests skipped.`);
         break;
       }
-      const { action, assertions } = dynamicTest;
-      const failuresBeforeTest = failures.length;
-      const warningsBeforeTest = warnings.length;
-      const skippedBeforeTest = skipped.length;
-      const dynamicLevel = normalizeLevel(dynamicTest.level);
       try {
         await strategy.resetState(page);
       } catch (error) {
@@ -2356,6 +2499,40 @@ This usually means:
         reporter.error(errorMessage);
         throw error;
       }
+      const { setup = [], action, assertions } = dynamicTest;
+      const dynamicLevel = normalizeLevel(dynamicTest.level);
+      const actionExecutor = new ActionExecutor(page, componentContract.selectors, actionTimeoutMs);
+      if (Array.isArray(setup) && setup.length > 0) {
+        for (const setupAct of setup) {
+          let setupResult;
+          if (setupAct.type === "focus") {
+            if (setupAct.target === "relative" && setupAct.relativeTarget) {
+              setupResult = await actionExecutor.focus("relative", setupAct.relativeTarget);
+            } else {
+              setupResult = await actionExecutor.focus(setupAct.target);
+            }
+          } else if (setupAct.type === "type" && setupAct.value) {
+            setupResult = await actionExecutor.type(setupAct.target, setupAct.value);
+          } else if (setupAct.type === "click") {
+            setupResult = await actionExecutor.click(setupAct.target, setupAct.relativeTarget);
+          } else if (setupAct.type === "keypress" && setupAct.key) {
+            setupResult = await actionExecutor.keypress(setupAct.target, setupAct.key);
+          } else if (setupAct.type === "hover") {
+            setupResult = await actionExecutor.hover(setupAct.target, setupAct.relativeTarget);
+          } else {
+            continue;
+          }
+          if (!setupResult.success) {
+            const setupMsg = setupResult.error || "Setup action failed";
+            const outcome = classifyFailure(`Setup failed: ${setupMsg}`, dynamicTest.level);
+            reporter.reportTest({ description: dynamicTest.description, level: dynamicLevel }, outcome.status, outcome.detail);
+            continue;
+          }
+        }
+      }
+      const failuresBeforeTest = failures.length;
+      const warningsBeforeTest = warnings.length;
+      const skippedBeforeTest = skipped.length;
       const shouldSkipTest = await strategy.shouldSkipTest(dynamicTest, page);
       if (shouldSkipTest) {
         const skipMessage = `Skipping test - component-specific conditions not met`;
@@ -2363,7 +2540,6 @@ This usually means:
         reporter.reportTest({ description: dynamicTest.description, level: dynamicLevel }, "skip", skipMessage);
         continue;
       }
-      const actionExecutor = new ActionExecutor(page, componentContract.selectors, actionTimeoutMs);
       const assertionRunner = new AssertionRunner(page, componentContract.selectors, assertionTimeoutMs);
       let shouldAbortCurrentTest = false;
       let actionOutcome = null;
@@ -2375,7 +2551,11 @@ This usually means:
         }
         let result;
         if (act.type === "focus") {
-          result = await actionExecutor.focus(act.target);
+          if (act.target === "relative" && act.relativeTarget) {
+            result = await actionExecutor.focus("relative", act.relativeTarget);
+          } else {
+            result = await actionExecutor.focus(act.target);
+          }
         } else if (act.type === "type" && act.value) {
           result = await actionExecutor.type(act.target, act.value);
         } else if (act.type === "click") {
@@ -2453,7 +2633,14 @@ This usually means:
 Make sure your dev server is running at ${url}`);
       } else if (error.message.includes("Timeout") && error.message.includes("waitFor")) {
         throw new Error(
-          "\n\u274C CRITICAL: Component not found on page!\nThe component selector could not be found within 30 seconds.\nThis usually means:\n  - The component didn't render\n  - The URL is incorrect\n  - The component selector was not provided to the component utility, or a wrong selector was used\n"
+          `
+\u274C CRITICAL: Component not found on page!
+The component selector could not be found within ${componentReadyTimeoutMs}ms.
+This usually means:
+  - The component didn't render
+  - The URL is incorrect
+  - The component selector was not provided to the component utility, or a wrong selector was used
+`
         );
       } else if (error.message.includes("Target page, context or browser has been closed")) {
         throw new Error(
@@ -2678,7 +2865,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") {
@@ -2886,6 +3073,25 @@ function validateContractSchema(contract) {
       });
     }
   }
+  if (c.states !== void 0) {
+    if (!Array.isArray(c.states)) {
+      errors.push({ path: "$.states", message: "states must be an array" });
+    } else {
+      c.states.forEach((state, idx) => {
+        if (typeof state !== "object" || state === null) {
+          errors.push({ path: `$.states[${idx}]`, message: "state must be an object" });
+          return;
+        }
+        const s = state;
+        if (typeof s.name !== "string") {
+          errors.push({ path: `$.states[${idx}].name`, message: "name is required and must be a string" });
+        }
+        if (!Array.isArray(s.requires)) {
+          errors.push({ path: `$.states[${idx}].requires`, message: "requires is required and must be an array" });
+        }
+      });
+    }
+  }
   return {
     valid: errors.length === 0,
     errors
@@ -2961,8 +3167,17 @@ function validateTargetReferences(contract, selectorKeys) {
     });
   }
   const dynamicItems = c.dynamic;
+  const states = c.states;
+  const stateNames = new Set((states || []).map((s) => String(s.name)));
   if (Array.isArray(dynamicItems)) {
     dynamicItems.forEach((item, itemIdx) => {
+      const given = item.given;
+      if (given && !stateNames.has(given)) {
+        errors.push({
+          path: `$.dynamic[${itemIdx}].given`,
+          message: `State '${given}' not found in states`
+        });
+      }
       const actions = item.action;
       if (Array.isArray(actions)) {
         actions.forEach((action, actIdx) => {
@@ -2992,12 +3207,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
@@ -3115,7 +3330,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-LMSKLN5O.js";
+} from "./chunk-NI3MQCAS.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-OND56UUL.js");
+  const { runTest } = await import("./test-O3J4ZPQR.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-GBOY7UXG.js");
-    const { loadConfig: loadConfig2 } = await import("./configLoader-Q6A4JLKW.js");
+    const { buildContracts } = await import("./buildContracts-FT6KWUJN.js");
+    const { loadConfig: loadConfig2 } = await import("./configLoader-UJZHQBYS.js");
     const cwd = process.cwd();
     const { config, configPath, errors } = await loadConfig2(cwd);
     if (configPath) {

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

@@ -42,6 +42,23 @@ function validateConfig(config) {
     if (typeof cfg.test !== "object" || cfg.test === null) {
       errors.push("test must be an object");
     } else {
+      if (cfg.test.disableTimeouts !== void 0 && typeof cfg.test.disableTimeouts !== "boolean") {
+        errors.push("test.disableTimeouts must be a boolean when provided");
+      }
+      const testTimeoutFields = [
+        "actionTimeoutMs",
+        "assertionTimeoutMs",
+        "navigationTimeoutMs",
+        "componentReadyTimeoutMs"
+      ];
+      for (const field of testTimeoutFields) {
+        const value = cfg.test[field];
+        if (value !== void 0) {
+          if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+            errors.push(`test.${field} must be a non-negative number when provided`);
+          }
+        }
+      }
       if (cfg.test.components !== void 0) {
         if (!Array.isArray(cfg.test.components)) {
           errors.push("test.components must be an array");
@@ -62,6 +79,23 @@ function validateConfig(config) {
               if (comp.strictness !== void 0 && !["minimal", "balanced", "strict", "paranoid"].includes(comp.strictness)) {
                 errors.push(`test.components[${idx}].strictness must be one of: minimal, balanced, strict, paranoid`);
               }
+              if (comp.disableTimeouts !== void 0 && typeof comp.disableTimeouts !== "boolean") {
+                errors.push(`test.components[${idx}].disableTimeouts must be a boolean when provided`);
+              }
+              const componentTimeoutFields = [
+                "actionTimeoutMs",
+                "assertionTimeoutMs",
+                "navigationTimeoutMs",
+                "componentReadyTimeoutMs"
+              ];
+              for (const field of componentTimeoutFields) {
+                const value = comp[field];
+                if (value !== void 0) {
+                  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+                    errors.push(`test.components[${idx}].${field} must be a non-negative number when provided`);
+                  }
+                }
+              }
             }
           });
         }

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

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