#!/usr/bin/env node /** * Rendered acceptance for UTILITIES ▸ Import: real files through the real file * input and a real drop, read in the page and drawn through the renderer's * draw sets. * * Proves: GeoJSON, KML, KMZ (with a packed icon and ground overlay) and GPX * each become one row and its own draw sets; the imported shape actually paints * on the globe in its row's color (a GeoJSON `stroke`/`fill` does not override * it) and stops painting when hidden; no import makes the page request * anything named in it (network link, remote icon, remote style, palette * icon, balloon or extended-data HTML, maki marker) or anything outside the * page for it; no drawn item keeps more than its name; dated KML and GPX * leave the app's clock alone and still draw now; a GPX track keeps its two * segments apart; keyboard focus survives hide/show; a dropped file imports * like a picked one; a file that is not geodata is refused with a reason and * leaves nothing behind; Remove takes every draw set away; no page errors. * * Usage: dev server up (`npm run dev`), then `node scripts/qa-geo-import.mjs`. * QA_BASE_URL (default http://localhost:4173), QA_SHOT_DIR, QA_HEADFUL=1. */ import fs from 'node:fs'; import os from 'node:os'; import path from 'node:path'; import puppeteer from 'puppeteer'; import { hookRenderErrors, readRenderErrors } from './qa-browserEvidence.mjs'; const BASE_URL = process.env.QA_BASE_URL || 'http://localhost:4173'; const SHOT_DIR = process.env.QA_SHOT_DIR || 'qa-shots/geo-import'; const HEADFUL = process.env.QA_HEADFUL === '1'; // Golden Gate Park: a big, flat, green rectangle the test polygon can cover. const VIEW = { lon: -122.4862, lat: 37.7694, height: 4200, pitch: -88 }; const TRAP_HOST = 'gev-qa-trap.invalid'; /* ── fixtures ──────────────────────────────────────────────────────────── */ const ring = [ [-122.511, 37.7645], [-122.4545, 37.7645], [-122.4545, 37.7745], [-122.511, 37.7745], [-122.511, 37.7645], ]; const geojson = JSON.stringify({ type: 'FeatureCollection', features: [ { type: 'Feature', // A file's own simplestyle and HTML must not survive the import. properties: { name: 'QA park', stroke: '#ff0000', fill: '#ff0000', 'fill-opacity': 1, description: ``, }, geometry: { type: 'Polygon', coordinates: [ring.map((p) => [...p, 0])] }, }, { type: 'Feature', properties: { name: 'QA pin', 'marker-symbol': 'rail' }, geometry: { type: 'Point', coordinates: [-122.4862, 37.7694, 0] }, }, ], }); const kml = (iconHref) => ` https://${TRAP_HOST}/link.kml QA KML pin#s ]]> 2019-01-01T00:00:00Z2019-01-02T00:00:00Z ]]> -122.47,37.77,0 QA palette pin#palette -122.48,37.771,0 QA moving 2019-01-01T00:00:00Z2019-01-01T01:00:00Z -122.49 37.767 0-122.475 37.772 0 QA split tracks -122.50 37.767 0-122.49 37.768 0 -122.47 37.771 0-122.46 37.772 0 QA remote stylehttps://${TRAP_HOST}/styles.kml#x -122.50,37.766 -122.46,37.772 https://${TRAP_HOST}/overlay.png 37.7737.76-122.46-122.47 `; const gpx = ` QA waypoint QA track<img src="https://${TRAP_HOST}/gpx.png"> `; // 1×1 PNG. const PNG = Buffer.from( 'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8DwHwAFBQIAX8jx0gAAAABJRU5ErkJggg==', 'base64', ); /** Stored (uncompressed) zip — enough for a KMZ fixture. */ function storedZip(files) { const parts = []; const central = []; let offset = 0; for (const [name, data] of files) { const n = Buffer.from(name); const local = Buffer.alloc(30); local.writeUInt32LE(0x04034b50, 0); local.writeUInt32LE(data.length, 18); local.writeUInt32LE(data.length, 22); local.writeUInt16LE(n.length, 26); const c = Buffer.alloc(46); c.writeUInt32LE(0x02014b50, 0); c.writeUInt32LE(data.length, 20); c.writeUInt32LE(data.length, 24); c.writeUInt16LE(n.length, 28); c.writeUInt32LE(offset, 42); parts.push(local, n, data); central.push(c, n); offset += 30 + n.length + data.length; } const dir = Buffer.concat(central); const end = Buffer.alloc(22); end.writeUInt32LE(0x06054b50, 0); end.writeUInt16LE(files.length, 8); end.writeUInt16LE(files.length, 10); end.writeUInt32LE(dir.length, 12); end.writeUInt32LE(offset, 16); return Buffer.concat([...parts, dir, end]); } const kmzDoc = kml('files/pin.png').replace( `https://${TRAP_HOST}/overlay.png`, 'files/overlay.png', ); const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'gev-qa-geo-import-')); const fixture = (name, data) => { const file = path.join(dir, name); fs.writeFileSync(file, data); return file; }; const FILES = [ fixture('park.geojson', geojson), fixture('remote-bits.kml', kml(`https://${TRAP_HOST}/icon.png`)), fixture( 'packed.kmz', storedZip([ ['doc.kml', Buffer.from(kmzDoc)], ['files/pin.png', PNG], ['files/overlay.png', PNG], ]), ), fixture('walk.gpx', gpx), ]; /* ── harness ───────────────────────────────────────────────────────────── */ const browser = await puppeteer.launch({ headless: !HEADFUL, args: [ '--no-sandbox', '--disable-background-timer-throttling', '--disable-renderer-backgrounding', ...(process.platform === 'darwin' ? ['--use-angle=metal', '--enable-gpu'] : ['--use-gl=angle', '--use-angle=swiftshader']), ], }); const page = await browser.newPage(); await hookRenderErrors(page); const errors = []; const trapped = []; page.on('pageerror', (error) => errors.push(`pageerror: ${error.message}`)); page.on('console', (message) => { if (/Ignoring clampToGround/.test(message.text())) errors.push(message.text()); }); // Anything a file names, and the icon assets a KML or GeoJSON reader could // load on a file's behalf (KML palette icons from maps.google.com, GeoJSON // maki markers). const FILE_FETCH = [TRAP_HOST, 'maps.google.com/mapfiles', '/maki/']; page.on('request', (request) => { if (FILE_FETCH.some((needle) => request.url().includes(needle))) trapped.push(request.url()); }); let failures = 0; function check(name, passed, detail = '') { console.log( `[${passed ? 'PASS' : 'FAIL'}] ${name}${detail ? ` — ${detail}` : ''}`, ); if (!passed) failures++; } fs.mkdirSync(SHOT_DIR, { recursive: true }); const shot = (name) => page.screenshot({ path: path.join(SHOT_DIR, `${name}.jpg`), type: 'jpeg', quality: 82, }); const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms)); const CLIP = { x: 380, y: 240, width: 480, height: 320 }; /** Pixels in the clip close to the first import color (#39d0ff). */ async function cyanPixels() { await page.evaluate(() => window.__godsEyeView.viewer.scene.requestRender()); await wait(600); const base64 = await page.screenshot({ clip: CLIP, type: 'png', encoding: 'base64', }); return page.evaluate(async (b64) => { const bitmap = await createImageBitmap( await (await fetch(`data:image/png;base64,${b64}`)).blob(), ); const canvas = new OffscreenCanvas(bitmap.width, bitmap.height); const context = canvas.getContext('2d'); context.drawImage(bitmap, 0, 0); const { data } = context.getImageData(0, 0, bitmap.width, bitmap.height); let n = 0; for (let i = 0; i < data.length; i += 4) { const [r, g, b] = [data[i], data[i + 1], data[i + 2]]; if (b > 45 && g > 30 && r < 100 && b - r > 30) n += 1; } return n; }, base64); } const state = () => page.evaluate(() => ({ files: window.__gevGeoImport.list(), // The draw sets' hosts among the scene's primitives. dataSources: (() => { const primitives = window.__godsEyeView.viewer.scene.primitives; let n = 0; for (let i = 0; i < primitives.length; i++) if (String(primitives.get(i).drawSetId).startsWith('geo-import:')) n += 1; return n; })(), rows: document.querySelectorAll('#geo-import-list .geo-import-row').length, hint: document.getElementById('geo-import-hint')?.textContent || '', })); try { await page.setViewport({ width: 1280, height: 860 }); await page.goto(`${BASE_URL}/?welcome=0`, { waitUntil: 'domcontentloaded' }); await page.waitForFunction( () => window.__gevGeoImport && window.__godsEyeView?.viewer && document.getElementById('loading-screen')?.classList.contains('hidden'), { timeout: 90_000 }, ); await page.evaluate(async (view) => { const viewer = window.__godsEyeView.viewer; for (const id of window.__godsEyeView.dataManager.layers.keys()) await window.__godsEyeView.dataManager.setEnabled(id, false); viewer.imageryLayers.removeAll(); viewer.terrainProvider = new window.__CESIUM__.EllipsoidTerrainProvider(); viewer.scene.globe.baseColor = window.__CESIUM__.Color.BLACK; viewer.scene.globe.enableLighting = false; viewer.camera.cancelFlight?.(); viewer.camera.setView({ destination: window.__CESIUM__.Cartesian3.fromDegrees( view.lon, view.lat, view.height, ), orientation: { heading: 0, pitch: (view.pitch * Math.PI) / 180, roll: 0 }, }); viewer.scene.requestRender(); }, VIEW); await wait(4000); await page.evaluate(() => { const panel = document.getElementById('utilities-panel'); if (panel?.classList.contains('collapsed')) document .querySelector( '.panel-collapse-btn[data-collapse-target="utilities-panel"]', ) ?.click(); }); await page.waitForFunction( () => document.getElementById('geo-import-button')?.getBoundingClientRect() .width > 0, { timeout: 10_000 }, ); const before = await state(); check( 'Import is in the UTILITIES panel with an empty, hidden list', before.rows === 0 && !(await page.evaluate(() => document .getElementById('geo-import-list') .classList.contains('visible'), )), ); const cyanBefore = await cyanPixels(); await page.evaluate(() => { window.__godsEyeView.viewer.clock.shouldAnimate = false; }); const clock = () => page.evaluate(() => { const c = window.__godsEyeView.viewer.clock; const iso = (t) => window.__CESIUM__.JulianDate.toIso8601(t, 0); return { start: iso(c.startTime), stop: iso(c.stopTime), range: c.clockRange, step: c.clockStep, multiplier: c.multiplier, animate: c.shouldAnimate, // Wall-clock drift aside, the current time must not jump to 2018/2019. currentTime: window.__CESIUM__.JulianDate.toIso8601(c.currentTime), }; }); const clockBefore = await clock(); // Picked through the real . const input = await page.$('#geo-import-input'); await input.uploadFile(...FILES); const imported = await page .waitForFunction(() => window.__gevGeoImport.list().length === 4, { timeout: 60_000, }) .then( () => true, () => false, ); const after = await state(); check( 'four picked files become four rows and their draw sets', imported && after.rows === 4 && // Each file draws in up to three sets: pins, lines and shapes. after.dataSources >= before.dataSources + 4, JSON.stringify( after.files.map((f) => `${f.name}:${f.format}:${f.entityCount}`), ), ); check( 'formats are recognized', after.files.map((f) => f.format).join() === 'geojson,kml,kmz,gpx', ); check( 'the KML and KMZ had their outside references removed', after.files[1].removed > 0 && after.files[2].removed > 0, `removed ${after.files[1].removed}/${after.files[2].removed}`, ); check( 'the hint says so', /Added 4 files\..*left out/.test(after.hint), after.hint, ); const clockAfter = await clock(); check( "dated KML and GPX leave the app's clock alone", JSON.stringify(clockAfter) === JSON.stringify(clockBefore) && (await page.evaluate( () => window.__godsEyeView.viewer.clockTrackedDataSource?.clock === undefined, )), `${JSON.stringify(clockBefore)} → ${JSON.stringify(clockAfter)}`, ); const inside = await page.evaluate(() => { const tool = window.__gevGeoImport; const drawn = tool.list().map((f) => tool.drawn(f.id)); const itemsOf = (d) => [...d.icons, ...d.lines, ...d.shapes]; const items = drawn.flatMap(itemsOf); const [park, kml, kmz, gpx] = drawn; return { sources: drawn.length, clocks: 0, // Anything a drawn item carries beyond its name. described: items.filter((i) => Object.keys(i.meta ?? {}).some((key) => key !== 'name'), ).length, labelled: 0, withProperties: 0, withKml: 0, hidden: drawn.filter((d) => !d.show).length, datedPinNow: kml.icons.some((i) => i.meta?.name === 'QA KML pin'), fallbackPins: ['QA KML pin', 'QA palette pin'].filter((name) => kml.icons.some((i) => i.meta?.name === name && i.image), ).length, movingIsLine: kml.lines.filter((l) => l.meta?.name === 'QA moving').length === 1 && !kml.icons.some((i) => i.meta?.name === 'QA moving'), movingVertices: kml.lines.find((l) => l.meta?.name === 'QA moving') ?.positions.length, splitTracks: kml.lines .filter((l) => l.meta?.name === 'QA split tracks') .map((l) => l.positions.length), gpxLines: gpx.lines.length, gpxPoints: gpx.icons.length, kmzLocalImage: kmz.icons.some((i) => String(i.image || '').startsWith('blob:'), ), kmzOverlay: kmz.shapes.some((s) => s.geometry.kind === 'rectangle'), groundedLines: [kml, kmz].every((d) => d.lines.every((l) => l.mode === 'draped'), ), xyzPolygon: park.shapes.every( (s) => s.geometry.kind !== 'polygon' || !s.geometry.perPositionHeight, ), }; }); check( 'no drawn item keeps a description, label, properties or KML data', inside.sources === 4 && inside.described + inside.labelled + inside.withProperties + inside.withKml === 0, JSON.stringify(inside), ); check( 'no import has a clock, and dated features draw now', inside.clocks === 0 && inside.hidden === 0 && inside.datedPinNow && inside.movingIsLine && inside.movingVertices === 2, JSON.stringify(inside), ); check( 'blocked KML icon sources use drawable local fallback pins', inside.fallbackPins === 2, JSON.stringify({ fallbackPins: inside.fallbackPins }), ); check( 'KML MultiTrack keeps its segments and original vertex count', inside.splitTracks.join() === '2,2', JSON.stringify(inside.splitTracks), ); check( 'the GPX track keeps its two segments apart', inside.gpxLines === 2 && inside.gpxPoints === 1, JSON.stringify(inside), ); check( 'KMZ retains its own packed image and overlay', inside.kmzLocalImage && inside.kmzOverlay, ); check( 'XYZ polygons and KML/KMZ lines use ground geometry', inside.xyzPolygon && inside.groundedLines, ); // The GeoJSON's pin is off for the pixel count: only its polygon counts. await page.evaluate(() => { const tool = window.__gevGeoImport; const { sets } = tool.drawn(tool.list()[0].id); const primitives = window.__godsEyeView.viewer.scene.primitives; for (let i = 0; i < primitives.length; i++) if (primitives.get(i).drawSetId === sets.icons) primitives.get(i).show = false; }); await page.evaluate((view) => { const viewer = window.__godsEyeView.viewer; viewer.camera.cancelFlight?.(); viewer.camera.setView({ destination: window.__CESIUM__.Cartesian3.fromDegrees( view.lon, view.lat, view.height, ), orientation: { heading: 0, pitch: (view.pitch * Math.PI) / 180, roll: 0 }, }); }, VIEW); await wait(2500); const cyanShown = await cyanPixels(); await shot('imported'); check( 'the imported polygon paints on the globe', cyanShown > cyanBefore * 4 && cyanShown > cyanBefore + 5000, `${cyanBefore} → ${cyanShown}`, ); const parkId = after.files[0].id; await page.click( `#geo-import-list [data-import-id="${parkId}"] button[data-action="toggle"]`, ); const cyanHidden = await cyanPixels(); check( 'hiding it stops it painting', cyanHidden < cyanShown / 3, `${cyanShown} → ${cyanHidden}`, ); await page.click( `#geo-import-list [data-import-id="${parkId}"] button[data-action="toggle"]`, ); check( 'showing it again paints it again', (await cyanPixels()) > cyanHidden * 4, ); // Keyboard: focus stays on the same control when the list is rebuilt. const toggleSelector = `#geo-import-list [data-import-id="${parkId}"] button[data-action="toggle"]`; await page.focus(toggleSelector); await page.keyboard.press('Enter'); const focusAfterHide = await page.evaluate( (sel) => document.activeElement === document.querySelector(sel), toggleSelector, ); await page.keyboard.press('Enter'); const focusAfterShow = await page.evaluate( (sel) => document.activeElement === document.querySelector(sel) && document.activeElement.getAttribute('aria-pressed') === 'true', toggleSelector, ); check( 'keyboard focus stays on the toggle through hide and show', focusAfterHide && focusAfterShow, ); // Dropped onto the globe, as a person drags from their file manager. await page.evaluate((text) => { const container = window.__godsEyeView.viewer.container; const transfer = new DataTransfer(); transfer.items.add( new File([text], 'dropped.geojson', { type: 'application/geo+json' }), ); for (const type of ['dragenter', 'dragover', 'drop']) container.dispatchEvent( new DragEvent(type, { dataTransfer: transfer, bubbles: true, cancelable: true, }), ); }, geojson); const dropped = await page .waitForFunction(() => window.__gevGeoImport.list().length === 5, { timeout: 20_000, }) .then( () => true, () => false, ); check('a file dropped on the globe imports', dropped); // Not geodata: refused with a reason, nothing added. await page.evaluate(() => { const transfer = new DataTransfer(); transfer.items.add( new File(['just some notes'], 'notes.txt', { type: 'text/plain' }), ); window.__godsEyeView.viewer.container.dispatchEvent( new DragEvent('drop', { dataTransfer: transfer, bubbles: true, cancelable: true, }), ); }); await wait(800); const refused = await state(); check( 'a file that is not geodata is refused with a reason', refused.files.length === 5 && /notes\.txt: Only GeoJSON, KML, KMZ and GPX/.test(refused.hint), refused.hint, ); // Remove every file through its row button. for (const { id } of refused.files) await page.click( `#geo-import-list [data-import-id="${id}"] button[data-action="remove"]`, ); const cleared = await state(); check( 'Remove takes every draw set away', cleared.rows === 0 && cleared.dataSources === before.dataSources, `${cleared.dataSources} vs ${before.dataSources}`, ); await wait(1500); check( 'nothing named inside a file, and no icon asset for one, was ever requested', trapped.length === 0, trapped.join(' '), ); errors.push(...(await readRenderErrors(page))); check('no page or rendering errors', errors.length === 0, errors.join(' | ')); } catch (error) { check('harness ran to completion', false, error?.stack || String(error)); } finally { await browser.close(); fs.rmSync(dir, { recursive: true, force: true }); } console.log(failures ? `\n${failures} check(s) failed` : '\nall checks passed'); process.exit(failures ? 1 : 0);