fix: 🐛 raytrace deadlock - pre-warm 2N+8 pthread Workers

tests/kicad/utils/threed-viewer.ts

@@ -0,0 +1,97 @@
+import type { Page } from '@playwright/test';
+import { expect } from '@playwright/test';
+import { clickMenuBarItem, clickMenuItem } from '../../e2e/utils/element-tracker';
+import { injectFromSubmodule } from './fs-inject';
+import { waitForBoardLoaded } from './board-ready';
+
+// Shared helpers for the 3D-viewer specs (3d-viewer.spec.ts + 3d-viewer-deadlock.spec.ts).
+
+// KiCad 10 stores projects under /home/kicad/documents/kicad/10.0/projects.
+export const KICAD_VERSION_DIR = '10.0';
+export const PROJECT_DIR_MEMFS = `/home/kicad/documents/kicad/${KICAD_VERSION_DIR}/projects`;
+
+// pic_programmer frames correctly in the default 3D camera (the microwave demo
+// has a known board-bounding-box scale bug that projects it off-screen — a
+// separate follow-up). Loads cleanly in this harness (see 2D load tests).
+export const DEMO = { name: 'pic_programmer', dir: 'pic_programmer', stem: 'pic_programmer' } as const;
+
+export async function loadBoard(
+    page: Page,
+    testLogger: { consoleLogs: string[]; errors: string[] },
+): Promise<void> {
+    const pcbFilename = `${DEMO.stem}.kicad_pcb`;
+    const proFilename = `${DEMO.stem}.kicad_pro`;
+
+    await injectFromSubmodule(page, `kicad/demos/${DEMO.dir}/${pcbFilename}`,
+        `${PROJECT_DIR_MEMFS}/${pcbFilename}`);
+    await injectFromSubmodule(page, `kicad/demos/${DEMO.dir}/${proFilename}`,
+        `${PROJECT_DIR_MEMFS}/${proFilename}`);
+
+    expect(await clickMenuBarItem(page, 'File'), 'File menu should be findable').toBe(true);
+    await page.waitForTimeout(400);
+    expect(await clickMenuItem(page, 'Open...'), 'Open… menu item should be findable').toBe(true);
+
+    await page.waitForFunction(() => {
+        const registry = window.wxElementRegistry;
+        return !!registry && registry.findAll({ visible: true })
+            .some((el) => el.typeName === 'wxFileDialog');
+    }, null, { timeout: 15000 });
+    await page.waitForTimeout(1000);
+
+    const filenameInput = await page.evaluate(() => {
+        const registry = window.wxElementRegistry;
+        if (!registry) return null;
+        const text = registry.findAll({ visible: true })
+            .find((el) => el.typeName === 'wxTextCtrl' && el.name === 'text');
+        return text ? { x: text.centerX, y: text.centerY } : null;
+    });
+    expect(filenameInput, 'filename text input should be visible').not.toBeNull();
+    if (!filenameInput) throw new Error('filename text input not found');
+
+    await page.mouse.click(filenameInput.x, filenameInput.y);
+    await page.waitForTimeout(200);
+    await page.keyboard.type(pcbFilename);
+    await page.waitForTimeout(300);
+    await page.keyboard.press('Enter');
+    await page.waitForTimeout(1000);
+
+    const result = await waitForBoardLoaded(page, testLogger, 60000);
+    console.log(`[TEST] ${DEMO.name} board-ready result: ${result}`);
+}
+
+export function countGlCanvases(page: Page): Promise<number> {
+    return page.evaluate(() => document.querySelectorAll('canvas[id^="glcanvas-"]').length);
+}
+
+// Open the 3D viewer (View → 3D Viewer, with an Alt+3 fallback) and wait for the
+// secondary frame + its NEW `glcanvas-*` to appear. The main pcbnew board view is
+// itself a wxGLCanvas, so the viewer is detected by the GL-canvas COUNT increasing.
+// Returns the glcanvas count after opening. `glBefore` is the count beforehand.
+export async function openThreeDViewer(page: Page, glBefore: number): Promise<number> {
+    let opened = false;
+    if (await clickMenuBarItem(page, 'View')) {
+        await page.waitForTimeout(400);
+        opened = await clickMenuItem(page, '3D Viewer');
+    }
+    if (!opened) {
+        console.log('[TEST] View → 3D Viewer not found via menu; trying Alt+3');
+        await page.keyboard.press('Escape');
+        await page.waitForTimeout(200);
+        await page.keyboard.press('Alt+3');
+    }
+
+    await page.waitForFunction(() => {
+        // A new top-level window div beyond the main pcbnew frame.
+        return !!document.querySelector('#window-container [id^="window-"]')
+            || document.querySelectorAll('canvas[id^="glcanvas-"]').length > 0;
+    }, null, { timeout: 60000 });
+
+    await page.waitForFunction((before: number) =>
+        document.querySelectorAll('canvas[id^="glcanvas-"]').length > before,
+        glBefore, { timeout: 60000 });
+
+    const glAfter = await countGlCanvases(page);
+    console.log(`[TEST] glcanvas count after opening 3D viewer: ${glAfter}`);
+    expect(glAfter, 'a new WebGL canvas should appear for the 3D viewer').toBeGreaterThan(glBefore);
+    return glAfter;
+}