kernhell 0.1.1__tar.gz → 0.1.2__tar.gz

{kernhell-0.1.1 → kernhell-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: kernhell
-Version: 0.1.1
+Version: 0.1.2
 Summary: AI-Powered Autonomous Self-Healing Testing Engine — The Heart of Your System Where Innovation Meets Precision
 Project-URL: Homepage, https://github.com/riteshkumar072/KernHell
 Project-URL: Documentation, https://github.com/riteshkumar072/KernHell#readme
@@ -19,16 +19,19 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Software Development :: Quality Assurance
 Classifier: Topic :: Software Development :: Testing
 Requires-Python: >=3.11
+Requires-Dist: fastapi<1.0,>=0.110
 Requires-Dist: libcst>=1.1.0
 Requires-Dist: litellm<2.0,>=1.30
 Requires-Dist: playwright<2.0,>=1.40
 Requires-Dist: pydantic-settings<3.0,>=2.1
 Requires-Dist: pydantic<3.0,>=2.5
+Requires-Dist: pytest<9.0,>=8.0
 Requires-Dist: rich<16.0,>=13.0
-Requires-Dist: selectolax<1.0,>=0.3
+Requires-Dist: selectolax<2.0,>=0.3
 Requires-Dist: structlog>=24.0
 Requires-Dist: tomli>=2.0; python_version < '3.11'
 Requires-Dist: typer<1.0,>=0.12
+Requires-Dist: uvicorn<1.0,>=0.27
 Provides-Extra: all
 Requires-Dist: aiosqlite<1.0,>=0.19; extra == 'all'
 Requires-Dist: build>=1.0.0; extra == 'all'
@@ -68,7 +71,8 @@ Description-Content-Type: text/markdown
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/)
 [![Next.js 14](https://img.shields.io/badge/dashboard-Next.js%2014-black.svg)](https://nextjs.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![CI/CD Status](https://img.shields.io/badge/tests-59%20passed%20(100%25)-brightgreen.svg)](https://github.com/riteshkumar072/KernHell)
+[![CI/CD Status](https://img.shields.io/badge/tests-61%20passed%20(100%25)-brightgreen.svg)](https://github.com/riteshkumar072/KernHell)
+[![TypeScript & Python](https://img.shields.io/badge/playwright-Python%20%7C%20TypeScript-blue.svg)](https://playwright.dev/)
 
 ---
 
@@ -76,7 +80,7 @@ Description-Content-Type: text/markdown
 
 Modern frontend engineering moves fast. When developers refactor classes, IDs, or DOM wrappers (e.g., `#buy-now` becomes `#purchase-btn`), automated Playwright and Selenium test suites fail even though the business functionality works seamlessly. QA teams waste 30–40% of their time manually maintaining broken selectors.
 
-**KernHell autonomously resolves broken selectors in real-time, preserving 100% of your code formatting, comments, and QA sanity.**
+**KernHell autonomously resolves broken selectors in real-time across both Python and TypeScript/JavaScript test suites, preserving 100% of your code formatting, comments, and QA sanity.**
 
 ---
 
@@ -94,7 +98,7 @@ flowchart TD
     F -->|RENAME: Safe Refactor| G
     G -->|5. Verify Unambiguous Element| I[Selector Fix: role / data-testid / text]
     I -->|Store Embedding| D
-    I -->|6. Surgical Patch| J[LibCST AST Patcher]
+    I -->|6. Surgical Patch| J[Surgical CST & Line Patcher]
     J -->|Preserve Comments & Formatting| K[Automatic Verification Runner]
     K -->|Pass| L[Commit Fix & Log Run]
     K -->|Fail| M[Immediate Rollback from .kernhell.bak]
@@ -104,12 +108,13 @@ flowchart TD
 
 ## 🚀 Key Features
 
+- **Multi-Language Playwright Support**: Seamlessly heals both **Python (`pytest-playwright`)** and **TypeScript / JavaScript (`@playwright/test`)** test suites with zero configuration.
 - **Failure Interception & Live DOM Capture (`Scanner`)**: Intercepts Playwright selector timeouts and crashes, capturing the error stack trace, line number, broken selector, and live DOM snapshot (`page.content()`).
 - **High-Speed Semantic DOM Pruning (`DOMPruner`)**: Strips scripts, styles, SVGs, base64 data, and non-semantic wrappers using `selectolax` to slash token usage by 80–90% while keeping semantic landmarks and accessibility roles.
 - **Semantic Vector Memory (`Vector Cache`)**: 384-dimensional dense cosine index matching broken selectors against historical fixes. Resolves recurring failures in **<5ms** with zero LLM API cost.
 - **Strict Anti-Hallucination Guardrails**: Distinguishes between renamed selectors (`RENAME`) and genuine missing features (`MISSING`) to prevent false-positive heals on actual product regressions.
-- **Surgical LibCST AST Patching (`Patcher`)**: Surgically transforms only the target locator expression in the AST without reformatting unrelated code or stripping inline comments.
-- **Automated Verification & Zero-Risk Rollback (`Verifier`)**: Re-runs the patched test in a sandbox; if it fails, immediately restores the code from `.kernhell.bak`.
+- **Surgical Code Patching (`Patcher`)**: Surgically transforms only the target locator expression in the AST / file without reformatting unrelated code or stripping inline comments (supports Python LibCST & TypeScript line targeting).
+- **Automated Verification & Zero-Risk Rollback (`Verifier`)**: Re-runs the patched test in a sandbox (via `pytest` or `npx playwright test`); if it fails, immediately restores the code from `.kernhell.bak`.
 - **Mission Control Dashboard (`Next.js App Router`)**: High-tech, dark-mode glassmorphic web dashboard providing live stats, real-time healing stream, semantic memory inspector, and interactive simulation playground.
 
 ---

{kernhell-0.1.1 → kernhell-0.1.2}/README.md

@@ -7,7 +7,8 @@
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/)
 [![Next.js 14](https://img.shields.io/badge/dashboard-Next.js%2014-black.svg)](https://nextjs.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![CI/CD Status](https://img.shields.io/badge/tests-59%20passed%20(100%25)-brightgreen.svg)](https://github.com/riteshkumar072/KernHell)
+[![CI/CD Status](https://img.shields.io/badge/tests-61%20passed%20(100%25)-brightgreen.svg)](https://github.com/riteshkumar072/KernHell)
+[![TypeScript & Python](https://img.shields.io/badge/playwright-Python%20%7C%20TypeScript-blue.svg)](https://playwright.dev/)
 
 ---
 
@@ -15,7 +16,7 @@
 
 Modern frontend engineering moves fast. When developers refactor classes, IDs, or DOM wrappers (e.g., `#buy-now` becomes `#purchase-btn`), automated Playwright and Selenium test suites fail even though the business functionality works seamlessly. QA teams waste 30–40% of their time manually maintaining broken selectors.
 
-**KernHell autonomously resolves broken selectors in real-time, preserving 100% of your code formatting, comments, and QA sanity.**
+**KernHell autonomously resolves broken selectors in real-time across both Python and TypeScript/JavaScript test suites, preserving 100% of your code formatting, comments, and QA sanity.**
 
 ---
 
@@ -33,7 +34,7 @@ flowchart TD
     F -->|RENAME: Safe Refactor| G
     G -->|5. Verify Unambiguous Element| I[Selector Fix: role / data-testid / text]
     I -->|Store Embedding| D
-    I -->|6. Surgical Patch| J[LibCST AST Patcher]
+    I -->|6. Surgical Patch| J[Surgical CST & Line Patcher]
     J -->|Preserve Comments & Formatting| K[Automatic Verification Runner]
     K -->|Pass| L[Commit Fix & Log Run]
     K -->|Fail| M[Immediate Rollback from .kernhell.bak]
@@ -43,12 +44,13 @@ flowchart TD
 
 ## 🚀 Key Features
 
+- **Multi-Language Playwright Support**: Seamlessly heals both **Python (`pytest-playwright`)** and **TypeScript / JavaScript (`@playwright/test`)** test suites with zero configuration.
 - **Failure Interception & Live DOM Capture (`Scanner`)**: Intercepts Playwright selector timeouts and crashes, capturing the error stack trace, line number, broken selector, and live DOM snapshot (`page.content()`).
 - **High-Speed Semantic DOM Pruning (`DOMPruner`)**: Strips scripts, styles, SVGs, base64 data, and non-semantic wrappers using `selectolax` to slash token usage by 80–90% while keeping semantic landmarks and accessibility roles.
 - **Semantic Vector Memory (`Vector Cache`)**: 384-dimensional dense cosine index matching broken selectors against historical fixes. Resolves recurring failures in **<5ms** with zero LLM API cost.
 - **Strict Anti-Hallucination Guardrails**: Distinguishes between renamed selectors (`RENAME`) and genuine missing features (`MISSING`) to prevent false-positive heals on actual product regressions.
-- **Surgical LibCST AST Patching (`Patcher`)**: Surgically transforms only the target locator expression in the AST without reformatting unrelated code or stripping inline comments.
-- **Automated Verification & Zero-Risk Rollback (`Verifier`)**: Re-runs the patched test in a sandbox; if it fails, immediately restores the code from `.kernhell.bak`.
+- **Surgical Code Patching (`Patcher`)**: Surgically transforms only the target locator expression in the AST / file without reformatting unrelated code or stripping inline comments (supports Python LibCST & TypeScript line targeting).
+- **Automated Verification & Zero-Risk Rollback (`Verifier`)**: Re-runs the patched test in a sandbox (via `pytest` or `npx playwright test`); if it fails, immediately restores the code from `.kernhell.bak`.
 - **Mission Control Dashboard (`Next.js App Router`)**: High-tech, dark-mode glassmorphic web dashboard providing live stats, real-time healing stream, semantic memory inspector, and interactive simulation playground.
 
 ---

{kernhell-0.1.1 → kernhell-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "kernhell"
-version = "0.1.1"
+version = "0.1.2"
 description = "AI-Powered Autonomous Self-Healing Testing Engine — The Heart of Your System Where Innovation Meets Precision"
 readme = "README.md"
 license = "MIT"
@@ -29,10 +29,13 @@ dependencies = [
     "pydantic>=2.5,<3.0",
     "pydantic-settings>=2.1,<3.0",
     "playwright>=1.40,<2.0",
-    "selectolax>=0.3,<1.0",
+    "selectolax>=0.3,<2.0",
     "libcst>=1.1.0",
     "structlog>=24.0",
     "litellm>=1.30,<2.0",
+    "fastapi>=0.110,<1.0",
+    "uvicorn>=0.27,<1.0",
+    "pytest>=8.0,<9.0",
     "tomli>=2.0;python_version<'3.11'",
 ]
 

{kernhell-0.1.1 → kernhell-0.1.2}/src/kernhell/__init__.py

@@ -4,5 +4,5 @@ KernHell — AI-Powered Autonomous Self-Healing Testing Engine.
 "The Heart of Your System Where Innovation Meets Precision"
 """
 
-__version__ = "0.1.1"
+__version__ = "0.1.2"
 __app_name__ = "kernhell"

{kernhell-0.1.1 → kernhell-0.1.2}/src/kernhell/analyzer/healer.py

@@ -52,14 +52,14 @@ def verify_dom_presence(new_selector: str, dom_html: str) -> bool:
 
     dom_lower = dom_html.lower()
 
-    # 1. Check get_by_test_id("foo") or [data-testid="foo"]
-    testid_match = re.search(r"""(?:get_by_test_id|data-testid[=:])\s*\(?["']?([^"'\)]+)""", new_selector)
+    # 1. Check get_by_test_id("foo") or getByTestId("foo") or [data-testid="foo"]
+    testid_match = re.search(r"""(?:get_by_test_id|getByTestId|data-testid[=:])\s*\(?["']?([^"'\)]+)""", new_selector)
     if testid_match:
         testid = testid_match.group(1).lower()
         return testid in dom_lower
 
-    # 2. Check get_by_role("button", name="...")
-    role_match = re.search(r"""get_by_role\(\s*["'](\w+)["'](?:\s*,\s*name\s*=\s*["']([^"']+)["'])?""", new_selector)
+    # 2. Check get_by_role("button", name="...") or getByRole("button", { name: "..." })
+    role_match = re.search(r"""(?:get_by_role|getByRole)\(\s*["'](\w+)["'](?:\s*,\s*(?:\{\s*name:\s*|name\s*=\s*)["']([^"']+)["']\s*\}?)?""", new_selector)
     if role_match:
         role = role_match.group(1).lower()
         name = role_match.group(2).lower() if role_match.group(2) else ""
@@ -67,8 +67,8 @@ def verify_dom_presence(new_selector: str, dom_html: str) -> bool:
             return name in dom_lower and (role in dom_lower or f"<{role}" in dom_lower)
         return role in dom_lower or f"<{role}" in dom_lower
 
-    # 3. Check get_by_text("...")
-    text_match = re.search(r"""get_by_text\(\s*["']([^"']+)["']""", new_selector)
+    # 3. Check get_by_text("...") or getByText("...")
+    text_match = re.search(r"""(?:get_by_text|getByText)\(\s*["']([^"']+)["']""", new_selector)
     if text_match:
         text = text_match.group(1).lower()
         return text in dom_lower

{kernhell-0.1.1 → kernhell-0.1.2}/src/kernhell/cli/commands/dashboard.py

@@ -10,11 +10,9 @@ from pathlib import Path
 from typing import Optional
 
 import typer
-import uvicorn
 from rich.console import Console
 from rich.panel import Panel
 
-from kernhell.api.server import create_app
 from kernhell.cli.ui import print_banner
 from kernhell.core.config import load_config
 from kernhell.utils.logger import setup_logging
@@ -51,5 +49,16 @@ def dashboard_command(
         except Exception:
             pass
 
+    try:
+        import uvicorn
+        from kernhell.api.server import create_app
+    except ImportError:
+        console.print(
+            "\n[bold red]Error:[/bold red] Mission Control Dashboard requires [bold cyan]fastapi[/bold cyan] and [bold cyan]uvicorn[/bold cyan].\n"
+            "Please install them via:\n"
+            "  [green]pip install 'kernhell[dashboard]'[/green] or [green]pip install fastapi uvicorn[/green]\n"
+        )
+        raise typer.Exit(code=1)
+
     app = create_app(cfg)
     uvicorn.run(app, host=host, port=port, log_level="warning")

{kernhell-0.1.1 → kernhell-0.1.2}/src/kernhell/cli/commands/heal.py

@@ -85,11 +85,25 @@ def heal_command(
         console.print(f"[bold red]Error:[/bold red] Target path not found: {target}")
         raise typer.Exit(code=1)
 
-    # Discover test files (single file vs batch directory mode)
+    # Discover test files (single file vs batch directory mode, Python + TypeScript/JS)
     if target.is_dir():
-        test_files = sorted(target.rglob("test_*.py"))
+        candidates = set()
+        for p in target.rglob("*"):
+            if not p.is_file():
+                continue
+            name_lower = p.name.lower()
+            if (
+                (name_lower.startswith("test_") and p.suffix in (".py", ".ts", ".js"))
+                or name_lower.endswith("_test.py")
+                or name_lower.endswith(".spec.ts")
+                or name_lower.endswith(".test.ts")
+                or name_lower.endswith(".spec.js")
+                or name_lower.endswith(".test.js")
+            ):
+                candidates.add(p)
+        test_files = sorted(candidates)
         if not test_files:
-            console.print(f"[yellow]No 'test_*.py' files found in {target}[/yellow]")
+            console.print(f"[yellow]No Playwright test files (.py, .ts, .js) found in {target}[/yellow]")
             raise typer.Exit(code=0)
     else:
         test_files = [target]

{kernhell-0.1.1 → kernhell-0.1.2}/src/kernhell/scanner/parser.py

@@ -27,59 +27,67 @@ logger = structlog.get_logger()
 # Regex patterns for Playwright error parsing
 # ---------------------------------------------------------------------------
 
-# Matches: "locator.click: Timeout 5000ms exceeded."
+# Matches: "locator.click: Timeout 5000ms exceeded." or "Timed out 5000ms waiting for expect(locator)..."
 _TIMEOUT_PATTERN = re.compile(
-    r"(locator\.\w+|page\.\w+):\s*Timeout\s+\d+ms\s+exceeded",
+    r"(locator\.\w+|page\.\w+|expect\(locator\)):?\s*Timeout\s+\d+ms\s+exceeded|Timed\s+out\s+\d+ms",
     re.IGNORECASE,
 )
 
 # Matches: "waiting for locator("button#buy-now")" or 'locator("#buy-now")'
 _LOCATOR_PATTERN = re.compile(
-    r"""locator\(\s*["'](.+?)["']\s*\)""",
+    r"""locator\(\s*["'`]?(.+?)["'`]?\s*\)""",
     re.IGNORECASE,
 )
 
-# Matches: page.click("#buy-now") or page.fill("input.email", ...)
+# Matches: page.click("#buy-now") or await page.fill("input.email", ...)
 _PAGE_ACTION_PATTERN = re.compile(
-    r"""page\.(?:click|fill|type|check|uncheck|select_option|hover|dblclick|focus)\(\s*["'](.+?)["']""",
+    r"""(?:await\s+)?page\.(?:click|fill|type|check|uncheck|select_option|selectOption|hover|dblclick|focus)\(\s*["'`](.+?)["'`]""",
     re.IGNORECASE,
 )
 
-# Matches: page.get_by_role("button", name="Buy Now")
+# Matches: page.get_by_role("button", name="Buy Now") or page.getByRole("button", { name: "Buy Now" })
 _GET_BY_ROLE_PATTERN = re.compile(
-    r"""page\.get_by_role\(\s*["'](\w+)["'](?:\s*,\s*name\s*=\s*["'](.+?)["'])?\s*\)""",
+    r"""(?:page\.)?(?:get_by_role|getByRole)\(\s*["'](\w+)["'](?:\s*,\s*(?:\{\s*name:\s*|name\s*=\s*)["']([^"']+)["']\s*\}?)?\s*\)""",
     re.IGNORECASE,
 )
 
-# Matches: page.get_by_text("Buy Now")
+# Matches: page.get_by_text("Buy Now") or page.getByText("Buy Now")
 _GET_BY_TEXT_PATTERN = re.compile(
-    r"""page\.get_by_text\(\s*["'](.+?)["']\s*\)""",
+    r"""(?:page\.)?(?:get_by_text|getByText)\(\s*["'](.+?)["']\s*\)""",
     re.IGNORECASE,
 )
 
-# Matches: page.get_by_test_id("checkout-btn")
+# Matches: page.get_by_test_id("checkout-btn") or page.getByTestId("checkout-btn")
 _GET_BY_TESTID_PATTERN = re.compile(
-    r"""page\.get_by_test_id\(\s*["'](.+?)["']\s*\)""",
+    r"""(?:page\.)?(?:get_by_test_id|getByTestId)\(\s*["'](.+?)["']\s*\)""",
     re.IGNORECASE,
 )
 
-# Matches: page.get_by_label("Email")
+# Matches: page.get_by_label("Email") or page.getByLabel("Email")
 _GET_BY_LABEL_PATTERN = re.compile(
-    r"""page\.get_by_label\(\s*["'](.+?)["']\s*\)""",
+    r"""(?:page\.)?(?:get_by_label|getByLabel)\(\s*["'](.+?)["']\s*\)""",
     re.IGNORECASE,
 )
 
-# Matches: page.get_by_placeholder("Enter email")
+# Matches: page.get_by_placeholder("Enter email") or page.getByPlaceholder("Enter email")
 _GET_BY_PLACEHOLDER_PATTERN = re.compile(
-    r"""page\.get_by_placeholder\(\s*["'](.+?)["']\s*\)""",
+    r"""(?:page\.)?(?:get_by_placeholder|getByPlaceholder)\(\s*["'](.+?)["']\s*\)""",
     re.IGNORECASE,
 )
 
-# Matches pytest traceback lines like: "tests/test_checkout.py:15: TimeoutError"
-_PYTEST_LOCATION_PATTERN = re.compile(
-    r"^(.+\.py):(\d+):\s*(TimeoutError|Error|AssertionError)",
+# Matches pytest and Playwright TS location lines
+_LOCATION_PATTERN = re.compile(
+    r"^(.+\.(?:py|ts|js|tsx|jsx)):(\d+):(?:\d+:)?\s*(TimeoutError|Error|AssertionError)?",
     re.MULTILINE,
 )
+_TS_AT_LOCATION_PATTERN = re.compile(
+    r"at\s+(?:.+\s+)?\(?(.+\.(?:ts|js|py|tsx|jsx)):(\d+):(\d+)\)?",
+    re.IGNORECASE,
+)
+_TS_LINE_SNIPPET_PATTERN = re.compile(
+    r">\s*(\d+)\s*\|\s*(?:await\s+)?(?:page|locator)",
+    re.IGNORECASE,
+)
 
 # Matches: "strict mode violation" errors
 _STRICT_MODE_PATTERN = re.compile(
@@ -186,12 +194,21 @@ def _extract_selector(text: str) -> tuple[str, SelectorType]:
 
 
 def _extract_line_number(error_text: str, test_file: Path) -> int:
-    """Extract the failing line number from pytest traceback output."""
+    """Extract the failing line number from pytest or Playwright TS traceback output."""
     filename = test_file.name
-    for m in _PYTEST_LOCATION_PATTERN.finditer(error_text):
+
+    for m in _LOCATION_PATTERN.finditer(error_text):
         if filename in m.group(1):
             return int(m.group(2))
 
+    for m in _TS_AT_LOCATION_PATTERN.finditer(error_text):
+        if filename in m.group(1):
+            return int(m.group(2))
+
+    snippet_match = _TS_LINE_SNIPPET_PATTERN.search(error_text)
+    if snippet_match:
+        return int(snippet_match.group(1))
+
     # Fallback: look for any ":<number>:" pattern near the test filename
     fallback = re.search(
         rf"{re.escape(filename)}:(\d+)",

{kernhell-0.1.1 → kernhell-0.1.2}/src/kernhell/scanner/runner.py

@@ -34,19 +34,27 @@ from kernhell.scanner.parser import parse_playwright_errors
 logger = structlog.get_logger()
 
 
-def _extract_url_from_test(test_file: Path) -> str | None:
-    """Extract the first ``page.goto(...)`` URL from a test file.
-
-    This is a best-effort heuristic used to re-open the page for DOM capture.
-    """
+def _extract_url_or_content_from_test(test_file: Path) -> tuple[str | None, str | None]:
+    """Extract the page URL or inline page.set_content HTML from a test file."""
     try:
         content = test_file.read_text(encoding="utf-8")
     except Exception:
-        return None
+        return None, None
+
+    # Check for inline set_content first: page.set_content('<button...')
+    set_content_match = re.search(
+        r"""page\.set_content\(\s*(?:r?["']{3}(.+?)["']{3}|r?["'](.+?)["'])\s*\)""",
+        content,
+        re.DOTALL,
+    )
+    if set_content_match:
+        html = set_content_match.group(1) or set_content_match.group(2)
+        return None, html
 
     # Match: page.goto("https://example.com") or page.goto('...')
     m = re.search(r"""page\.goto\(\s*["'](.+?)["']""", content)
-    return m.group(1) if m else None
+    url = m.group(1) if m else None
+    return url, None
 
 
 class ScannerRunner:
@@ -91,8 +99,8 @@ class ScannerRunner:
 
         logger.info("scanner.run.start", test_file=str(test_file))
 
-        # Step 1: Run the test via pytest subprocess
-        error_output = self._run_pytest(test_file)
+        # Step 1: Run the test via appropriate runner (pytest for .py, npx playwright test for .ts/.js)
+        error_output = self._run_test_process(test_file)
 
         if error_output is None:
             raise NoFailuresDetectedError(
@@ -109,8 +117,11 @@ class ScannerRunner:
             )
 
         # Step 3: Capture live DOM for each failure
-        page_url = _extract_url_from_test(test_file)
-        if page_url:
+        page_url, inline_dom = _extract_url_or_content_from_test(test_file)
+        if inline_dom:
+            for f in failures:
+                f.live_dom = inline_dom
+        elif page_url:
             live_dom = self._capture_live_dom(page_url)
             if live_dom:
                 for f in failures:
@@ -123,7 +134,54 @@ class ScannerRunner:
             failures=len(failures),
             has_dom=bool(failures[0].live_dom) if failures else False,
         )
-        return failures
+    def _run_test_process(self, test_file: Path) -> str | None:
+        """Run the test subprocess (Python pytest or TypeScript Playwright test)."""
+        if test_file.suffix.lower() in (".ts", ".js", ".tsx", ".jsx", ".mjs", ".cjs"):
+            return self._run_playwright_test_ts(test_file)
+        return self._run_pytest(test_file)
+
+    def _run_playwright_test_ts(self, test_file: Path) -> str | None:
+        """Execute a TypeScript/JavaScript Playwright test via npx playwright test."""
+        npx_cmd = "npx.cmd" if sys.platform == "win32" else "npx"
+        cmd = [
+            npx_cmd,
+            "playwright",
+            "test",
+            str(test_file),
+            "--reporter=list",
+        ]
+
+        logger.debug("scanner.playwright_ts.exec", cmd=" ".join(cmd))
+
+        try:
+            result = subprocess.run(
+                cmd,
+                capture_output=True,
+                text=True,
+                timeout=self._scanner_cfg.timeout_ms * 3 / 1000,
+                cwd=str(test_file.parent),
+                shell=(sys.platform == "win32"),
+            )
+        except FileNotFoundError:
+            raise PlaywrightNotInstalledError(
+                "npx / Node.js not found on PATH. Please ensure Node.js is installed to run TypeScript Playwright tests."
+            )
+        except subprocess.TimeoutExpired:
+            raise ScannerError(
+                f"TypeScript test execution timed out after {self._scanner_cfg.timeout_ms * 3}ms"
+            )
+
+        if result.returncode == 0:
+            logger.info("scanner.playwright_ts.passed", test_file=str(test_file))
+            return None
+
+        combined = result.stdout + "\n" + result.stderr
+        logger.debug(
+            "scanner.playwright_ts.failed",
+            exit_code=result.returncode,
+            output_len=len(combined),
+        )
+        return combined
 
     def _run_pytest(self, test_file: Path) -> str | None:
         """Execute pytest on the test file and return error output.
@@ -138,7 +196,6 @@ class ScannerRunner:
             "-v",
             "--tb=long",
             "--no-header",
-            f"--timeout={self._scanner_cfg.timeout_ms // 1000}",
         ]
 
         logger.debug("scanner.pytest.exec", cmd=" ".join(cmd))