aria-ease 5.0.3 → 6.0.1

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

@@ -8,10 +8,15 @@ interface JestAxeResult {
  * 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)
+ * @param {string} url Optional URL to run full Playwright E2E tests. If omitted, uses isolated component testing with page.setContent()
  */
 
-declare function testUiComponent(componentName: string, component: HTMLElement, url?: string): Promise<JestAxeResult>;
+declare function testUiComponent(componentName: string, component: HTMLElement | null, url: string | null): Promise<JestAxeResult>;
 declare let runTest: () => Promise<void>;
+/**
+ * Cleanup function to close the shared Playwright browser
+ * Call this in afterAll() or after all tests complete
+ */
+declare function cleanupTests(): Promise<void>;
 
-export { runTest, testUiComponent };
+export { cleanupTests, runTest, testUiComponent };

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

@@ -8,10 +8,15 @@ interface JestAxeResult {
  * 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)
+ * @param {string} url Optional URL to run full Playwright E2E tests. If omitted, uses isolated component testing with page.setContent()
  */
 
-declare function testUiComponent(componentName: string, component: HTMLElement, url?: string): Promise<JestAxeResult>;
+declare function testUiComponent(componentName: string, component: HTMLElement | null, url: string | null): Promise<JestAxeResult>;
 declare let runTest: () => Promise<void>;
+/**
+ * Cleanup function to close the shared Playwright browser
+ * Call this in afterAll() or after all tests complete
+ */
+declare function cleanupTests(): Promise<void>;
 
-export { runTest, testUiComponent };
+export { cleanupTests, runTest, testUiComponent };

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

@@ -1,4 +1,4 @@
-import { ContractReporter, contract_default } from './chunk-TUWQNVQJ.js';
+import { closeSharedBrowser, ContractReporter, contract_default } from './chunk-7RMRFSJL.js';
 import { axe } from 'jest-axe';
 import fs from 'fs/promises';
 
@@ -67,56 +67,58 @@ async function testUiComponent(componentName, component, url) {
   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 && (!component || !(component instanceof HTMLElement))) {
+    throw new Error("\u274C testUiComponent requires either a valid component (HTMLElement) or a URL");
   }
   if (url && typeof url !== "string") {
     throw new Error("\u274C testUiComponent url parameter must be a string");
   }
   let results;
-  try {
-    results = await axe(component);
-  } catch (error) {
-    throw new Error(
-      `\u274C Axe accessibility scan failed
+  if (component) {
+    try {
+      results = await axe(component);
+    } catch (error) {
+      throw new Error(
+        `\u274C Axe accessibility scan failed
 Error: ${error instanceof Error ? error.message : String(error)}`
-    );
+      );
+    }
+  } else {
+    results = { violations: [] };
   }
-  async function checkDevServer(testUrl) {
-    const urlsToTry = testUrl ? [testUrl] : [
-      "http://localhost:5173",
-      "http://localhost:3000",
-      "http://localhost:8080",
-      "http://localhost:4173"
-    ];
-    for (const serverUrl of urlsToTry) {
-      try {
-        const response = await fetch(serverUrl, {
-          method: "HEAD",
-          signal: AbortSignal.timeout(1e3)
-        });
-        if (response.ok || response.status === 304) {
-          return serverUrl;
-        }
-      } catch {
-        return null;
+  async function checkDevServer(url2) {
+    try {
+      const response = await fetch(url2, {
+        method: "HEAD",
+        signal: AbortSignal.timeout(1e3)
+      });
+      if (response.ok || response.status === 304) {
+        return url2;
       }
+    } catch {
+      return null;
     }
     return null;
   }
   let contract;
   try {
-    const devServerUrl = await checkDevServer(url);
-    if (devServerUrl) {
-      console.log(`\u{1F3AD} Running Playwright E2E tests on ${devServerUrl}`);
-      const { runContractTestsPlaywright } = await import('./contractTestRunnerPlaywright-P5QZAIDR.js');
-      contract = await runContractTestsPlaywright(componentName, devServerUrl);
-    } else {
-      console.log(`\u{1F9EA} Running jsdom tests (limited event handling)`);
-      console.log(`\u26A0\uFE0F  No dev server detected. Some tests may be skipped.
-For full coverage start your dev server and provide a URL.
-`);
+    if (url) {
+      const devServerUrl = await checkDevServer(url);
+      if (devServerUrl) {
+        console.log(`\u{1F3AD} Running Playwright tests on ${devServerUrl}`);
+        const { runContractTestsPlaywright } = await import('./contractTestRunnerPlaywright-LJHY3AB4.js');
+        contract = await runContractTestsPlaywright(componentName, devServerUrl);
+      } else {
+        throw new Error(
+          `\u274C Dev server not running at ${url}
+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);
+    } else {
+      throw new Error("\u274C Either component or URL must be provided");
     }
   } catch (error) {
     if (error instanceof Error) {
@@ -182,5 +184,8 @@ if (typeof window === "undefined") {
     );
   };
 }
+async function cleanupTests() {
+  await closeSharedBrowser();
+}
 
-export { runTest, testUiComponent };
+export { cleanupTests, runTest, testUiComponent };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aria-ease",
-  "version": "5.0.3",
+  "version": "6.0.1",
   "description": "Out-of-the-box accessibility utility package to develop production ready applications.",
   "main": "dist/index.cjs",
   "type": "module",
@@ -126,11 +126,11 @@
   "dependencies": {
     "chalk": "^5.6.2",
     "commander": "^14.0.1",
-    "fs-extra": "^11.3.2",
-    "playwright": "^1.57.0"
+    "fs-extra": "^11.3.2"
   },
   "peerDependencies": {
-    "@axe-core/playwright": "^4.10.2"
+    "@axe-core/playwright": "^4.10.2",
+    "playwright": "^1.57.0"
   },
   "peerDependenciesMeta": {
     "@axe-core/playwright": {