aria-ease 3.0.1 → 3.0.3

package/dist/src/utils/test/{contractTestRunnerPlaywright-LGXSV2ZS.js → contractTestRunnerPlaywright-4UOHWGWD.js}

@@ -1,7 +1,15 @@
-import { ContractReporter, contract_default } from './chunk-57O4KFP4.js';
+import { __export, __reExport, ContractReporter, contract_default } from './chunk-IPJYOFRK.js';
 import { chromium } from 'playwright';
+import * as default2 from 'playwright/test';
+import default2__default from 'playwright/test';
 import { readFileSync } from 'fs';
 
+// node_modules/@playwright/test/index.mjs
+var test_exports = {};
+__export(test_exports, {
+  default: () => default2__default
+});
+__reExport(test_exports, default2);
 async function runContractTestsPlaywright(componentName, url) {
   const reporter = new ContractReporter(true);
   const contractTyped = contract_default;
@@ -16,6 +24,7 @@ async function runContractTestsPlaywright(componentName, url) {
   reporter.start(componentName, totalTests);
   const failures = [];
   const passes = [];
+  const skipped = [];
   let browser = null;
   try {
     browser = await chromium.launch({ headless: true });
@@ -23,13 +32,25 @@ async function runContractTestsPlaywright(componentName, url) {
     const page = await context.newPage();
     await page.goto(url, {
       waitUntil: "domcontentloaded",
-      timeout: 6e4
+      timeout: 9e4
     });
     const mainSelector = componentContract.selectors.trigger || componentContract.selectors.input || componentContract.selectors.container;
     if (!mainSelector) {
       throw new Error(`No main selector (trigger, input, or container) found in contract for ${componentName}`);
     }
-    await page.waitForSelector(mainSelector, { timeout: 6e4 });
+    await page.waitForSelector(mainSelector, { timeout: 9e4 });
+    if (componentName === "menu" && componentContract.selectors.trigger) {
+      await page.waitForFunction(
+        (selector) => {
+          const trigger = document.querySelector(selector);
+          return trigger && trigger.getAttribute("data-menu-initialized") === "true";
+        },
+        componentContract.selectors.trigger,
+        { timeout: 6e3 }
+      ).catch(() => {
+        console.warn("Menu initialization signal not detected, continuing with tests...");
+      });
+    }
     async function resolveRelativeTarget(selector, relative) {
       const items = await page.locator(selector).all();
       switch (relative) {
@@ -115,7 +136,7 @@ async function runContractTestsPlaywright(componentName, url) {
             if (componentContract.selectors.input) {
               const inputElement = page.locator(componentContract.selectors.input).first();
               await inputElement.clear();
-              await page.waitForTimeout(50);
+              await page.waitForTimeout(100);
             }
           }
         }
@@ -128,7 +149,7 @@ async function runContractTestsPlaywright(componentName, url) {
             continue;
           }
           await page.locator(focusSelector).first().focus();
-          await page.waitForTimeout(50);
+          await page.waitForTimeout(100);
         }
         if (act.type === "type" && act.value) {
           const typeSelector = componentContract.selectors[act.target];
@@ -137,7 +158,7 @@ async function runContractTestsPlaywright(componentName, url) {
             continue;
           }
           await page.locator(typeSelector).first().fill(act.value);
-          await page.waitForTimeout(50);
+          await page.waitForTimeout(100);
         }
         if (act.type === "click") {
           if (act.target === "document") {
@@ -154,7 +175,7 @@ async function runContractTestsPlaywright(componentName, url) {
               continue;
             }
             await relativeElement.click();
-            await page.waitForTimeout(200);
+            await page.waitForTimeout(componentName === "menu" ? 500 : 200);
           } else {
             const actionSelector = componentContract.selectors[act.target];
             if (!actionSelector) {
@@ -162,7 +183,7 @@ async function runContractTestsPlaywright(componentName, url) {
               continue;
             }
             await page.locator(actionSelector).first().click();
-            await page.waitForTimeout(200);
+            await page.waitForTimeout(componentName === "menu" ? 500 : 200);
           }
         }
         if (act.type === "keypress" && act.key) {
@@ -187,7 +208,7 @@ async function runContractTestsPlaywright(componentName, url) {
           if (act.target === "focusable" && ["ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Escape"].includes(keyValue)) {
             await page.waitForTimeout(100);
             await page.keyboard.press(keyValue);
-            await page.waitForTimeout(50);
+            await page.waitForTimeout(100);
           } else {
             const keypressSelector = componentContract.selectors[act.target];
             if (!keypressSelector) {
@@ -216,7 +237,7 @@ async function runContractTestsPlaywright(componentName, url) {
               continue;
             }
             await relativeElement.hover();
-            await page.waitForTimeout(50);
+            await page.waitForTimeout(100);
           } else {
             const hoverSelector = componentContract.selectors[act.target];
             if (!hoverSelector) {
@@ -224,7 +245,7 @@ async function runContractTestsPlaywright(componentName, url) {
               continue;
             }
             await page.locator(hoverSelector).first().hover();
-            await page.waitForTimeout(50);
+            await page.waitForTimeout(100);
           }
         }
         await page.waitForTimeout(100);
@@ -256,32 +277,48 @@ async function runContractTestsPlaywright(componentName, url) {
           continue;
         }
         if (assertion.assertion === "toBeVisible") {
-          const isVisible = await target.isVisible();
-          if (isVisible) {
+          try {
+            await (0, test_exports.expect)(target).toBeVisible({ timeout: 3e3 });
             passes.push(`${assertion.target} is visible as expected. Test: "${dynamicTest.description}".`);
-          } else {
-            failures.push(`${assertion.failureMessage}`);
+          } catch {
+            const debugState = await page.evaluate((sel) => {
+              const el = sel ? document.querySelector(sel) : null;
+              if (!el) return "element not found";
+              const styles = window.getComputedStyle(el);
+              return `display:${styles.display}, visibility:${styles.visibility}, opacity:${styles.opacity}`;
+            }, componentContract.selectors[assertion.target] || "");
+            failures.push(`${assertion.failureMessage} (actual: ${debugState})`);
           }
         }
         if (assertion.assertion === "notToBeVisible") {
-          const isVisible = await target.isVisible();
-          if (!isVisible) {
+          try {
+            await (0, test_exports.expect)(target).toBeHidden({ timeout: 5e3 });
             passes.push(`${assertion.target} is not visible as expected. Test: "${dynamicTest.description}".`);
-          } else {
-            failures.push(assertion.failureMessage + ` ${assertion.target} is still visible.`);
+          } catch {
+            const debugState = await page.evaluate((sel) => {
+              const el = sel ? document.querySelector(sel) : null;
+              if (!el) return "element not found";
+              const styles = window.getComputedStyle(el);
+              return `display:${styles.display}, visibility:${styles.visibility}, opacity:${styles.opacity}`;
+            }, componentContract.selectors[assertion.target] || "");
+            failures.push(assertion.failureMessage + ` ${assertion.target} is still visible (actual: ${debugState}).`);
           }
         }
         if (assertion.assertion === "toHaveAttribute" && assertion.attribute && assertion.expectedValue) {
-          const attributeValue = await target.getAttribute(assertion.attribute);
-          if (assertion.expectedValue === "!empty") {
-            if (attributeValue && attributeValue.trim() !== "") {
-              passes.push(`${assertion.target} has non-empty "${assertion.attribute}". Test: "${dynamicTest.description}".`);
+          try {
+            if (assertion.expectedValue === "!empty") {
+              const attributeValue = await target.getAttribute(assertion.attribute);
+              if (attributeValue && attributeValue.trim() !== "") {
+                passes.push(`${assertion.target} has non-empty "${assertion.attribute}". Test: "${dynamicTest.description}".`);
+              } else {
+                failures.push(assertion.failureMessage + ` ${assertion.target} "${assertion.attribute}" should not be empty, found "${attributeValue}".`);
+              }
             } else {
-              failures.push(assertion.failureMessage + ` ${assertion.target} "${assertion.attribute}" should not be empty, found "${attributeValue}".`);
+              await (0, test_exports.expect)(target).toHaveAttribute(assertion.attribute, assertion.expectedValue, { timeout: 3e3 });
+              passes.push(`${assertion.target} has expected "${assertion.attribute}". Test: "${dynamicTest.description}".`);
             }
-          } else if (attributeValue === assertion.expectedValue) {
-            passes.push(`${assertion.target} has expected "${assertion.attribute}". Test: "${dynamicTest.description}".`);
-          } else {
+          } catch {
+            const attributeValue = await target.getAttribute(assertion.attribute);
             failures.push(assertion.failureMessage + ` ${assertion.target} "${assertion.attribute}" should be "${assertion.expectedValue}", found "${attributeValue}".`);
           }
         }
@@ -306,10 +343,10 @@ async function runContractTestsPlaywright(componentName, url) {
           }
         }
         if (assertion.assertion === "toHaveFocus") {
-          const hasFocus = await target.evaluate((el) => el === document.activeElement);
-          if (hasFocus) {
+          try {
+            await (0, test_exports.expect)(target).toBeFocused({ timeout: 5e3 });
             passes.push(`${assertion.target} has focus as expected. Test: "${dynamicTest.description}".`);
-          } else {
+          } catch {
             failures.push(`${assertion.failureMessage}`);
           }
         }
@@ -350,7 +387,7 @@ async function runContractTestsPlaywright(componentName, url) {
   } finally {
     if (browser) await browser.close();
   }
-  return { passes, failures };
+  return { passes, failures, skipped };
 }
 
 export { runContractTestsPlaywright };

package/dist/src/utils/test/contracts/MenuContract.json

@@ -115,6 +115,7 @@
         {
             "description": "Pressing Enter key on trigger opens the menu and focuses first item.",
             "action": [
+                { "type": "focus", "target": "trigger" },
                 { "type": "keypress", "target": "trigger", "key": "Enter" }
             ],
             "assertions": [

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

@@ -1,5 +1,6 @@
 'use strict';
 
+var default2 = require('playwright/test');
 var playwright = require('playwright');
 var fs = require('fs');
 var jestAxe = require('jest-axe');
@@ -8,6 +9,25 @@ var fs$1 = require('fs/promises');
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var default2__namespace = /*#__PURE__*/_interopNamespace(default2);
 var fs__default = /*#__PURE__*/_interopDefault(fs$1);
 
 var __create = Object.create;
@@ -34,6 +54,7 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget);
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
   // If the importer is in node compatibility mode or this is not an ESM
   // file that has been converted to a CommonJS file using a Babel-
@@ -9237,6 +9258,17 @@ ${"\u2550".repeat(60)}`);
   }
 });
 
+// node_modules/@playwright/test/index.mjs
+var test_exports = {};
+__export(test_exports, {
+  default: () => default2__namespace.default
+});
+var init_test = __esm({
+  "node_modules/@playwright/test/index.mjs"() {
+    __reExport(test_exports, default2__namespace);
+  }
+});
+
 // src/utils/test/contract/contractTestRunnerPlaywright.ts
 var contractTestRunnerPlaywright_exports = {};
 __export(contractTestRunnerPlaywright_exports, {
@@ -9256,6 +9288,7 @@ async function runContractTestsPlaywright(componentName, url) {
   reporter.start(componentName, totalTests);
   const failures = [];
   const passes = [];
+  const skipped = [];
   let browser = null;
   try {
     browser = await playwright.chromium.launch({ headless: true });
@@ -9263,13 +9296,25 @@ async function runContractTestsPlaywright(componentName, url) {
     const page = await context.newPage();
     await page.goto(url, {
       waitUntil: "domcontentloaded",
-      timeout: 6e4
+      timeout: 9e4
     });
     const mainSelector = componentContract.selectors.trigger || componentContract.selectors.input || componentContract.selectors.container;
     if (!mainSelector) {
       throw new Error(`No main selector (trigger, input, or container) found in contract for ${componentName}`);
     }
-    await page.waitForSelector(mainSelector, { timeout: 6e4 });
+    await page.waitForSelector(mainSelector, { timeout: 9e4 });
+    if (componentName === "menu" && componentContract.selectors.trigger) {
+      await page.waitForFunction(
+        (selector) => {
+          const trigger = document.querySelector(selector);
+          return trigger && trigger.getAttribute("data-menu-initialized") === "true";
+        },
+        componentContract.selectors.trigger,
+        { timeout: 6e3 }
+      ).catch(() => {
+        console.warn("Menu initialization signal not detected, continuing with tests...");
+      });
+    }
     async function resolveRelativeTarget(selector, relative) {
       const items = await page.locator(selector).all();
       switch (relative) {
@@ -9355,7 +9400,7 @@ async function runContractTestsPlaywright(componentName, url) {
             if (componentContract.selectors.input) {
               const inputElement = page.locator(componentContract.selectors.input).first();
               await inputElement.clear();
-              await page.waitForTimeout(50);
+              await page.waitForTimeout(100);
             }
           }
         }
@@ -9368,7 +9413,7 @@ async function runContractTestsPlaywright(componentName, url) {
             continue;
           }
           await page.locator(focusSelector).first().focus();
-          await page.waitForTimeout(50);
+          await page.waitForTimeout(100);
         }
         if (act.type === "type" && act.value) {
           const typeSelector = componentContract.selectors[act.target];
@@ -9377,7 +9422,7 @@ async function runContractTestsPlaywright(componentName, url) {
             continue;
           }
           await page.locator(typeSelector).first().fill(act.value);
-          await page.waitForTimeout(50);
+          await page.waitForTimeout(100);
         }
         if (act.type === "click") {
           if (act.target === "document") {
@@ -9394,7 +9439,7 @@ async function runContractTestsPlaywright(componentName, url) {
               continue;
             }
             await relativeElement.click();
-            await page.waitForTimeout(200);
+            await page.waitForTimeout(componentName === "menu" ? 500 : 200);
           } else {
             const actionSelector = componentContract.selectors[act.target];
             if (!actionSelector) {
@@ -9402,7 +9447,7 @@ async function runContractTestsPlaywright(componentName, url) {
               continue;
             }
             await page.locator(actionSelector).first().click();
-            await page.waitForTimeout(200);
+            await page.waitForTimeout(componentName === "menu" ? 500 : 200);
           }
         }
         if (act.type === "keypress" && act.key) {
@@ -9427,7 +9472,7 @@ async function runContractTestsPlaywright(componentName, url) {
           if (act.target === "focusable" && ["ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Escape"].includes(keyValue)) {
             await page.waitForTimeout(100);
             await page.keyboard.press(keyValue);
-            await page.waitForTimeout(50);
+            await page.waitForTimeout(100);
           } else {
             const keypressSelector = componentContract.selectors[act.target];
             if (!keypressSelector) {
@@ -9456,7 +9501,7 @@ async function runContractTestsPlaywright(componentName, url) {
               continue;
             }
             await relativeElement.hover();
-            await page.waitForTimeout(50);
+            await page.waitForTimeout(100);
           } else {
             const hoverSelector = componentContract.selectors[act.target];
             if (!hoverSelector) {
@@ -9464,7 +9509,7 @@ async function runContractTestsPlaywright(componentName, url) {
               continue;
             }
             await page.locator(hoverSelector).first().hover();
-            await page.waitForTimeout(50);
+            await page.waitForTimeout(100);
           }
         }
         await page.waitForTimeout(100);
@@ -9496,32 +9541,48 @@ async function runContractTestsPlaywright(componentName, url) {
           continue;
         }
         if (assertion.assertion === "toBeVisible") {
-          const isVisible = await target.isVisible();
-          if (isVisible) {
+          try {
+            await (0, test_exports.expect)(target).toBeVisible({ timeout: 3e3 });
             passes.push(`${assertion.target} is visible as expected. Test: "${dynamicTest.description}".`);
-          } else {
-            failures.push(`${assertion.failureMessage}`);
+          } catch {
+            const debugState = await page.evaluate((sel) => {
+              const el = sel ? document.querySelector(sel) : null;
+              if (!el) return "element not found";
+              const styles = window.getComputedStyle(el);
+              return `display:${styles.display}, visibility:${styles.visibility}, opacity:${styles.opacity}`;
+            }, componentContract.selectors[assertion.target] || "");
+            failures.push(`${assertion.failureMessage} (actual: ${debugState})`);
           }
         }
         if (assertion.assertion === "notToBeVisible") {
-          const isVisible = await target.isVisible();
-          if (!isVisible) {
+          try {
+            await (0, test_exports.expect)(target).toBeHidden({ timeout: 5e3 });
             passes.push(`${assertion.target} is not visible as expected. Test: "${dynamicTest.description}".`);
-          } else {
-            failures.push(assertion.failureMessage + ` ${assertion.target} is still visible.`);
+          } catch {
+            const debugState = await page.evaluate((sel) => {
+              const el = sel ? document.querySelector(sel) : null;
+              if (!el) return "element not found";
+              const styles = window.getComputedStyle(el);
+              return `display:${styles.display}, visibility:${styles.visibility}, opacity:${styles.opacity}`;
+            }, componentContract.selectors[assertion.target] || "");
+            failures.push(assertion.failureMessage + ` ${assertion.target} is still visible (actual: ${debugState}).`);
           }
         }
         if (assertion.assertion === "toHaveAttribute" && assertion.attribute && assertion.expectedValue) {
-          const attributeValue = await target.getAttribute(assertion.attribute);
-          if (assertion.expectedValue === "!empty") {
-            if (attributeValue && attributeValue.trim() !== "") {
-              passes.push(`${assertion.target} has non-empty "${assertion.attribute}". Test: "${dynamicTest.description}".`);
+          try {
+            if (assertion.expectedValue === "!empty") {
+              const attributeValue = await target.getAttribute(assertion.attribute);
+              if (attributeValue && attributeValue.trim() !== "") {
+                passes.push(`${assertion.target} has non-empty "${assertion.attribute}". Test: "${dynamicTest.description}".`);
+              } else {
+                failures.push(assertion.failureMessage + ` ${assertion.target} "${assertion.attribute}" should not be empty, found "${attributeValue}".`);
+              }
             } else {
-              failures.push(assertion.failureMessage + ` ${assertion.target} "${assertion.attribute}" should not be empty, found "${attributeValue}".`);
+              await (0, test_exports.expect)(target).toHaveAttribute(assertion.attribute, assertion.expectedValue, { timeout: 3e3 });
+              passes.push(`${assertion.target} has expected "${assertion.attribute}". Test: "${dynamicTest.description}".`);
             }
-          } else if (attributeValue === assertion.expectedValue) {
-            passes.push(`${assertion.target} has expected "${assertion.attribute}". Test: "${dynamicTest.description}".`);
-          } else {
+          } catch {
+            const attributeValue = await target.getAttribute(assertion.attribute);
             failures.push(assertion.failureMessage + ` ${assertion.target} "${assertion.attribute}" should be "${assertion.expectedValue}", found "${attributeValue}".`);
           }
         }
@@ -9546,10 +9607,10 @@ async function runContractTestsPlaywright(componentName, url) {
           }
         }
         if (assertion.assertion === "toHaveFocus") {
-          const hasFocus = await target.evaluate((el) => el === document.activeElement);
-          if (hasFocus) {
+          try {
+            await (0, test_exports.expect)(target).toBeFocused({ timeout: 5e3 });
             passes.push(`${assertion.target} has focus as expected. Test: "${dynamicTest.description}".`);
-          } else {
+          } catch {
             failures.push(`${assertion.failureMessage}`);
           }
         }
@@ -9590,10 +9651,11 @@ async function runContractTestsPlaywright(componentName, url) {
   } finally {
     if (browser) await browser.close();
   }
-  return { passes, failures };
+  return { passes, failures, skipped };
 }
 var init_contractTestRunnerPlaywright = __esm({
   "src/utils/test/contract/contractTestRunnerPlaywright.ts"() {
+    init_test();
     init_contract();
     init_ContractReporter();
   }
@@ -13140,20 +13202,54 @@ async function runContractTests(componentName, component) {
   const staticFailed = 0;
   reporter.reportStatic(staticPassed, staticFailed);
   reporter.summary(failures);
-  return { passes, failures };
+  return { passes, failures, skipped };
 }
 
 // src/utils/test/src/test.ts
 async function testUiComponent(componentName, component, url) {
-  const results = await jestAxe.axe(component);
+  if (!componentName || typeof componentName !== "string") {
+    throw new Error("\u274C testUiComponent requires a valid componentName (string)");
+  }
+  if (!component || !(component instanceof HTMLElement)) {
+    throw new Error("\u274C testUiComponent requires a valid component (HTMLElement)");
+  }
+  if (url && typeof url !== "string") {
+    throw new Error("\u274C testUiComponent url parameter must be a string");
+  }
+  let results;
+  try {
+    results = await jestAxe.axe(component);
+  } catch (error) {
+    throw new Error(
+      `\u274C Axe accessibility scan failed
+Error: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
   let contract;
-  if (url) {
-    console.log(`\u{1F3AD} Running Playwright E2E tests on ${url}`);
-    const { runContractTestsPlaywright: runContractTestsPlaywright2 } = await Promise.resolve().then(() => (init_contractTestRunnerPlaywright(), contractTestRunnerPlaywright_exports));
-    contract = await runContractTestsPlaywright2(componentName, url);
-  } else {
-    console.log(`\u{1F9EA} Running jsdom tests (limited event handling)`);
-    contract = await runContractTests(componentName, component);
+  try {
+    if (url) {
+      console.log(`\u{1F3AD} Running Playwright E2E tests on ${url}`);
+      try {
+        new URL(url);
+      } catch {
+        throw new Error(
+          `\u274C Invalid URL format: "${url}"
+URL must include protocol (e.g., "http://localhost:5173/test")`
+        );
+      }
+      const { runContractTestsPlaywright: runContractTestsPlaywright2 } = await Promise.resolve().then(() => (init_contractTestRunnerPlaywright(), contractTestRunnerPlaywright_exports));
+      contract = await runContractTestsPlaywright2(componentName, url);
+    } else {
+      console.log(`\u{1F9EA} Running jsdom tests (limited event handling)`);
+      console.log(`Some tests may be skipped or yield false positives/negatives.
+For full coverage, run with a URL to enable Playwright E2E tests.`);
+      contract = await runContractTests(componentName, component);
+    }
+  } catch (error) {
+    if (error instanceof Error) {
+      throw error;
+    }
+    throw new Error(`\u274C Contract test execution failed: ${String(error)}`);
   }
   const result = {
     violations: results.violations,
@@ -13164,10 +13260,11 @@ async function testUiComponent(componentName, component, url) {
     const mode = url ? "Playwright" : "jsdom";
     throw new Error(
       `
-\u274C ${contract.failures.length} assertion${contract.failures.length > 1 ? "s" : ""} failed (${mode} mode)
-\u2705 ${contract.passes.length} assertion${contract.passes.length > 1 ? "s" : ""} passed
+\u274C ${contract.failures.length} accessibility contract test${contract.failures.length > 1 ? "s" : ""} failed (${mode} mode)
+\u2705 ${contract.passes.length} test${contract.passes.length > 1 ? "s" : ""} passed
 
-\u{1F4CB} Review the detailed test report above for specific failures.`
+\u{1F4CB} Review the detailed test report above for specific failures.
+\u{1F4A1} Contract tests validate ARIA attributes and keyboard interactions per W3C APG guidelines.`
     );
   }
   if (results.violations.length > 0) {

package/dist/src/utils/test/index.d.cts

@@ -5,10 +5,11 @@ interface JestAxeResult {
 }
 
 /**
-    * Runs static and interactions accessibility test on UI components.
-    * @param {HTMLElement} component The UI component to be tested
-    * @param {string} url Optional URL to run full Playwright E2E tests (requires dev server running)
-*/
+ * Runs static and interactions accessibility test on UI components.
+ * @param {string} componentName The name of the component contract to test against
+ * @param {HTMLElement} component The UI component to be tested
+ * @param {string} url Optional URL to run full Playwright E2E tests (requires dev server running)
+ */
 
 declare function testUiComponent(componentName: string, component: HTMLElement, url?: string): Promise<JestAxeResult>;
 declare let runTest: () => Promise<void>;

package/dist/src/utils/test/index.d.ts

@@ -5,10 +5,11 @@ interface JestAxeResult {
 }
 
 /**
-    * Runs static and interactions accessibility test on UI components.
-    * @param {HTMLElement} component The UI component to be tested
-    * @param {string} url Optional URL to run full Playwright E2E tests (requires dev server running)
-*/
+ * Runs static and interactions accessibility test on UI components.
+ * @param {string} componentName The name of the component contract to test against
+ * @param {HTMLElement} component The UI component to be tested
+ * @param {string} url Optional URL to run full Playwright E2E tests (requires dev server running)
+ */
 
 declare function testUiComponent(componentName: string, component: HTMLElement, url?: string): Promise<JestAxeResult>;
 declare let runTest: () => Promise<void>;