aria-ease 5.0.2 → 6.0.0

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

@@ -1,7 +1,7 @@
 'use strict';
 
-var default2 = require('playwright/test');
 var playwright = require('playwright');
+var test = require('@playwright/test');
 var fs = require('fs');
 var jestAxe = require('jest-axe');
 var fs$1 = require('fs/promises');
@@ -9,31 +9,10 @@ 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 __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __esm = (fn, res) => function __init() {
   return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
 };
@@ -41,15 +20,6 @@ var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
 };
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget);
 
 // src/utils/test/contract/contract.json
 var contract_default;
@@ -63,6 +33,10 @@ var init_contract = __esm({
       combobox: {
         path: "./contracts/ComboboxContract.json",
         component: "combobox"
+      },
+      accordion: {
+        path: "./contracts/AccordionContract.json",
+        component: "accordion"
       }
     };
   }
@@ -243,7 +217,7 @@ ${"\u2550".repeat(60)}`);
         } else if (totalFailures === 0) {
           this.log(`\u2705 ${totalPasses}/${totalRun} required tests passed`);
           if (this.skipped > 0) {
-            this.log(`\u25CB  ${this.skipped} tests skipped (jsdom limitation)`);
+            this.log(`\u25CB  ${this.skipped} tests skipped`);
           }
           if (this.optionalSuggestions > 0) {
             this.log(`\u{1F4A1} ${this.optionalSuggestions} optional enhancement${this.optionalSuggestions > 1 ? "s" : ""} suggested`);
@@ -293,15 +267,50 @@ ${"\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);
+async function getOrCreateBrowser() {
+  if (!sharedBrowser) {
+    sharedBrowser = await playwright.chromium.launch({
+      headless: true,
+      // Launch with clean browser profile - no extensions, no user data
+      args: [
+        "--disable-extensions",
+        "--disable-blink-features=AutomationControlled"
+      ]
+    });
+  }
+  return sharedBrowser;
+}
+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
+    });
+  }
+  return sharedContext;
+}
+async function createTestPage() {
+  const context = await getOrCreateContext();
+  return await context.newPage();
+}
+async function closeSharedBrowser() {
+  if (sharedContext) {
+    await sharedContext.close();
+    sharedContext = null;
+  }
+  if (sharedBrowser) {
+    await sharedBrowser.close();
+    sharedBrowser = null;
+  }
+}
+var sharedBrowser, sharedContext;
+var init_playwrightTestHarness = __esm({
+  "src/utils/test/contract/playwrightTestHarness.ts"() {
+    sharedBrowser = null;
+    sharedContext = null;
   }
 });
 
@@ -326,34 +335,35 @@ async function runContractTestsPlaywright(componentName, url) {
   const failures = [];
   const passes = [];
   const skipped = [];
-  let browser = null;
+  let page = null;
+  const useNavigation = !!url;
   try {
-    browser = await playwright.chromium.launch({ headless: true });
-    const context = await browser.newContext();
-    const page = await context.newPage();
-    await page.goto(url, {
-      waitUntil: "domcontentloaded",
-      timeout: 9e4
-    });
+    page = await createTestPage();
+    if (url) {
+      await page.goto(url, {
+        waitUntil: "domcontentloaded",
+        timeout: 3e4
+      });
+      await page.addStyleTag({ content: `* { transition: none !important; animation: none !important; }` });
+    }
     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: 9e4 });
+    const elementTimeout = useNavigation ? 3e4 : 5e3;
+    await page.locator(mainSelector).first().waitFor({ state: "attached", timeout: elementTimeout });
     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: 1e4 }
-      ).catch(() => {
-        console.warn("Menu initialization signal not detected, continuing with tests...");
+      await page.locator(componentContract.selectors.trigger).first().waitFor({
+        state: "visible",
+        timeout: 5e3
+      }).catch(() => {
+        console.warn("Menu trigger not visible, continuing with tests...");
       });
-      await page.waitForTimeout(300);
     }
     async function resolveRelativeTarget(selector, relative) {
+      if (!page) {
+        throw new Error("Page is not initialized");
+      }
       const items = await page.locator(selector).all();
       switch (relative) {
         case "first":
@@ -423,11 +433,11 @@ async function runContractTestsPlaywright(componentName, url) {
     for (const dynamicTest of componentContract.dynamic || []) {
       const { action, assertions } = dynamicTest;
       const failuresBeforeTest = failures.length;
-      if (componentContract.selectors.listbox || componentContract.selectors.container) {
-        const popupSelector = componentContract.selectors.listbox || componentContract.selectors.container;
+      if (componentContract.selectors.popup) {
+        const popupSelector = componentContract.selectors.popup;
         if (!popupSelector) continue;
         const popupElement = page.locator(popupSelector).first();
-        const isPopupVisible = await popupElement.isVisible();
+        const isPopupVisible = await popupElement.isVisible().catch(() => false);
         if (isPopupVisible) {
           let menuClosed = false;
           let closeSelector = componentContract.selectors.input;
@@ -439,73 +449,35 @@ async function runContractTestsPlaywright(componentName, url) {
           if (closeSelector) {
             const closeElement = page.locator(closeSelector).first();
             await closeElement.focus();
-            await page.waitForTimeout(200);
             await page.keyboard.press("Escape");
-            menuClosed = await page.waitForFunction(
-              (selector) => {
-                const popup = document.querySelector(selector);
-                return popup && getComputedStyle(popup).display === "none";
-              },
-              popupSelector,
-              { timeout: 3e3 }
-            ).then(() => true).catch(() => false);
+            menuClosed = await test.expect(popupElement).toBeHidden({ timeout: 2e3 }).then(() => true).catch(() => false);
           }
           if (!menuClosed && componentContract.selectors.trigger) {
             const triggerElement = page.locator(componentContract.selectors.trigger).first();
             await triggerElement.click();
-            await page.waitForTimeout(500);
-            menuClosed = await page.waitForFunction(
-              (selector) => {
-                const popup = document.querySelector(selector);
-                return popup && getComputedStyle(popup).display === "none";
-              },
-              popupSelector,
-              { timeout: 3e3 }
-            ).then(() => true).catch(() => false);
+            menuClosed = await test.expect(popupElement).toBeHidden({ timeout: 2e3 }).then(() => true).catch(() => false);
           }
           if (!menuClosed) {
             await page.mouse.click(10, 10);
-            await page.waitForTimeout(500);
-            menuClosed = await page.waitForFunction(
-              (selector) => {
-                const popup = document.querySelector(selector);
-                return popup && getComputedStyle(popup).display === "none";
-              },
-              popupSelector,
-              { timeout: 3e3 }
-            ).then(() => true).catch(() => false);
-            if (menuClosed) {
-              console.log("\u{1F3AF} Strategy 3 (Click outside) worked");
-            }
+            menuClosed = await test.expect(popupElement).toBeHidden({ timeout: 2e3 }).then(() => true).catch(() => false);
           }
           if (!menuClosed) {
-            throw new Error(
-              `\u274C FATAL: Cannot close menu between tests. Menu remains visible after trying:
+            if (useNavigation) {
+              throw new Error(
+                `\u274C FATAL: Cannot close menu between tests. Menu remains visible after trying:
   1. Escape key
   2. Clicking trigger
   3. Clicking outside
 This indicates a problem with the menu component's close functionality.`
-            );
-          }
-          if (componentName === "menu" && componentContract.selectors.trigger) {
-            await page.waitForFunction(
-              (selector) => {
-                const trigger = document.querySelector(selector);
-                return document.activeElement === trigger;
-              },
-              componentContract.selectors.trigger,
-              { timeout: 2e3 }
-            ).catch(async () => {
-              const triggerElement = page.locator(componentContract.selectors.trigger).first();
-              await triggerElement.focus();
-              await page.waitForTimeout(200);
-            });
+              );
+            }
           }
-          await page.waitForTimeout(500);
           if (componentContract.selectors.input) {
-            const inputElement = page.locator(componentContract.selectors.input).first();
-            await inputElement.clear();
-            await page.waitForTimeout(100);
+            await page.locator(componentContract.selectors.input).first().clear();
+          }
+          if (componentName === "menu" && componentContract.selectors.trigger) {
+            const triggerElement = page.locator(componentContract.selectors.trigger).first();
+            await triggerElement.focus();
           }
         }
       }
@@ -549,7 +521,6 @@ This indicates a problem with the menu component's close functionality.`
             continue;
           }
           await page.locator(focusSelector).first().focus();
-          await page.waitForTimeout(100);
         }
         if (act.type === "type" && act.value) {
           const typeSelector = componentContract.selectors[act.target];
@@ -558,7 +529,6 @@ This indicates a problem with the menu component's close functionality.`
             continue;
           }
           await page.locator(typeSelector).first().fill(act.value);
-          await page.waitForTimeout(100);
         }
         if (act.type === "click") {
           if (act.target === "document") {
@@ -575,7 +545,6 @@ This indicates a problem with the menu component's close functionality.`
               continue;
             }
             await relativeElement.click();
-            await page.waitForTimeout(componentName === "menu" ? 800 : 200);
           } else {
             const actionSelector = componentContract.selectors[act.target];
             if (!actionSelector) {
@@ -583,7 +552,6 @@ This indicates a problem with the menu component's close functionality.`
               continue;
             }
             await page.locator(actionSelector).first().click();
-            await page.waitForTimeout(componentName === "menu" ? 800 : 200);
           }
         }
         if (act.type === "keypress" && act.key) {
@@ -606,9 +574,7 @@ This indicates a problem with the menu component's close functionality.`
             keyValue = keyValue.replace(/ /g, "");
           }
           if (act.target === "focusable" && ["ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Escape"].includes(keyValue)) {
-            await page.waitForTimeout(componentName === "menu" ? 200 : 100);
             await page.keyboard.press(keyValue);
-            await page.waitForTimeout(componentName === "menu" ? 300 : 100);
           } else {
             const keypressSelector = componentContract.selectors[act.target];
             if (!keypressSelector) {
@@ -637,7 +603,6 @@ This indicates a problem with the menu component's close functionality.`
               continue;
             }
             await relativeElement.hover();
-            await page.waitForTimeout(100);
           } else {
             const hoverSelector = componentContract.selectors[act.target];
             if (!hoverSelector) {
@@ -645,12 +610,9 @@ This indicates a problem with the menu component's close functionality.`
               continue;
             }
             await page.locator(hoverSelector).first().hover();
-            await page.waitForTimeout(100);
           }
         }
-        await page.waitForTimeout(componentName === "menu" ? 200 : 100);
       }
-      await page.waitForTimeout(componentName === "menu" ? 300 : 100);
       for (const assertion of assertions) {
         let target;
         if (assertion.target === "relative") {
@@ -679,7 +641,7 @@ This indicates a problem with the menu component's close functionality.`
         }
         if (assertion.assertion === "toBeVisible") {
           try {
-            await (0, test_exports.expect)(target).toBeVisible({ timeout: 3e3 });
+            await test.expect(target).toBeVisible({ timeout: 2e3 });
             passes.push(`${assertion.target} is visible as expected. Test: "${dynamicTest.description}".`);
           } catch {
             const debugState = await page.evaluate((sel) => {
@@ -693,7 +655,7 @@ This indicates a problem with the menu component's close functionality.`
         }
         if (assertion.assertion === "notToBeVisible") {
           try {
-            await (0, test_exports.expect)(target).toBeHidden({ timeout: 5e3 });
+            await test.expect(target).toBeHidden({ timeout: 2e3 });
             passes.push(`${assertion.target} is not visible as expected. Test: "${dynamicTest.description}".`);
           } catch {
             const debugState = await page.evaluate((sel) => {
@@ -715,7 +677,7 @@ This indicates a problem with the menu component's close functionality.`
                 failures.push(assertion.failureMessage + ` ${assertion.target} "${assertion.attribute}" should not be empty, found "${attributeValue}".`);
               }
             } else {
-              await (0, test_exports.expect)(target).toHaveAttribute(assertion.attribute, assertion.expectedValue, { timeout: 3e3 });
+              await test.expect(target).toHaveAttribute(assertion.attribute, assertion.expectedValue, { timeout: 3e3 });
               passes.push(`${assertion.target} has expected "${assertion.attribute}". Test: "${dynamicTest.description}".`);
             }
           } catch {
@@ -745,7 +707,7 @@ This indicates a problem with the menu component's close functionality.`
         }
         if (assertion.assertion === "toHaveFocus") {
           try {
-            await (0, test_exports.expect)(target).toBeFocused({ timeout: 5e3 });
+            await test.expect(target).toBeFocused({ timeout: 5e3 });
             passes.push(`${assertion.target} has focus as expected. Test: "${dynamicTest.description}".`);
           } catch {
             const actualFocus = await page.evaluate(() => {
@@ -795,15 +757,15 @@ This indicates a problem with the menu component's close functionality.`
       }
     }
   } finally {
-    if (browser) await browser.close();
+    if (page) await page.close();
   }
   return { passes, failures, skipped };
 }
 var init_contractTestRunnerPlaywright = __esm({
   "src/utils/test/contract/contractTestRunnerPlaywright.ts"() {
-    init_test();
     init_contract();
     init_ContractReporter();
+    init_playwrightTestHarness();
   }
 });
 
@@ -871,60 +833,63 @@ async function runContractTests(componentName, component) {
 }
 
 // src/utils/test/src/test.ts
+init_playwrightTestHarness();
 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 jestAxe.axe(component);
-  } catch (error) {
-    throw new Error(
-      `\u274C Axe accessibility scan failed
+  if (component) {
+    try {
+      results = await jestAxe.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: runContractTestsPlaywright2 } = await Promise.resolve().then(() => (init_contractTestRunnerPlaywright(), contractTestRunnerPlaywright_exports));
-      contract = await runContractTestsPlaywright2(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: runContractTestsPlaywright2 } = await Promise.resolve().then(() => (init_contractTestRunnerPlaywright(), contractTestRunnerPlaywright_exports));
+        contract = await runContractTestsPlaywright2(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) {
@@ -990,5 +955,9 @@ if (typeof window === "undefined") {
     );
   };
 }
+async function cleanupTests() {
+  await closeSharedBrowser();
+}
 
+exports.cleanupTests = cleanupTests;
 exports.testUiComponent = testUiComponent;

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-AVCZIF6G.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-BFHRDJTJ.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-CREJNINL.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 };