import { test, expect } from '@playwright/test'; import { waitForWxApp, focusCanvas, clickByTooltip, stableShot } from '../e2e/utils/element-tracker'; // Mirrors @pcbjam/shared USER_HEADER (tests/ doesn't depend on the shared pkg). const USER_HEADER = 'x-pcbjam-user'; // The reference backend serves its single project/libs under any scope. const SCOPE = 'default'; /** * 0004-D: the FULL remote write round-trip — no in-memory spike. Boot ensures a * "My Symbols" user lib via the backend's createLib; New Symbol → Ctrl+S routes * the save through window.kicadLibs.request("save") → remoteLibsSource.saveItemBody * → PUT /api/libs/:lib/items/... on the example backend. Verify the backend * persisted a valid fork-native body, then reload and confirm it enumerates. * * Requires the example backend (:3060) running with USER_LIBS_DIR set. */ const BACKEND = process.env.BACKEND_URL ?? 'http://localhost:3060'; // KNOWN-BROKEN: the fp/sym editor kicadLibs enumerate/save flows are dead // (docs/features/web-e2e-rot/01-editor-lib-bridge-flows.md). fixme, not fail: // on CI this dies in a 180s boot timeout per engine — running it buys no signal. // Probed 2026-08-13 on the JSPI build: still dead — wedges at the New Symbol/ // Footprint dialog step on BOTH engines (web-e2e-rot 01 stands for writes). test.fixme( 'symbol editor save persists to the backend (remote write round-trip)', async ({ page }) => { // Unique owner per run so the test is isolated from prior runs. const owner = `e2e-${Date.now()}`; const logs: string[] = []; page.on('console', (m) => logs.push(`[${m.type()}] ${m.text()}`)); page.on('pageerror', (e) => logs.push(`[pageerror] ${e.message}`)); await page.goto(`/default/projects/demo/-/symbol_editor?libowner=${owner}`); await waitForWxApp(page, { timeout: 150000 }); await page.waitForFunction( () => !!window.wxElementRegistry && window.wxElementRegistry.findAll({}).length > 5, null, { timeout: 150000 }, ); await page.waitForFunction(() => !!(window as any).kicadLibs, null, { timeout: 60000 }); await stableShot(page, 'symremote-01-boot.png'); // Boot's ensure-user-lib created "My Symbols" (slug my-symbols) for this owner. const ownerHeaders = { [USER_HEADER]: owner }; const libsRes = await fetch(`${BACKEND}/api/scopes/${SCOPE}/libs`, { headers: ownerHeaders }); const libsBody = (await libsRes.json()) as { id: string; type: string }[]; expect(libsBody.some((l) => l.type === 'user' && l.id === 'my-symbols'), 'user lib created at boot').toBe(true); // Select the (only) library row in the tree, then New Symbol. const hdr = await page.evaluate(() => { const rd = window.wxElementRegistry.findAllRendered({}); const h = rd.find((e: any) => e.elementType === 'columnheader' && e.label === 'Item'); return h ? { cx: h.centerX, cy: h.centerY, hgt: h.height } : null; }); expect(hdr, 'Item column header found').not.toBeNull(); await page.mouse.click(hdr!.cx, hdr!.cy + hdr!.hgt + 8); await page.waitForTimeout(200); // eslint-disable-line -- documented interaction dwell await page.keyboard.press('Home'); await page.waitForTimeout(150); // eslint-disable-line -- documented interaction dwell await page.keyboard.press('ArrowDown'); await page.waitForTimeout(150); // eslint-disable-line -- documented interaction dwell await page.keyboard.press('ArrowUp'); await page.waitForTimeout(400); // eslint-disable-line -- documented interaction dwell expect(await clickByTooltip(page, 'New Symbol...'), 'New Symbol clicked').toBe(true); await stableShot(page, 'symremote-02-newsym.png'); // Name field (the one that isn't the lib filter ~y65/87), then confirm. const nameField = await page.evaluate(() => { const all = window.wxElementRegistry.findAll({ visible: true }); const t = all .filter((e: any) => /TextCtrl/i.test(e.typeName)) .map((e: any) => ({ cx: Math.round(e.centerX), cy: Math.round(e.centerY) })) .find((e: any) => Math.abs(e.cy - 65) > 30 && Math.abs(e.cy - 87) > 30); return t ?? null; }); expect(nameField, 'New Symbol name field present').toBeTruthy(); await page.mouse.click(nameField!.cx, nameField!.cy); await page.waitForTimeout(150); // eslint-disable-line -- documented interaction dwell await page.keyboard.press('Control+a'); await page.keyboard.press('Delete'); await page.keyboard.type('RemoteRes', { delay: 40 }); await page.keyboard.press('Enter'); await stableShot(page, 'symremote-03-created.png'); // Save → PUT to the backend. await focusCanvas(page); await page.keyboard.press('Control+s'); // Poll the backend until the item lands. let items: { kind: string; name: string }[] = []; await expect .poll( async () => { const r = await fetch(`${BACKEND}/api/scopes/${SCOPE}/libs/my-symbols/items`, { headers: ownerHeaders }); items = r.ok ? ((await r.json()) as { kind: string; name: string }[]) : []; return items.length; }, { timeout: 30000, intervals: [500] }, ) .toBeGreaterThan(0); await stableShot(page, 'symremote-04-saved.png'); const saved = items[0]; logs.push(`[spec] backend item: ${JSON.stringify(saved)}`); // The persisted body is a well-formed fork-native kicad_symbol_lib. const bodyRes = await fetch( `${BACKEND}/api/scopes/${SCOPE}/libs/my-symbols/items/symbol/${encodeURIComponent(saved.name)}`, { headers: ownerHeaders }, ); const body = await bodyRes.text(); logs.push(`[spec] persisted body (${body.length} bytes):\n${body}`); expect(body).toContain('(kicad_symbol_lib'); expect(body).toContain('(version 20250925)'); expect(body).toContain(`(symbol "${saved.name}"`); // App stayed live. expect(logs.some((l) => l.includes('Aborted(')), 'no WASM abort').toBe(false); expect(new URL(page.url()).searchParams.get('oomRetry'), 'no OOM respawn').toBeNull(); console.log('--- spec log ---\n' + logs.join('\n')); });