@elench/testkit 0.1.112 → 0.1.114

package/lib/runner/subprocess.mjs

@@ -0,0 +1,155 @@
+import { execa } from "execa";
+import { killProcessTree, sleep } from "./processes.mjs";
+
+const DEFAULT_TERMINATION_GRACE_MS = 5_000;
+
+export function startManagedSubprocess(command, args = [], options = {}) {
+  const detached = options.detached ?? process.platform !== "win32";
+  return execa(command, args, {
+    ...options,
+    detached,
+    reject: false,
+    forceKillAfterDelay: options.forceKillAfterDelay ?? DEFAULT_TERMINATION_GRACE_MS,
+  });
+}
+
+export async function settleManagedSubprocess(
+  subprocess,
+  {
+    timeoutMs,
+    gracefulSignal = "SIGTERM",
+    forceSignal = "SIGKILL",
+    terminationGraceMs = DEFAULT_TERMINATION_GRACE_MS,
+  } = {}
+) {
+  const normalizedTimeoutMs = normalizePositiveInteger(timeoutMs, "timeoutMs");
+  const normalizedGraceMs = normalizePositiveInteger(terminationGraceMs, "terminationGraceMs");
+  const startedAt = Date.now();
+  let timeoutHandle = null;
+  let timeoutStarted = false;
+  let terminationPromise = null;
+
+  try {
+    const completed = await Promise.race([
+      subprocess.then(
+        async (result) => {
+          if (!timeoutStarted) return { result, timedOut: false, termination: null };
+          const termination = terminationPromise ? await terminationPromise : null;
+          return { result, timedOut: true, termination };
+        },
+        async (error) => {
+          const result = normalizeSubprocessError(error);
+          if (!timeoutStarted) return { result, timedOut: false, termination: null };
+          const termination = terminationPromise ? await terminationPromise : null;
+          return { result, timedOut: true, termination };
+        }
+      ),
+      new Promise((resolve) => {
+        timeoutHandle = setTimeout(async () => {
+          timeoutStarted = true;
+          terminationPromise = terminateSubprocess(subprocess, {
+            gracefulSignal,
+            forceSignal,
+            terminationGraceMs: normalizedGraceMs,
+          });
+          const termination = await terminationPromise;
+          resolve({
+            result: termination.result,
+            timedOut: true,
+            termination,
+          });
+        }, normalizedTimeoutMs);
+      }),
+    ]);
+
+    return {
+      ...completed,
+      durationMs: Date.now() - startedAt,
+    };
+  } finally {
+    if (timeoutHandle) clearTimeout(timeoutHandle);
+  }
+}
+
+export async function terminateSubprocess(
+  subprocess,
+  {
+    gracefulSignal = "SIGTERM",
+    forceSignal = "SIGKILL",
+    terminationGraceMs = DEFAULT_TERMINATION_GRACE_MS,
+  } = {}
+) {
+  const normalizedGraceMs = normalizePositiveInteger(terminationGraceMs, "terminationGraceMs");
+  const gracefulAt = Date.now();
+  killProcessTree(subprocess?.pid, gracefulSignal);
+
+  const gracefulResult = await waitForSubprocess(subprocess, normalizedGraceMs);
+  if (gracefulResult.settled) {
+    return {
+      gracefulSignal,
+      forceSignal: null,
+      forced: false,
+      durationMs: Date.now() - gracefulAt,
+      result: gracefulResult.result,
+    };
+  }
+
+  killProcessTree(subprocess?.pid, forceSignal);
+  const forcedResult = await waitForSubprocess(subprocess, normalizedGraceMs);
+  return {
+    gracefulSignal,
+    forceSignal,
+    forced: true,
+    durationMs: Date.now() - gracefulAt,
+    result: forcedResult.settled
+      ? forcedResult.result
+      : syntheticKilledResult(subprocess, forceSignal),
+  };
+}
+
+async function waitForSubprocess(subprocess, timeoutMs) {
+  if (!subprocess) {
+    return { settled: true, result: syntheticKilledResult(null, "SIGKILL") };
+  }
+
+  const result = await Promise.race([
+    subprocess.then(
+      (value) => ({ settled: true, result: value }),
+      (error) => ({ settled: true, result: normalizeSubprocessError(error) })
+    ),
+    sleep(timeoutMs).then(() => ({ settled: false, result: null })),
+  ]);
+  return result;
+}
+
+function syntheticKilledResult(subprocess, signal) {
+  return {
+    command: subprocess?.command || null,
+    escapedCommand: subprocess?.escapedCommand || null,
+    exitCode: null,
+    signal,
+    stdout: "",
+    stderr: "",
+    timedOut: true,
+    failed: true,
+    killed: true,
+  };
+}
+
+function normalizeSubprocessError(error) {
+  return {
+    ...error,
+    exitCode: error?.exitCode ?? null,
+    signal: error?.signal ?? null,
+    stdout: error?.stdout || "",
+    stderr: error?.stderr || error?.message || "",
+  };
+}
+
+function normalizePositiveInteger(value, label) {
+  const normalized = Number(value);
+  if (!Number.isInteger(normalized) || normalized <= 0) {
+    throw new Error(`${label} must be a positive integer.`);
+  }
+  return normalized;
+}

package/lib/shared/file-timeout.mjs

@@ -79,7 +79,7 @@ export function formatFileTimeoutBudgetError(fileTimeoutSeconds) {
     fileTimeoutSeconds,
     "fileTimeoutSeconds"
   );
-  return `Default runtime exceeded the ${normalizedFileTimeoutSeconds}s test file timeout`;
+  return `Test file exceeded the ${normalizedFileTimeoutSeconds}s wall-clock timeout`;
 }
 
 function parsePositiveInteger(value, label) {

package/lib/ui/index.d.ts

@@ -1 +1,3 @@
 export * from "@playwright/test";
+export { defineConfig } from "../playwright/index";
+export type { PlaywrightConfigOptions } from "../playwright/index";

package/lib/ui/index.mjs

@@ -1 +1,2 @@
 export * from "@playwright/test";
+export { defineConfig } from "../playwright/index.mjs";

package/node_modules/@elench/next-analysis/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/next-analysis",
-  "version": "0.1.112",
+  "version": "0.1.114",
   "description": "SWC-backed Next.js source analysis primitives for Erench tools",
   "type": "module",
   "exports": {

package/node_modules/@elench/testkit-bridge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit-bridge",
-  "version": "0.1.112",
+  "version": "0.1.114",
   "description": "Browser bridge helpers for testkit",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,7 +22,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "dependencies": {
-    "@elench/testkit-protocol": "0.1.112"
+    "@elench/testkit-protocol": "0.1.114"
   },
   "private": false
 }

package/node_modules/@elench/testkit-protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit-protocol",
-  "version": "0.1.112",
+  "version": "0.1.114",
   "description": "Shared browser protocol for testkit bridge and extension consumers",
   "type": "module",
   "main": "./dist/index.js",

package/node_modules/@elench/ts-analysis/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/ts-analysis",
-  "version": "0.1.112",
+  "version": "0.1.114",
   "description": "TypeScript compiler-backed source analysis primitives for Erench tools",
   "type": "module",
   "exports": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elench/testkit",
-  "version": "0.1.112",
+  "version": "0.1.114",
   "description": "Assistant-first CLI for running, inspecting, and debugging local testkit suites",
   "type": "module",
   "workspaces": [
@@ -90,10 +90,10 @@
   },
   "dependencies": {
     "@babel/code-frame": "^7.29.0",
-    "@elench/next-analysis": "0.1.112",
-    "@elench/testkit-bridge": "0.1.112",
-    "@elench/testkit-protocol": "0.1.112",
-    "@elench/ts-analysis": "0.1.112",
+    "@elench/next-analysis": "0.1.114",
+    "@elench/testkit-bridge": "0.1.114",
+    "@elench/testkit-protocol": "0.1.114",
+    "@elench/ts-analysis": "0.1.114",
     "@oclif/core": "^4.10.6",
     "@playwright/test": "^1.52.0",
     "esbuild": "^0.25.11",

package/lib/cli/components/primitives/filter-bar.mjs

@@ -1,12 +0,0 @@
-import React, { createElement } from "react";
-import { Text } from "ink";
-import { bold, dim } from "../../terminal/colors.mjs";
-
-export function FilterBar({ filter } = {}) {
-  if (!filter?.active) return null;
-  return createElement(
-    Text,
-    null,
-    `${bold("/")}${filter.query}${dim(`  ${filter.count} ${filter.count === 1 ? "match" : "matches"}`)}`
-  );
-}

package/lib/cli/state/tree/fuzzy-match.mjs

@@ -1,106 +0,0 @@
-const FIELD_WEIGHTS = {
-  path: 140,
-  label: 120,
-  suite: 90,
-  service: 70,
-  type: 60,
-  status: 30,
-  error: 20,
-};
-
-export function fuzzyMatch(query, candidate) {
-  const normalizedQuery = normalizeValue(query);
-  const normalizedCandidate = normalizeValue(candidate);
-  if (!normalizedQuery) {
-    return { matched: true, score: 0, positions: [] };
-  }
-  if (!normalizedCandidate) {
-    return { matched: false, score: Number.NEGATIVE_INFINITY, positions: [] };
-  }
-
-  const positions = [];
-  let queryIndex = 0;
-  let lastPosition = -1;
-  let score = 0;
-
-  for (let candidateIndex = 0; candidateIndex < normalizedCandidate.length; candidateIndex += 1) {
-    if (normalizedCandidate[candidateIndex] !== normalizedQuery[queryIndex]) continue;
-    positions.push(candidateIndex);
-    score += 1;
-    if (candidateIndex === 0) score += 3;
-    if (isBoundary(candidate, candidateIndex)) score += 10;
-    if (lastPosition >= 0) {
-      const gap = candidateIndex - lastPosition - 1;
-      score -= gap;
-      if (gap === 0) score += 5;
-    }
-    lastPosition = candidateIndex;
-    queryIndex += 1;
-    if (queryIndex >= normalizedQuery.length) {
-      return { matched: true, score, positions };
-    }
-  }
-
-  return { matched: false, score: Number.NEGATIVE_INFINITY, positions: [] };
-}
-
-export function matchRunTreeEntry(query, entry) {
-  const fields = buildEntryMatchFields(entry);
-  let best = null;
-
-  for (const field of fields) {
-    if (!field.value) continue;
-    const result = fuzzyMatch(query, field.value);
-    if (!result.matched) continue;
-    const weightedScore = result.score + (FIELD_WEIGHTS[field.name] || 0);
-    if (!best || weightedScore > best.score) {
-      best = {
-        matched: true,
-        score: weightedScore,
-        field: field.name,
-        positions: result.positions,
-      };
-    }
-  }
-
-  if (!best) {
-    return { matched: false, score: Number.NEGATIVE_INFINITY, field: null, positions: [] };
-  }
-
-  return best;
-}
-
-export function applyHighlight(text, positions, highlightFn) {
-  const source = String(text || "");
-  if (!Array.isArray(positions) || positions.length === 0) return source;
-  const positionSet = new Set(positions);
-  let output = "";
-  for (let index = 0; index < source.length; index += 1) {
-    output += positionSet.has(index) ? highlightFn(source[index]) : source[index];
-  }
-  return output;
-}
-
-function buildEntryMatchFields(entry) {
-  return [
-    { name: "label", value: entry.label || "" },
-    { name: "path", value: entry.filePath || "" },
-    { name: "suite", value: entry.suiteName || "" },
-    { name: "service", value: entry.serviceName || "" },
-    { name: "type", value: entry.type || "" },
-    { name: "status", value: entry.status || "" },
-    { name: "error", value: entry.error || "" },
-  ];
-}
-
-function normalizeValue(value) {
-  return String(value || "").toLowerCase();
-}
-
-function isBoundary(source, index) {
-  if (index <= 0) return true;
-  const current = source[index];
-  const previous = source[index - 1];
-  if (/[/_.\-\s]/.test(previous)) return true;
-  return previous.toLowerCase() === previous && current.toUpperCase() === current && current.toLowerCase() !== current;
-}