import test from 'node:test'; import assert from 'node:assert/strict'; import { readFileSync } from 'node:fs'; import { registerSpriteCollection, restoreSpriteOrder, restoreSpriteOrderOnEnable, unregisterSpriteCollection, } from './spriteOrder.js'; import flightsLayer from './flights.js'; import aisLiveVesselsLayer from './aisLiveVessels.js'; import { createFirmsHeatmapLayer } from './firmsHeatmap.js'; const ORDER = ['cctv', 'firms', 'bikeshare', 'ais', 'military', 'flights']; function makePrimitives(initial = []) { return { items: [...initial], calls: [], contains(collection) { return this.items.includes(collection); }, raiseToTop(collection) { this.calls.push(collection.id); const index = this.items.indexOf(collection); if (index >= 0) this.items.splice(index, 1); this.items.push(collection); }, }; } function makeCollection(id, destroyed = false) { return { id, isDestroyed: () => destroyed }; } test('restoreSpriteOrder raises live collections bottom-to-top and skips destroyed entries', () => { const collections = Object.fromEntries(ORDER.map((id) => [id, makeCollection(id)])); const destroyedFirms = makeCollection('firms', true); for (const id of ORDER) { registerSpriteCollection(id, id === 'firms' ? destroyedFirms : collections[id]); } const primitives = makePrimitives([ collections.flights, collections.ais, collections.cctv, collections.bikeshare, collections.military, ]); restoreSpriteOrder({ scene: { primitives } }); assert.deepEqual(primitives.calls, ['cctv', 'bikeshare', 'ais', 'military', 'flights']); assert.deepEqual(primitives.items.map((item) => item.id), [ 'cctv', 'bikeshare', 'ais', 'military', 'flights', ]); for (const id of ORDER) unregisterSpriteCollection(id); }); test('late CCTV registration still restores flights above the ambient collection', () => { const flights = makeCollection('flights'); const cctv = makeCollection('cctv'); const primitives = makePrimitives([flights]); const viewer = { scene: { primitives } }; registerSpriteCollection('flights', flights); restoreSpriteOrder(viewer); primitives.items.push(cctv); // CCTV enabled after flights: it starts on top. registerSpriteCollection('cctv', cctv); primitives.calls.length = 0; restoreSpriteOrder(viewer); assert.deepEqual(primitives.calls, ['cctv', 'flights']); assert.deepEqual(primitives.items.map((item) => item.id), ['cctv', 'flights']); unregisterSpriteCollection('cctv', cctv); unregisterSpriteCollection('flights', flights); }); test('restoreSpriteOrder is inert for destroyed viewers and primitive collections', () => { const flights = makeCollection('flights'); const primitives = makePrimitives([flights]); registerSpriteCollection('flights', flights); restoreSpriteOrder({ isDestroyed: () => true, scene: { primitives } }); restoreSpriteOrder({ scene: { primitives: { ...primitives, isDestroyed: () => true } } }); assert.deepEqual(primitives.calls, []); unregisterSpriteCollection('flights', flights); }); test('restoreSpriteOrder never raises a registered collection absent from scene primitives', () => { const flights = makeCollection('flights'); const primitives = makePrimitives([]); registerSpriteCollection('flights', flights); restoreSpriteOrder({ scene: { primitives } }); assert.deepEqual(primitives.calls, []); assert.deepEqual(primitives.items, []); unregisterSpriteCollection('flights', flights); }); test('flights, AIS, and FIRMS enable paths are wired through the shared sprite restorer', () => { const viewer = { id: 'viewer' }; const calls = []; const restoreSpy = (value) => calls.push(value); for (const layerId of ['flights', 'ais', 'firms']) { restoreSpriteOrderOnEnable(layerId, viewer, restoreSpy); } assert.deepEqual(calls, [viewer, viewer, viewer]); const firmsLayer = createFirmsHeatmapLayer({ id: 'firms', name: 'FIRMS' }); // Flights draws through its renderer (phase 3): enable asks the fleet to // restore its order, which the Cesium aircraft renderer wires to the shared // restorer under the flights' sprite slot. assert.match(flightsLayer.enable.toString(), /fleet\.restoreOrderOnEnable\(\)/); assert.match( readFileSync(new URL('../layers/aircraft/render/cesium.js', import.meta.url), 'utf8'), /restoreOrderOnEnable: \(\) => restoreSpriteOrderOnEnable\(spriteLayer, viewer\)/, ); assert.match( readFileSync(new URL('../layers/flights/render/cesium.js', import.meta.url), 'utf8'), /spriteLayer: 'flights'/, ); assert.match(aisLiveVesselsLayer.enable.toString(), /restoreSpriteOrderOnEnable\('ais', activeViewer\)/); assert.match( firmsLayer.enable.toString(), /renderer\.onEnable\(\)/, ); assert.match( readFileSync( new URL('../layers/firms/render/cesium.js', import.meta.url), 'utf8', ), /restoreSpriteOrderOnEnable\('firms', viewer\)/, ); assert.match( readFileSync( new URL('../layers/firms/render/cesium.js', import.meta.url), 'utf8', ), /registerSpriteCollection\('firms', sprites\);\s*spriteServices\.restoreSpriteOrder\(viewer\);/, 'lazy FIRMS registration must restore order immediately', ); });