Files
gods-eye-view/src/data/spriteOrder.test.mjs
T
German Khokhlov a9b3125a99 Extract the native FIRMS renderer and own its settle timer
Keep fire normalization, LOD, anchors, cards and selection portable while the native renderer owns ground cells, sprites, input and scene disposal. Cancel superseded/removed settle timers and unregister the original sprite collection.

Preserve all ten native raster pairs exactly in dev and preview; record source/click/focus/lifecycle, legacy Metal and full regression evidence with strict comparator sensitivity checks.
2026-10-27 14:40:08 +04:00

146 lines
5.1 KiB
JavaScript

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',
);
});