aria-ease 6.12.0 → 6.12.1

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

@@ -346,9 +346,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
     });
   }
@@ -709,7 +707,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;
@@ -720,18 +718,18 @@ var init_ComboboxComponentStrategy = __esm({
           const closeElement = page.locator(closeSelector).first();
           await closeElement.focus();
           await page.keyboard.press("Escape");
-          listBoxClosed = await test.expect(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
+          popupClosed = await test.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 test.expect(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
+          popupClosed = await test.expect(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
         }
-        if (!listBoxClosed) {
+        if (!popupClosed) {
           await page.mouse.click(10, 10);
-          listBoxClosed = await test.expect(popupElement).toBeHidden({ timeout: this.assertionTimeoutMs }).then(() => true).catch(() => false);
+          popupClosed = await test.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
@@ -939,6 +937,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"() {
@@ -1012,16 +1014,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 };
@@ -1319,6 +1321,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)) {
@@ -1751,6 +1757,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;
@@ -1793,6 +1845,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;
@@ -1826,16 +1894,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"
           );
@@ -1953,7 +2022,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) {
@@ -2287,7 +2382,7 @@ async function runContractTests(contractPath, componentName, component, strictne
           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;

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

@@ -1,4 +1,4 @@
-import { normalizeStrictness, closeSharedBrowser, ContractReporter, normalizeLevel, resolveEnforcement } from './chunk-FZ7GMIJB.js';
+import { normalizeStrictness, closeSharedBrowser, ContractReporter, normalizeLevel, resolveEnforcement } from './chunk-4DU5Z5BR.js';
 import { axe } from 'jest-axe';
 import fs from 'fs/promises';
 import path from 'path';
@@ -144,7 +144,7 @@ async function runContractTests(contractPath, componentName, component, strictne
           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;
@@ -228,7 +228,7 @@ Error: ${error instanceof Error ? error.message : String(error)}`
       const devServerUrl = await checkDevServer(url);
       if (devServerUrl) {
         console.log(`\u{1F3AD} Running Playwright tests on ${devServerUrl}`);
-        const { runContractTestsPlaywright } = await import('./contractTestRunnerPlaywright-CIZOXYRW.js');
+        const { runContractTestsPlaywright } = await import('./contractTestRunnerPlaywright-5FT6K2WN.js');
         contract = await runContractTestsPlaywright(componentName, devServerUrl, strictness, config, configBaseDir);
       } else {
         throw new Error(

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

@@ -4,7 +4,7 @@ import {
   normalizeLevel,
   normalizeStrictness,
   resolveEnforcement
-} from "./chunk-FZ7GMIJB.js";
+} from "./chunk-4DU5Z5BR.js";
 import "./chunk-I2KLQ2HA.js";
 
 // src/utils/test/src/test.ts
@@ -153,7 +153,7 @@ async function runContractTests(contractPath, componentName, component, strictne
           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;
@@ -240,7 +240,7 @@ Error: ${error instanceof Error ? error.message : String(error)}`
       const devServerUrl = await checkDevServer(url);
       if (devServerUrl) {
         console.log(`\u{1F3AD} Running Playwright tests on ${devServerUrl}`);
-        const { runContractTestsPlaywright } = await import("./contractTestRunnerPlaywright-EWAWQVHT.js");
+        const { runContractTestsPlaywright } = await import("./contractTestRunnerPlaywright-H24LQ45R.js");
         contract = await runContractTestsPlaywright(componentName, devServerUrl, strictness, config, configBaseDir);
       } else {
         throw new Error(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aria-ease",
-  "version": "6.12.0",
+  "version": "6.12.1",
   "description": "Accessibility infrastructure for the entire frontend engineering lifecycle. Build accessible patterns, run automated audits, verify component interactions, and gate deployments — all in one system.",
   "main": "dist/index.cjs",
   "type": "module",
@@ -46,7 +46,7 @@
   "bugs": {
     "url": "https://github.com/aria-ease/aria-ease/issues"
   },
-  "homepage": "https://ariaease.site/docs",
+  "homepage": "https://ariaease.site/",
   "devDependencies": {
     "@axe-core/playwright": "^4.11.0",
     "@playwright/test": "^1.57.0",