pcbjam/tests/kicad/gerbview.spec.ts

import { test, expect } from './fixtures';
import { waitForEditorReady, stableShot } from '../e2e/utils/element-tracker';

/**
 * Gerber Viewer (gerbview) WASM E2E Tests
 *
 * gerbview is its own standalone kiface (FRAME_GERBER), launched via single_top
 * like pcbnew/pl_editor. gerbview.html seeds a default KiCad config in preRun, so
 * the shared first-run setup wizard never opens — the viewer comes straight up.
 * Scope is launch-only: the viewer must start, paint a canvas + toolbars (incl. the
 * layers manager), populate the element registry, and produce no WASM abort.
 * Loading actual Gerber files is out of scope here.
 *
 * Determinism: no waitForTimeout, no wizard click-through loop, screenshots via
 * stableShot (stabilizes before comparing).
 *
 * The embind file-open surface (wasm/bindings/gerbview_embind.cpp) IS in scope:
 * the project page deep-links a gerber here, and the shell opens the whole
 * fabrication set through `kicadOpenFiles`.
 */

/** Minimal valid RS-274X gerber drawing one trace, so a layer really loads. */
function gerber(xEndMm: number): string {
    return [
        '%FSLAX46Y46*%',
        '%MOMM*%',
        '%ADD10C,0.200000*%',
        'D10*',
        'X10000000Y10000000D02*',
        `X${xEndMm * 1_000_000}Y10000000D01*`,
        'M02*',
        '',
    ].join('\n');
}

/** Minimal Excellon drill file — GerbView routes .drl to its own loader. */
const DRILL = ['M48', 'FMAT,2', 'METRIC', 'T1C0.800', '%', 'G90', 'G05', 'T1',
    'X20.0Y20.0', 'T0', 'M30', ''].join('\n');

function hasAbort(testLogger: { consoleLogs: string[]; errors: string[] }): boolean {
    return [...testLogger.consoleLogs, ...testLogger.errors].some(line => line.includes('Aborted('));
}

test.describe('gerbview WASM', () => {
    test.beforeEach(async ({ page }) => {
        await page.goto('/kicad/gerbview.html');
    });

    test('app loads, canvas visible, no WASM abort', async ({ page, testLogger }) => {
        await waitForEditorReady(page);
        await stableShot(page, 'gerbview-01-loaded.png');

        expect(hasAbort(testLogger), 'no WASM abort during load').toBe(false);

        const canvasCount = await page.locator('canvas').count();
        expect(canvasCount).toBeGreaterThan(0);
    });

    test('canvas + toolbar metrics look sane', async ({ page, testLogger }) => {
        await waitForEditorReady(page);

        const metrics = await page.evaluate(() => {
            const registry = window.wxElementRegistry!;
            const all = registry.findAll({ visible: true });
            const toolbars = all.filter((el) => /ToolBar/.test(el.typeName));
            const glCanvas = document.querySelector('canvas[id^="glcanvas-"]') as HTMLCanvasElement | null;

            return {
                registryTotal: all.length,
                toolbarCount: toolbars.length,
                mainCanvasOk: (() => {
                    const c = document.getElementById('canvas') as HTMLCanvasElement | null;
                    return !!c && c.width > 0 && c.height > 0;
                })(),
                glCanvasOk: !!glCanvas && glCanvas.width > 0 && glCanvas.height > 0,
            };
        });

        await stableShot(page, 'gerbview-02-metrics.png');

        expect(metrics.registryTotal, 'registry should be populated').toBeGreaterThan(10);
        expect(metrics.toolbarCount, 'at least one toolbar should be visible').toBeGreaterThanOrEqual(1);
        expect(metrics.mainCanvasOk, 'main canvas has nonzero dimensions').toBe(true);
        expect(metrics.glCanvasOk, 'GL canvas has nonzero dimensions').toBe(true);
        expect(hasAbort(testLogger)).toBe(false);
    });

    /**
     * kicadOpenFiles: the whole-set entry the project page's gerber links use.
     * A fabrication set is a stack, so opening one layer alone is not the job —
     * this asserts a multi-file open lands every layer (and the drill file) in
     * one call, which is what GERBVIEW_FRAME::OpenProjectFiles gives us.
     */
    test('kicadOpenFiles opens a whole fabrication set in one call', async ({ page, testLogger }) => {
        await waitForEditorReady(page);

        const opened = await page.evaluate(({ gerbers, drill }) => {
            const w = window as unknown as {
                FS: { mkdirTree(p: string): void; writeFile(p: string, d: string): void };
                Module: { kicadOpenFiles?: (json: string) => boolean };
            };
            const dir = '/home/kicad/documents/fab';
            w.FS.mkdirTree(dir);
            const paths: string[] = [];
            for (const [name, content] of Object.entries(gerbers)) {
                const p = `${dir}/${name}`;
                w.FS.writeFile(p, content as string);
                paths.push(p);
            }
            const drillPath = `${dir}/board-PTH.drl`;
            w.FS.writeFile(drillPath, drill);
            paths.push(drillPath);
            const registryBefore = window.wxElementRegistry!.findAll({ visible: true }).length;
            if (typeof w.Module.kicadOpenFiles !== 'function') return { hook: false, registryBefore };
            w.Module.kicadOpenFiles(JSON.stringify(paths));
            return { hook: true, registryBefore };
        }, {
            gerbers: {
                'board-F_Cu.gbr': gerber(30),
                'board-B_Cu.gbr': gerber(40),
                'board-Edge_Cuts.gbr': gerber(50),
            },
            drill: DRILL,
        });

        expect(opened.hook, 'gerbview exposes kicadOpenFiles (gerbview_embind.cpp)').toBe(true);
        // NOT the return value: OpenProjectFiles suspends via JSPI, so the
        // embind call hands back a Promise long before the load finishes
        // (same reason open-flow.ts ignores kicadOpenFile's return).
        // The truthful completion signal is the open-gate probe.
        await expect.poll(
            async () => page.evaluate(() => {
                const w = window as unknown as { Module: { kicadOpenFileBusy?: () => boolean } };
                return w.Module.kicadOpenFileBusy?.() ?? true;
            }),
            { timeout: 30000, intervals: [250] },
        ).toBe(false);

        // Each file became its own draw layer, so the UI gained rows/entries.
        expect(
            await page.evaluate(() => window.wxElementRegistry!.findAll({ visible: true }).length),
            'the layers UI grew once the set loaded',
        ).toBeGreaterThan(opened.registryBefore);

        expect(hasAbort(testLogger), 'no WASM abort during the multi-file open').toBe(false);
    });
});