aria-ease 6.11.0 → 6.12.1

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   loadConfig
-} from "./chunk-NI3MQCAS.js";
+} from "./chunk-GJGUY643.js";
 import {
   displayBadgeInfo,
   promptAddBadge
@@ -17,7 +17,7 @@ var program = new Command();
 program.name("aria-ease").description("Run accessibility tests and audits").version("2.2.3");
 program.command("audit").description("Run axe-core powered accessibility audit on webpages").option("-u, --url <url>", "Single URL to audit").option("-f, --format <format>", "Output format for the audit report: json | csv | html | all", "all").option("-o, --out <path>", "Directory to save the audit report", "./accessibility-reports/audit").action(async (opts) => {
   console.log(chalk.cyanBright("\u{1F680} Starting accessibility audit...\n"));
-  const { runAudit } = await import("./audit-RM6TCZ5C.js");
+  const { runAudit } = await import("./audit-JYEPKLHR.js");
   const { formatResults } = await import("./formatters-32KQIIYS.js");
   const needsConfig = !opts.url;
   const { config, configPath, errors } = await loadConfig(process.cwd());
@@ -50,7 +50,7 @@ program.command("audit").description("Run axe-core powered accessibility audit o
     process.exit(1);
   }
   const allResults = [];
-  const { createAuditBrowser } = await import("./audit-RM6TCZ5C.js");
+  const { createAuditBrowser } = await import("./audit-JYEPKLHR.js");
   const browser = await createAuditBrowser();
   try {
     const auditOptions = { browser };
@@ -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-FYSJXQWO.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-FT6KWUJN.js");
-    const { loadConfig: loadConfig2 } = await import("./configLoader-UJZHQBYS.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/dist/{configLoader-UJZHQBYS.js → configLoader-REHK3S3Q.js}

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

package/dist/{contractTestRunnerPlaywright-QDXSK3FE.js → contractTestRunnerPlaywright-H24LQ45R.js}

@@ -1,11 +1,13 @@
+import {
+  RelativeTargetResolver
+} from "./chunk-GLT43UVH.js";
 import {
   ContractReporter,
-  contract_default,
   createTestPage,
   normalizeLevel,
   normalizeStrictness,
   resolveEnforcement
-} from "./chunk-XERMSYEH.js";
+} from "./chunk-4DU5Z5BR.js";
 import {
   test_exports
 } from "./chunk-PK5L2SAF.js";
@@ -45,7 +47,7 @@ var StrategyRegistry = class {
     );
     this.builtInStrategies.set(
       "combobox",
-      () => import("./ComboboxComponentStrategy-OGRVZXAF.js").then(
+      () => import("./ComboboxComponentStrategy-DU342VMB.js").then(
         (m) => m.ComboboxComponentStrategy
       )
     );
@@ -55,12 +57,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 +120,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 +153,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);
     }
@@ -174,46 +166,6 @@ var ComponentDetector = class {
   }
 };
 
-// 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;
-    }
-  }
-};
-
 // src/utils/test/src/ActionExecutor.ts
 var ActionExecutor = class {
   constructor(page, selectors, timeoutMs = 400) {
@@ -239,16 +191,16 @@ var ActionExecutor = class {
   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 };
@@ -542,6 +494,10 @@ var AssertionRunner = class {
         };
       }
     }
+    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)) {
@@ -709,7 +665,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 +705,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}`);
   }
@@ -972,6 +924,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;
@@ -1014,6 +1012,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;
@@ -1047,16 +1061,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"
           );
@@ -1174,7 +1189,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 import("./RelativeTargetResolver-DJAITO6D.js");
+            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) {

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

@@ -1,14 +1,16 @@
 import {
   ContractReporter,
-  contract_default,
   createTestPage,
   normalizeLevel,
   normalizeStrictness,
   resolveEnforcement
-} from "./chunk-XERMSYEH.js";
+} from "./chunk-4DU5Z5BR.js";
 import {
   test_exports
 } from "./chunk-PK5L2SAF.js";
+import {
+  RelativeTargetResolver
+} from "./chunk-GLT43UVH.js";
 import "./chunk-I2KLQ2HA.js";
 
 // src/utils/test/src/contractTestRunnerPlaywright.ts
@@ -45,7 +47,7 @@ var StrategyRegistry = class {
     );
     this.builtInStrategies.set(
       "combobox",
-      () => import("./ComboboxComponentStrategy-OGRVZXAF.js").then(
+      () => import("./ComboboxComponentStrategy-DU342VMB.js").then(
         (m) => m.ComboboxComponentStrategy
       )
     );
@@ -55,12 +57,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 +120,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 +153,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);
     }
@@ -174,46 +166,6 @@ var ComponentDetector = class {
   }
 };
 
-// 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;
-    }
-  }
-};
-
 // src/utils/test/src/ActionExecutor.ts
 var ActionExecutor = class {
   constructor(page, selectors, timeoutMs = 400) {
@@ -239,16 +191,16 @@ var ActionExecutor = class {
   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 };
@@ -542,6 +494,10 @@ var AssertionRunner = class {
         };
       }
     }
+    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)) {
@@ -709,7 +665,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 +705,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}`);
   }
@@ -972,6 +924,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;
@@ -1014,6 +1012,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;
@@ -1047,16 +1061,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"
           );
@@ -1174,7 +1189,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 import("./RelativeTargetResolver-DJAITO6D.js");
+            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) {