@nexustools/nwjstestrunner 0.0.0-stage → 1.0.0-beta.1

package/dist/harness/graphical-overlay-view.js

@@ -0,0 +1,213 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphicalOverlayView = void 0;
+class GraphicalOverlayView {
+    options;
+    webviewEl = null;
+    titleEl = null;
+    statusEl = null;
+    metricCurrentEl = null;
+    metricPassedEl = null;
+    metricFailedEl = null;
+    progressFillEl = null;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    mount(doc = document) {
+        const title = this.options.title || '🧪 NW.js Live Webview Test Runner';
+        const enableWebview = this.options.enableWebview ?? true;
+        const partition = this.options.webviewPartition || 'trusted';
+        const allowNw = this.options.allowNwInWebview ?? true;
+        if (!doc.getElementById('nwjstestrunner-styles')) {
+            const styleEl = doc.createElement('style');
+            styleEl.id = 'nwjstestrunner-styles';
+            styleEl.textContent = `
+        body, html {
+          margin: 0;
+          padding: 0;
+          width: 100vw;
+          height: 100vh;
+          background: #11111b;
+          overflow: hidden;
+          font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, monospace;
+        }
+        #webview-container {
+          width: 100vw;
+          height: 100vh;
+          position: absolute;
+          top: 0;
+          left: 0;
+          z-index: 1;
+        }
+        webview {
+          width: 100%;
+          height: 100%;
+          border: none;
+          opacity: 0.95;
+        }
+        #test-runner-overlay {
+          pointer-events: none;
+          position: fixed;
+          top: 0;
+          left: 0;
+          width: 100vw;
+          height: 100vh;
+          z-index: 9999;
+          background: rgba(0, 0, 0, 0.28);
+          display: flex;
+          flex-direction: column;
+          align-items: center;
+          justify-content: center;
+          color: #cdd6f4;
+          text-align: center;
+        }
+        .overlay-card {
+          background: #1e1e2e;
+          border: 1px solid #313244;
+          padding: 30px 45px;
+          border-radius: 12px;
+          box-shadow: 0 10px 30px rgba(0, 0, 0, 0.55);
+          min-width: 440px;
+          max-width: 560px;
+        }
+        .overlay-title {
+          font-size: 22px;
+          font-weight: bold;
+          margin-bottom: 12px;
+          color: #cba6f7;
+        }
+        .overlay-status {
+          font-size: 14px;
+          margin-bottom: 14px;
+          color: #89b4fa;
+          font-family: monospace;
+          white-space: nowrap;
+          overflow: hidden;
+          text-overflow: ellipsis;
+          max-width: 460px;
+        }
+        .overlay-progress-track {
+          width: 100%;
+          height: 6px;
+          background: #313244;
+          border-radius: 3px;
+          overflow: hidden;
+          margin-bottom: 16px;
+        }
+        .overlay-progress-fill {
+          width: 0%;
+          height: 100%;
+          background: linear-gradient(90deg, #89b4fa, #cba6f7);
+          transition: width 0.12s ease-out;
+        }
+        .overlay-metric {
+          font-size: 18px;
+          margin: 8px 0;
+          font-weight: 600;
+          display: flex;
+          align-items: center;
+          justify-content: space-between;
+        }
+        .status-running { color: #89b4fa; }
+        .status-passed { color: #a6e3a1; }
+        .status-failed { color: #f38ba8; }
+      `;
+            doc.head.appendChild(styleEl);
+        }
+        if (enableWebview && !doc.getElementById('client-webview')) {
+            let container = doc.getElementById('webview-container');
+            if (!container) {
+                container = doc.createElement('div');
+                container.id = 'webview-container';
+                doc.body.appendChild(container);
+            }
+            const wv = doc.createElement('webview');
+            wv.id = 'client-webview';
+            if (allowNw) {
+                wv.setAttribute('allownw', '');
+            }
+            wv.setAttribute('partition', partition);
+            container.appendChild(wv);
+        }
+        if (!doc.getElementById('test-runner-overlay')) {
+            const overlay = doc.createElement('div');
+            overlay.id = 'test-runner-overlay';
+            overlay.innerHTML = `
+        <div class="overlay-card">
+          <div id="overlay-title" class="overlay-title"></div>
+          <div id="overlay-status" class="overlay-status">Initializing test harness...</div>
+          <div class="overlay-progress-track">
+            <div id="overlay-progress-fill" class="overlay-progress-fill"></div>
+          </div>
+          <div class="overlay-metric status-running">
+            <span>Completed:</span>
+            <span id="metric-current">0 of 0</span>
+          </div>
+          <div class="overlay-metric status-passed">
+            <span>✅ Tests Passed:</span>
+            <span id="metric-passed">0</span>
+          </div>
+          <div class="overlay-metric status-failed">
+            <span>❌ Tests Failed:</span>
+            <span id="metric-failed">0</span>
+          </div>
+        </div>
+      `;
+            doc.body.appendChild(overlay);
+        }
+        this.webviewEl = doc.getElementById('client-webview');
+        this.titleEl =
+            doc.getElementById('overlay-title') ||
+                doc.querySelector('#test-runner-overlay .overlay-title');
+        this.statusEl = doc.getElementById('overlay-status');
+        this.metricCurrentEl = doc.getElementById('metric-current');
+        this.metricPassedEl = doc.getElementById('metric-passed');
+        this.metricFailedEl = doc.getElementById('metric-failed');
+        this.progressFillEl = doc.getElementById('overlay-progress-fill');
+        if (this.titleEl && this.options.title) {
+            this.titleEl.textContent = title;
+        }
+        try {
+            if (this.options.title && doc.title !== this.options.title) {
+                doc.title = this.options.title;
+            }
+        }
+        catch (_e) { }
+    }
+    getWebviewElement() {
+        return this.webviewEl;
+    }
+    setTitle(title) {
+        if (this.titleEl) {
+            this.titleEl.textContent = title;
+        }
+    }
+    setStatus(statusText) {
+        if (this.statusEl) {
+            this.statusEl.textContent = statusText;
+        }
+    }
+    updateMetrics(completed, total, passed, failed) {
+        if (this.metricCurrentEl) {
+            this.metricCurrentEl.textContent = `${completed} of ${total}`;
+        }
+        if (this.metricPassedEl) {
+            this.metricPassedEl.textContent = `${passed}`;
+        }
+        if (this.metricFailedEl) {
+            this.metricFailedEl.textContent = `${failed}`;
+        }
+        if (this.progressFillEl) {
+            const pct = total > 0 ? Math.min(100, Math.round((completed / total) * 100)) : 0;
+            this.progressFillEl.style.width = `${pct}%`;
+            if (failed > 0) {
+                this.progressFillEl.style.background = 'linear-gradient(90deg, #f38ba8, #eba0ac)';
+            }
+            else if (completed >= total && total > 0) {
+                this.progressFillEl.style.background = 'linear-gradient(90deg, #a6e3a1, #94e2d5)';
+            }
+        }
+    }
+}
+exports.GraphicalOverlayView = GraphicalOverlayView;
+//# sourceMappingURL=graphical-overlay-view.js.map

package/dist/harness/graphical-overlay-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphical-overlay-view.js","sourceRoot":"","sources":["../../src/harness/graphical-overlay-view.ts"],"names":[],"mappings":"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"}

package/dist/harness/nwjs-graphical-test-harness.d.ts

@@ -0,0 +1,40 @@
+import { NwjsHarnessConfig } from '../types/test-runner-types';
+import { TestLogWriter } from './test-log-writer';
+export declare class NwjsGraphicalTestHarness {
+    private readonly config;
+    private readonly projectRootDir;
+    private readonly testSandboxDir;
+    private readonly testConfigDir;
+    private readonly logWriter;
+    private readonly overlayView;
+    private httpServer;
+    private webviewController;
+    private initTimeoutTimer;
+    private globalTimeoutTimer;
+    private hasStartedExecution;
+    private hasFinished;
+    constructor(config?: NwjsHarnessConfig);
+    private shouldEnableWebview;
+    getLogWriter(): TestLogWriter;
+    getProjectRootDir(): string;
+    getSandboxDir(): string;
+    getConfigDir(): string;
+    start(): Promise<{
+        exitCode: number;
+        logText: string;
+    }>;
+    private markExecutionStarted;
+    private setupWindowAndProcessLifecycle;
+    private startHttpServerAndNavigateWebview;
+    private prepareTestSuites;
+    private executeAllTests;
+    finishAndExit(): Promise<{
+        exitCode: number;
+        logText: string;
+    }>;
+}
+export declare function runNwjsTestHarness(config?: NwjsHarnessConfig): Promise<{
+    exitCode: number;
+    logText: string;
+}>;
+//# sourceMappingURL=nwjs-graphical-test-harness.d.ts.map

package/dist/harness/nwjs-graphical-test-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nwjs-graphical-test-harness.d.ts","sourceRoot":"","sources":["../../src/harness/nwjs-graphical-test-harness.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,iBAAiB,EAAqB,MAAM,4BAA4B,CAAC;AAGlF,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IACnD,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,iBAAiB,CAAsC;IAC/D,OAAO,CAAC,gBAAgB,CAA8C;IACtE,OAAO,CAAC,kBAAkB,CAA8C;IACxE,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,GAAE,iBAAsB;IAiC1C,OAAO,CAAC,mBAAmB;IAapB,YAAY,IAAI,aAAa;IAI7B,iBAAiB,IAAI,MAAM;IAI3B,aAAa,IAAI,MAAM;IAIvB,YAAY,IAAI,MAAM;IAIhB,KAAK,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAgFpE,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,8BAA8B;YAiCxB,iCAAiC;YAiCjC,iBAAiB;YAkDjB,eAAe;IAqHhB,aAAa,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CA4C7E;AAED,wBAAsB,kBAAkB,CACtC,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAIhD"}

package/dist/harness/nwjs-graphical-test-harness.js

@@ -0,0 +1,398 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NwjsGraphicalTestHarness = void 0;
+exports.runNwjsTestHarness = runNwjsTestHarness;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const harness_config_loader_1 = require("../config/harness-config-loader");
+const test_runner_1 = require("../core/test-runner");
+const graphical_overlay_view_1 = require("./graphical-overlay-view");
+const test_http_server_1 = require("./test-http-server");
+const test_log_writer_1 = require("./test-log-writer");
+const webview_test_controller_1 = require("./webview-test-controller");
+class NwjsGraphicalTestHarness {
+    config;
+    projectRootDir;
+    testSandboxDir;
+    testConfigDir;
+    logWriter;
+    overlayView;
+    httpServer = null;
+    webviewController = null;
+    initTimeoutTimer = null;
+    globalTimeoutTimer = null;
+    hasStartedExecution = false;
+    hasFinished = false;
+    constructor(config = {}) {
+        this.config = config;
+        this.projectRootDir = harness_config_loader_1.HarnessConfigLoader.resolveProjectRoot(config.projectRootDir);
+        const sandboxPrefix = config.sandboxPrefix || 'nwjs-webview-test-';
+        this.testSandboxDir = fs.mkdtempSync(path.join(os.tmpdir(), sandboxPrefix));
+        this.testConfigDir = path.join(this.testSandboxDir, 'os-config');
+        fs.mkdirSync(this.testConfigDir, { recursive: true });
+        const defaultLogPath = path.join(this.projectRootDir, 'testrunner', 'test-results', 'desktop-tests.log');
+        const winAny = typeof window !== 'undefined' ? window : undefined;
+        const resolvedLogPath = config.testLogPath ||
+            (winAny && winAny.__testLogPath) ||
+            process.env.NWJS_TEST_LOG_PATH ||
+            defaultLogPath;
+        const headerTitle = config.logHeaderTitle ||
+            (config.title ? `${config.title} Log` : 'NW.js Desktop Client Test Harness Log');
+        this.logWriter = new test_log_writer_1.TestLogWriter(resolvedLogPath, headerTitle);
+        this.overlayView = new graphical_overlay_view_1.GraphicalOverlayView({
+            title: config.title || '🧪 NW.js Live Webview Test Runner',
+            enableWebview: this.shouldEnableWebview()
+        });
+    }
+    shouldEnableWebview() {
+        if (typeof this.config.enableWebview === 'boolean') {
+            return this.config.enableWebview;
+        }
+        if (this.config.liveWebviewTests && this.config.liveWebviewTests.length > 0) {
+            return true;
+        }
+        if (this.config.webviewEntryHtml) {
+            return true;
+        }
+        return false;
+    }
+    getLogWriter() {
+        return this.logWriter;
+    }
+    getProjectRootDir() {
+        return this.projectRootDir;
+    }
+    getSandboxDir() {
+        return this.testSandboxDir;
+    }
+    getConfigDir() {
+        return this.testConfigDir;
+    }
+    async start() {
+        this.logWriter.writeProgressSnapshot('Tests interupted (Initializing test harness...)');
+        if (typeof document !== 'undefined') {
+            this.overlayView.mount(document);
+        }
+        this.setupWindowAndProcessLifecycle();
+        const initTimeoutMs = this.config.initTimeoutMs ?? 8000;
+        const globalTimeoutMs = this.config.globalTimeoutMs ?? 35000;
+        this.initTimeoutTimer = setTimeout(() => {
+            if (!this.hasStartedExecution && !this.hasFinished) {
+                this.logWriter.recordError('InitializationTimeout', `Tests interupted: Test runner failed to initialize within ${initTimeoutMs}ms.`);
+                this.finishAndExit();
+            }
+        }, initTimeoutMs);
+        this.globalTimeoutTimer = setTimeout(() => {
+            if (!this.hasFinished) {
+                this.logWriter.recordError('GlobalHarnessTimeout', `Test runner harness timed out after ${globalTimeoutMs}ms.`);
+                this.finishAndExit();
+            }
+        }, globalTimeoutMs);
+        try {
+            await this.prepareTestSuites();
+            if (this.shouldEnableWebview() && typeof document !== 'undefined') {
+                const webviewEl = this.overlayView.getWebviewElement();
+                if (!webviewEl) {
+                    this.logWriter.recordError('WebviewElementMissing', 'Expected #client-webview element in DOM when enableWebview is true');
+                    return await this.finishAndExit();
+                }
+                this.webviewController = new webview_test_controller_1.WebviewTestController(webviewEl, {
+                    consoleErrorLevel: this.config.webviewConsoleErrorLevel ?? 2,
+                    onError: (source, err) => this.logWriter.recordError(source, err),
+                    onLoadAbort: () => {
+                        this.finishAndExit();
+                    }
+                });
+                return await new Promise((resolve) => {
+                    this.webviewController.attachEventListeners(() => {
+                        if (this.hasStartedExecution)
+                            return;
+                        this.markExecutionStarted();
+                        this.executeAllTests()
+                            .then((res) => resolve(res))
+                            .catch((err) => {
+                            this.logWriter.recordError('TestRunnerExecution', err);
+                            this.finishAndExit().then(resolve);
+                        });
+                    });
+                    this.startHttpServerAndNavigateWebview().catch((err) => {
+                        this.logWriter.recordError('HttpServerStartError', err);
+                        this.finishAndExit().then(resolve);
+                    });
+                });
+            }
+            else {
+                this.markExecutionStarted();
+                return await this.executeAllTests();
+            }
+        }
+        catch (err) {
+            this.logWriter.recordError('TopLevelHarnessError', err);
+            return await this.finishAndExit();
+        }
+    }
+    markExecutionStarted() {
+        this.hasStartedExecution = true;
+        if (this.initTimeoutTimer) {
+            clearTimeout(this.initTimeoutTimer);
+            this.initTimeoutTimer = null;
+        }
+        if (typeof window !== 'undefined') {
+            const winAny = window;
+            winAny.__harnessInitialized = true;
+            if (winAny.__initWatchdogTimer) {
+                clearTimeout(winAny.__initWatchdogTimer);
+            }
+        }
+    }
+    setupWindowAndProcessLifecycle() {
+        try {
+            const nwGlobal = typeof globalThis.nw !== 'undefined' ? globalThis.nw : undefined;
+            if (nwGlobal && nwGlobal.Window && typeof nwGlobal.Window.get === 'function') {
+                const win = nwGlobal.Window.get();
+                win.on('close', () => {
+                    if (!this.hasFinished) {
+                        const m = this.logWriter.getMetrics();
+                        this.logWriter.writeProgressSnapshot(`Tests interupted (Closed by user at ${m.passedCount + m.failedCount} of ${m.totalTests})`);
+                    }
+                    try {
+                        win.close(true);
+                    }
+                    catch (_e) { }
+                    process.exit(1);
+                });
+            }
+        }
+        catch (_e) { }
+        if (typeof window !== 'undefined') {
+            window.onerror = (message, _source, _lineno, _colno, error) => {
+                this.logWriter.recordError('HostWindowOnError', error || message);
+                this.finishAndExit();
+            };
+            window.addEventListener('unhandledrejection', (e) => {
+                this.logWriter.recordError('HostUnhandledRejection', e.reason);
+                this.finishAndExit();
+            });
+        }
+    }
+    async startHttpServerAndNavigateWebview() {
+        const entryHtml = this.config.webviewEntryHtml || 'index.html';
+        this.httpServer = new test_http_server_1.TestHttpServer({
+            projectRootDir: this.projectRootDir,
+            defaultEntryFile: entryHtml,
+            ignore404Paths: this.config.ignore404Paths,
+            routeHandler: this.config.httpRouteHandler,
+            onHttp404: (reqPath, resolvedFilePath) => {
+                this.logWriter.recordError('Http404Error', `HTTP 404 Not Found: ${reqPath} (resolved: ${resolvedFilePath})`);
+            }
+        });
+        const port = await this.httpServer.start();
+        const queryParams = new URLSearchParams();
+        if (this.config.injectSandboxQueryParams !== false) {
+            queryParams.set('projectRoot', this.testSandboxDir);
+            queryParams.set('configDir', this.testConfigDir);
+        }
+        if (this.config.webviewQueryParams) {
+            for (const [k, v] of Object.entries(this.config.webviewQueryParams)) {
+                queryParams.set(k, v);
+            }
+        }
+        const cleanEntry = entryHtml.startsWith('/') ? entryHtml.slice(1) : entryHtml;
+        const qs = queryParams.toString();
+        const targetUrl = `http://127.0.0.1:${port}/${cleanEntry}${qs ? `?${qs}` : ''}`;
+        this.webviewController?.navigate(targetUrl);
+    }
+    async prepareTestSuites() {
+        (0, test_runner_1.installJestGlobals)(globalThis);
+        if (typeof window !== 'undefined') {
+            (0, test_runner_1.installJestGlobals)(window);
+        }
+        const runner = test_runner_1.TestRunner.getInstance();
+        runner.reset();
+        const context = {
+            projectRootDir: this.projectRootDir,
+            sandboxDir: this.testSandboxDir,
+            configDir: this.testConfigDir
+        };
+        if (this.config.registerSuites) {
+            await this.config.registerSuites(runner, context);
+        }
+        const shouldLoadFiles = (this.config.testFiles && this.config.testFiles.length > 0) || !this.config.registerSuites;
+        if (shouldLoadFiles) {
+            const files = harness_config_loader_1.HarnessConfigLoader.resolveTestFiles(this.projectRootDir, this.config.testFiles);
+            for (const filePath of files) {
+                try {
+                    delete require.cache[require.resolve(filePath)];
+                }
+                catch (_e) { }
+                const mod = require(filePath);
+                if (typeof mod === 'function') {
+                    await mod(runner, context);
+                }
+                else if (mod && typeof mod === 'object') {
+                    for (const [exportName, exportVal] of Object.entries(mod)) {
+                        if (typeof exportVal === 'function' &&
+                            (exportName === 'registerSuites' ||
+                                exportName === 'registerTestSuites' ||
+                                (/^register.*Suites$/i.test(exportName)))) {
+                            await exportVal(runner, context);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    async executeAllTests() {
+        try {
+            const runner = test_runner_1.TestRunner.getInstance();
+            const liveTests = this.config.liveWebviewTests || [];
+            const unitCount = runner.totalCasesCount;
+            const totalTests = unitCount + liveTests.length;
+            this.logWriter.setTotalTests(totalTests);
+            this.overlayView.updateMetrics(0, totalTests, 0, 0);
+            this.overlayView.setStatus(`Running ${totalTests} tests...`);
+            this.logWriter.writeProgressSnapshot(`Tests interupted (Running unit suites: 0 of ${totalTests})`);
+            if (this.webviewController && this.shouldEnableWebview()) {
+                const screenLoaded = await this.webviewController.waitForScreenLoad(this.config.screenLoadOptions);
+                if (!screenLoaded) {
+                    this.logWriter.recordError('WebviewScreenTimeout', 'Client screen inside webview failed readiness check within timeout.');
+                }
+            }
+            if (unitCount > 0) {
+                const jestSummary = await runner.runAll({
+                    maxDurationMs: this.config.unitSuiteTimeoutMs ?? 15000,
+                    defaultTestTimeoutMs: this.config.defaultTestTimeoutMs ?? 2000,
+                    filter: this.config.testFilter,
+                    onProgress: (ev) => {
+                        if (ev.type === 'test_start') {
+                            this.overlayView.setStatus(`Running: ${ev.suiteName} > ${ev.testName}`);
+                        }
+                        else if (ev.type === 'test_complete') {
+                            this.logWriter.setCounts(ev.passedCount, ev.failedCount);
+                            this.overlayView.updateMetrics(ev.completedCount, totalTests, ev.passedCount, ev.failedCount);
+                            this.logWriter.writeProgressSnapshot(`Tests interupted (Running unit suites: ${ev.completedCount} of ${totalTests})`);
+                        }
+                    }
+                });
+                this.logWriter.setCounts(jestSummary.passed, jestSummary.failed);
+                this.overlayView.updateMetrics(jestSummary.passed + jestSummary.failed, totalTests, jestSummary.passed, jestSummary.failed);
+                this.logWriter.writeProgressSnapshot(`Tests interupted (Completed unit suites: ${jestSummary.passed + jestSummary.failed} of ${totalTests})`);
+                if (jestSummary.failures && jestSummary.failures.length > 0) {
+                    for (const f of jestSummary.failures) {
+                        this.logWriter.recordError(`JestSuite[${f.suiteName}]`, `${f.testName} -> ${f.error?.message || f.error}`);
+                    }
+                }
+            }
+            if (this.webviewController && liveTests.length > 0) {
+                const totalLive = liveTests.length;
+                for (let i = 0; i < totalLive; i++) {
+                    const spec = liveTests[i];
+                    const completedSoFar = unitCount + i + 1;
+                    this.overlayView.setStatus(`Running [${i + 1}/${totalLive}]: ${spec.name}`);
+                    this.logWriter.writeProgressSnapshot(`Tests interupted (Running live test [${i + 1}/${totalLive}]: ${spec.id})`);
+                    const res = await this.webviewController.executeWebviewTest(spec.code, spec.timeoutMs ?? 4000);
+                    if (res.ok) {
+                        this.logWriter.incrementPassed(1);
+                    }
+                    else {
+                        this.logWriter.incrementFailed(1);
+                        const errs = res.errors && res.errors.length > 0
+                            ? res.errors
+                            : [res.error || 'Unknown webview test error'];
+                        for (const err of errs) {
+                            this.logWriter.recordError(spec.id, err);
+                        }
+                    }
+                    const m = this.logWriter.getMetrics();
+                    this.overlayView.updateMetrics(completedSoFar, totalTests, m.passedCount, m.failedCount);
+                }
+            }
+            const finalMetrics = this.logWriter.getMetrics();
+            this.overlayView.setStatus('All tests completed!');
+            this.overlayView.updateMetrics(totalTests, totalTests, finalMetrics.passedCount, finalMetrics.failedCount);
+        }
+        catch (err) {
+            this.logWriter.recordError('TestRunnerExecution', err);
+        }
+        return await this.finishAndExit();
+    }
+    async finishAndExit() {
+        if (this.hasFinished) {
+            return this.logWriter.writeFinalSummary();
+        }
+        this.hasFinished = true;
+        if (typeof window !== 'undefined') {
+            window.__harnessCompleted = true;
+            if (window.__initWatchdogTimer) {
+                clearTimeout(window.__initWatchdogTimer);
+            }
+        }
+        if (this.initTimeoutTimer) {
+            clearTimeout(this.initTimeoutTimer);
+            this.initTimeoutTimer = null;
+        }
+        if (this.globalTimeoutTimer) {
+            clearTimeout(this.globalTimeoutTimer);
+            this.globalTimeoutTimer = null;
+        }
+        if (this.httpServer) {
+            await this.httpServer.stop();
+            this.httpServer = null;
+        }
+        try {
+            if (this.testSandboxDir && fs.existsSync(this.testSandboxDir)) {
+                fs.rmSync(this.testSandboxDir, { recursive: true, force: true });
+            }
+        }
+        catch (_e) { }
+        const result = this.logWriter.writeFinalSummary();
+        console.log(`Test runner finished with exit code ${result.exitCode}`);
+        const autoExit = this.config.autoExit ?? true;
+        const keepOpen = this.config.keepOpen ?? false;
+        if (autoExit && !keepOpen) {
+            process.exit(result.exitCode);
+        }
+        return result;
+    }
+}
+exports.NwjsGraphicalTestHarness = NwjsGraphicalTestHarness;
+async function runNwjsTestHarness(config) {
+    const effectiveConfig = config || harness_config_loader_1.HarnessConfigLoader.loadConfig();
+    const harness = new NwjsGraphicalTestHarness(effectiveConfig);
+    return harness.start();
+}
+//# sourceMappingURL=nwjs-graphical-test-harness.js.map