aria-ease 6.11.0 → 6.12.1

package/README.md

@@ -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",
       },
@@ -1000,7 +1000,7 @@ export default {
   audit: {
     urls: [
       "http://localhost:5173", // Homepage
-      "http://localhost:5173/docs", // Docs
+      "http://localhost:5173/getting-started", // Docs
       "http://localhost:5173/examples", // Examples
     ],
     output: {
@@ -1130,7 +1130,7 @@ You've shifted accessibility left (into development), automated the verification
 
 ## 📖 More Resources
 
-- [Full Documentation](https://ariaease.site/docs)
+- [Full Documentation](https://ariaease.site/getting-started)
 - [GitHub Repository](https://github.com/aria-ease/aria-ease)
 - [Report Issues](https://github.com/aria-ease/aria-ease/issues)
 - [Contributing Guide](https://github.com/aria-ease/aria-ease/blob/main/CONTRIBUTION-GUIDELINES.md)

package/dist/{ComboboxComponentStrategy-OGRVZXAF.js → ComboboxComponentStrategy-DU342VMB.js}

@@ -17,7 +17,7 @@ var ComboboxComponentStrategy = class {
     const popupElement = page.locator(popupSelector).first();
     const isPopupVisible = await popupElement.isVisible().catch(() => false);
     if (!isPopupVisible) return;
-    let listBoxClosed = false;
+    let popupClosed = false;
     let closeSelector = this.selectors.input;
     if (!closeSelector && this.selectors.focusable) {
       closeSelector = this.selectors.focusable;
@@ -28,18 +28,18 @@ var ComboboxComponentStrategy = class {
       const closeElement = page.locator(closeSelector).first();
       await closeElement.focus();
       await page.keyboard.press("Escape");
-      listBoxClosed = await (0, test_exports.expect)(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
+      popupClosed = await (0, test_exports.expect)(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
     }
-    if (!listBoxClosed && this.selectors.button) {
+    if (!popupClosed && this.selectors.button) {
       const buttonElement = page.locator(this.selectors.button).first();
       await buttonElement.click({ timeout: this.actionTimeoutMs });
-      listBoxClosed = await (0, test_exports.expect)(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
+      popupClosed = await (0, test_exports.expect)(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
     }
-    if (!listBoxClosed) {
+    if (!popupClosed) {
       await page.mouse.click(10, 10);
-      listBoxClosed = await (0, test_exports.expect)(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
+      popupClosed = await (0, test_exports.expect)(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
     }
-    if (!listBoxClosed) {
+    if (!popupClosed) {
       throw new Error(
         `\u274C FATAL: Cannot close combobox popup between tests. Popup remains visible after trying:
   1. Escape key

package/dist/RelativeTargetResolver-DJAITO6D.js

@@ -0,0 +1,7 @@
+import {
+  RelativeTargetResolver
+} from "./chunk-GLT43UVH.js";
+import "./chunk-I2KLQ2HA.js";
+export {
+  RelativeTargetResolver
+};

package/dist/{audit-RM6TCZ5C.js → audit-JYEPKLHR.js}

@@ -19,6 +19,11 @@ async function runAudit(url, options) {
     const context = await browser.newContext();
     const page = await context.newPage();
     await page.goto(url, { waitUntil, timeout });
+    try {
+      await page.waitForSelector("main", { state: "visible", timeout });
+    } catch (waitError) {
+      console.warn(`\u26A0\uFE0F  Warning: <main> landmark not found or not visible on ${url} after ${timeout}ms. Audit will continue, but results may be inaccurate. Consider adding a <main> element to improve audit accuracy. ${waitError instanceof Error ? waitError.message : String(waitError)}`);
+    }
     const axe = new AxeBuilder({ page });
     const axeResults = await axe.analyze();
     await page.close();

package/dist/{chunk-XERMSYEH.js → chunk-4DU5Z5BR.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;
@@ -329,9 +309,7 @@ async function getOrCreateContext() {
   if (!sharedContext) {
     const browser = await getOrCreateBrowser();
     sharedContext = await browser.newContext({
-      // Isolated context - no permissions, no geolocation, etc.
       permissions: [],
-      // Ignore HTTPS errors for local dev servers
       ignoreHTTPSErrors: true
     });
   }
@@ -353,7 +331,6 @@ async function closeSharedBrowser() {
 }
 
 export {
-  contract_default,
   ContractReporter,
   normalizeLevel,
   normalizeStrictness,

package/dist/{chunk-NI3MQCAS.js → 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/dist/chunk-GLT43UVH.js

@@ -0,0 +1,43 @@
+// src/utils/test/src/RelativeTargetResolver.ts
+var RelativeTargetResolver = class {
+  /**
+   * Resolve a relative target like "first", "second", "last", "next", "previous"
+   * @param page Playwright page instance
+   * @param selector Base selector to find elements
+   * @param relative Relative position (first, second, last, next, previous)
+   * @returns The resolved Locator or null if not found
+   */
+  static async resolve(page, selector, relative) {
+    const items = await page.locator(selector).all();
+    switch (relative) {
+      case "first":
+        return items[0];
+      case "second":
+        return items[1];
+      case "last":
+        return items[items.length - 1];
+      case "next": {
+        const currentIndex = await page.evaluate(([sel]) => {
+          const items2 = Array.from(document.querySelectorAll(sel));
+          return items2.indexOf(document.activeElement);
+        }, [selector]);
+        const nextIndex = (currentIndex + 1) % items.length;
+        return items[nextIndex];
+      }
+      case "previous": {
+        const currentIndex = await page.evaluate(([sel]) => {
+          const items2 = Array.from(document.querySelectorAll(sel));
+          return items2.indexOf(document.activeElement);
+        }, [selector]);
+        const prevIndex = (currentIndex - 1 + items.length) % items.length;
+        return items[prevIndex];
+      }
+      default:
+        return null;
+    }
+  }
+};
+
+export {
+  RelativeTargetResolver
+};

package/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`);
@@ -356,6 +356,11 @@ async function runAudit(url, options) {
     const context = await browser.newContext();
     const page = await context.newPage();
     await page.goto(url, { waitUntil, timeout });
+    try {
+      await page.waitForSelector("main", { state: "visible", timeout });
+    } catch (waitError) {
+      console.warn(`\u26A0\uFE0F  Warning: <main> landmark not found or not visible on ${url} after ${timeout}ms. Audit will continue, but results may be inaccurate. Consider adding a <main> element to improve audit accuracy. ${waitError instanceof Error ? waitError.message : String(waitError)}`);
+    }
     const axe2 = new import_playwright.default({ page });
     const axeResults = await axe2.analyze();
     await page.close();
@@ -586,31 +591,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 +894,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);
@@ -1058,7 +1035,7 @@ async function runContractTests(componentName, component, strictness) {
           staticPassed += 1;
           reporter.reportStaticTest(`${test.target} has ${test.attribute}`, "pass", void 0, staticLevel);
         }
-      } else if (!attributeValue || !test.expectedValue.split(" | ").includes(attributeValue)) {
+      } else if (!attributeValue || typeof test.expectedValue === "string" && !test.expectedValue.split(" | ").includes(attributeValue)) {
         const outcome = classifyFailure(test.failureMessage + ` Attribute value does not match expected value. Expected: ${test.expectedValue}, Found: ${attributeValue}`, test.level);
         if (outcome.status === "fail") staticFailed += 1;
         if (outcome.status === "warn") staticWarnings += 1;
@@ -1078,15 +1055,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 = {};
   }
 });
 
@@ -1108,9 +1083,7 @@ async function getOrCreateContext() {
   if (!sharedContext) {
     const browser = await getOrCreateBrowser();
     sharedContext = await browser.newContext({
-      // Isolated context - no permissions, no geolocation, etc.
       permissions: [],
-      // Ignore HTTPS errors for local dev servers
       ignoreHTTPSErrors: true
     });
   }
@@ -1308,7 +1281,7 @@ var init_ComboboxComponentStrategy = __esm({
         const popupElement = page.locator(popupSelector).first();
         const isPopupVisible = await popupElement.isVisible().catch(() => false);
         if (!isPopupVisible) return;
-        let listBoxClosed = false;
+        let popupClosed = false;
         let closeSelector = this.selectors.input;
         if (!closeSelector && this.selectors.focusable) {
           closeSelector = this.selectors.focusable;
@@ -1319,18 +1292,18 @@ var init_ComboboxComponentStrategy = __esm({
           const closeElement = page.locator(closeSelector).first();
           await closeElement.focus();
           await page.keyboard.press("Escape");
-          listBoxClosed = await (0, test_exports.expect)(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
+          popupClosed = await (0, test_exports.expect)(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
         }
-        if (!listBoxClosed && this.selectors.button) {
+        if (!popupClosed && this.selectors.button) {
           const buttonElement = page.locator(this.selectors.button).first();
           await buttonElement.click({ timeout: this.actionTimeoutMs });
-          listBoxClosed = await (0, test_exports.expect)(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
+          popupClosed = await (0, test_exports.expect)(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
         }
-        if (!listBoxClosed) {
+        if (!popupClosed) {
           await page.mouse.click(10, 10);
-          listBoxClosed = await (0, test_exports.expect)(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
+          popupClosed = await (0, test_exports.expect)(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
         }
-        if (!listBoxClosed) {
+        if (!popupClosed) {
           throw new Error(
             `\u274C FATAL: Cannot close combobox popup between tests. Popup remains visible after trying:
   1. Escape key
@@ -1428,12 +1401,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 +1447,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 +1474,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 +1493,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 +1507,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);
         }
@@ -1561,6 +1523,10 @@ var init_ComponentDetector = __esm({
 });
 
 // src/utils/test/src/RelativeTargetResolver.ts
+var RelativeTargetResolver_exports = {};
+__export(RelativeTargetResolver_exports, {
+  RelativeTargetResolver: () => RelativeTargetResolver
+});
 var RelativeTargetResolver;
 var init_RelativeTargetResolver = __esm({
   "src/utils/test/src/RelativeTargetResolver.ts"() {
@@ -1636,16 +1602,16 @@ var init_ActionExecutor = __esm({
       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 mainSelector = this.selectors.main;
+            if (!mainSelector) {
+              return { success: false, error: `Main selector not defined for virtual focus.` };
             }
-            const input = this.page.locator(inputSelector).first();
-            const exists = await input.count();
+            const main = this.page.locator(mainSelector).first();
+            const exists = await main.count();
             if (!exists) {
-              return { success: false, error: `Input element not found for virtual focus.` };
+              return { success: false, error: `Main element not found for virtual focus.` };
             }
-            await input.evaluate((el, id) => {
+            await main.evaluate((el, id) => {
               el.setAttribute("aria-activedescendant", id);
             }, virtualId);
             return { success: true };
@@ -1947,6 +1913,10 @@ var init_AssertionRunner = __esm({
             };
           }
         }
+        if (typeof expectedValue !== "string") {
+          console.error("[AssertionRunner] expectedValue is not a string:", expectedValue);
+          throw new Error(`AssertionRunner: expectedValue for attribute assertion must be a string, but got: ${JSON.stringify(expectedValue)}`);
+        }
         const expectedValues = expectedValue.split(" | ").map((v) => v.trim());
         const attributeValue = await target.getAttribute(attribute);
         if (attributeValue !== null && expectedValues.includes(attributeValue)) {
@@ -2120,7 +2090,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 +2130,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 +2149,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");
@@ -2383,6 +2349,52 @@ This usually means:
         reporter.reportStaticTest(relDescription, "pass", void 0, relationshipLevel);
       }
     }
+    async function resolveExpectedValue(expectedValue, selectors, page2, context = {}) {
+      if (!expectedValue || typeof expectedValue !== "object" || !("ref" in expectedValue)) return expectedValue;
+      let refSelector;
+      if (expectedValue.ref === "relative") {
+        if (!expectedValue.relativeTarget || !context.relativeBaseSelector) return void 0;
+        const baseLocator = page2.locator(context.relativeBaseSelector);
+        const count = await baseLocator.count();
+        let idx = 0;
+        if (expectedValue.relativeTarget === "first") idx = 0;
+        else if (expectedValue.relativeTarget === "second") idx = 1;
+        else if (expectedValue.relativeTarget === "last") idx = count - 1;
+        else if (!isNaN(Number(expectedValue.relativeTarget))) idx = Number(expectedValue.relativeTarget);
+        else idx = 0;
+        if (idx < 0 || idx >= count) return void 0;
+        const relElem = baseLocator.nth(idx);
+        return await getPropertyFromLocator(relElem, expectedValue.property || expectedValue.attribute);
+      } else {
+        refSelector = selectors[expectedValue.ref];
+        if (!refSelector) throw new Error(`Selector for ref '${expectedValue.ref}' not found in contract selectors.`);
+        const refLocator = page2.locator(refSelector).first();
+        return await getPropertyFromLocator(refLocator, expectedValue.property || expectedValue.attribute);
+      }
+    }
+    async function getPropertyFromLocator(locator, property) {
+      if (!locator) return void 0;
+      if (!property || property === "id") {
+        return await locator.getAttribute("id") ?? void 0;
+      } else if (property === "class") {
+        return await locator.getAttribute("class") ?? void 0;
+      } else if (property === "textContent") {
+        return await locator.evaluate((el) => el.textContent ?? void 0);
+      } else if (property.startsWith("aria-")) {
+        return await locator.getAttribute(property) ?? void 0;
+      } else if (property.endsWith("*")) {
+        const attrs = await locator.evaluate((el) => {
+          const out = [];
+          for (const attr of Array.from(el.attributes)) {
+            if (attr.name.startsWith("aria-")) out.push(`${attr.name}=${attr.value}`);
+          }
+          return out.join(";");
+        });
+        return attrs;
+      } else {
+        return await locator.getAttribute(property) ?? void 0;
+      }
+    }
     const staticAssertionRunner = new AssertionRunner(page, componentContract.selectors, assertionTimeoutMs);
     for (const test of componentContract.static[0]?.assertions || []) {
       if (test.target === "relative") continue;
@@ -2425,6 +2437,22 @@ This usually means:
         }
         return false;
       };
+      let expectedValue = test.expectedValue;
+      if (test.expectedValue && typeof test.expectedValue === "object" && "ref" in test.expectedValue) {
+        const context = {};
+        const relTarget = test.relativeTarget;
+        if (test.expectedValue.ref === "relative" && test.target === "relative" && relTarget) {
+          const baseSel = componentContract.selectors[relTarget];
+          if (!baseSel) throw new Error(`Selector for relativeTarget '${relTarget}' not found in contract selectors.`);
+          context.relativeBaseSelector = baseSel;
+        } else if (test.expectedValue.ref === "relative" && relTarget) {
+          const baseSel = componentContract.selectors[relTarget];
+          if (!baseSel) throw new Error(`Selector for relativeTarget '${relTarget}' not found in contract selectors.`);
+          context.relativeBaseSelector = baseSel;
+        }
+        expectedValue = await resolveExpectedValue(test.expectedValue, componentContract.selectors, page, context);
+        console.log("Expected value in static check", expectedValue);
+      }
       if (!test.expectedValue) {
         const attributes = test.attribute.split(" | ");
         let hasAny = false;
@@ -2458,16 +2486,17 @@ This usually means:
           reporter.reportStaticTest(staticDescription, "pass", void 0, staticLevel);
         }
       } else {
-        if (isRedundantCheck(targetSelector, test.attribute, test.expectedValue)) {
-          passes.push(`${test.attribute}="${test.expectedValue}" on ${test.target} verified by selector (already present in: ${targetSelector}).`);
+        if (isRedundantCheck(targetSelector, test.attribute, typeof expectedValue === "string" ? expectedValue : void 0)) {
+          passes.push(`${test.attribute}="${expectedValue}" on ${test.target} verified by selector (already present in: ${targetSelector}).`);
           staticPassed += 1;
           reporter.reportStaticTest(staticDescription, "pass", void 0, staticLevel);
         } else {
+          const valueToCheck = expectedValue ?? "";
           const result = await staticAssertionRunner.validateAttribute(
             target,
             test.target,
             test.attribute,
-            test.expectedValue,
+            valueToCheck,
             test.failureMessage,
             "Static ARIA Test"
           );
@@ -2585,7 +2614,33 @@ This usually means:
         continue;
       }
       for (const assertion of assertions) {
-        const result = await assertionRunner.validate(assertion, dynamicTest.description);
+        let expectedValue;
+        if (assertion.expectedValue && typeof assertion.expectedValue === "object" && "ref" in assertion.expectedValue) {
+          if (assertion.expectedValue.ref === "relative") {
+            const { RelativeTargetResolver: RelativeTargetResolver2 } = await Promise.resolve().then(() => (init_RelativeTargetResolver(), RelativeTargetResolver_exports));
+            const relativeSelector = componentContract.selectors.relative;
+            if (!relativeSelector) throw new Error("Relative selector not defined in contract selectors.");
+            const relTarget = assertion.relativeTarget || "first";
+            const relElem = await RelativeTargetResolver2.resolve(page, relativeSelector, relTarget);
+            if (!relElem) throw new Error(`Could not resolve relative target '${relTarget}' for expectedValue.`);
+            const prop = assertion.expectedValue.property || assertion.expectedValue.attribute || "id";
+            if (prop === "textContent") {
+              expectedValue = await relElem.evaluate((el) => el.textContent ?? void 0);
+            } else {
+              const attr = await relElem.getAttribute(prop);
+              expectedValue = attr === null ? void 0 : attr;
+            }
+          } else {
+            expectedValue = await resolveExpectedValue(assertion.expectedValue, componentContract.selectors, page, {});
+          }
+        } else if (typeof assertion.expectedValue === "string" || typeof assertion.expectedValue === "undefined") {
+          expectedValue = assertion.expectedValue;
+        } else {
+          expectedValue = "";
+        }
+        const assertionToRun = { ...assertion, expectedValue };
+        const valueToCheck = expectedValue ?? "";
+        const result = await assertionRunner.validate({ ...assertionToRun, expectedValue: valueToCheck }, dynamicTest.description);
         if (result.success && result.passMessage) {
           passes.push(result.passMessage);
         } else if (!result.success && result.failMessage) {
@@ -2655,20 +2710,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 +2801,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");
     }