import { test, beforeEach } from 'node:test'; import assert from 'node:assert/strict'; import { installRenderGovernor, holdContinuousRender, releaseContinuousRender, governorRequestRender, getRenderGovernorDiagnostics, _resetRenderGovernorForTest, uninstallRenderGovernor, } from './renderGovernor.js'; import { framePortFor } from './testSupport/fakeFramePort.mjs'; function makeViewer() { const calls = { requestRender: 0 }; const scene = { requestRenderMode: false, maximumRenderTimeChange: 0, requestRender() { calls.requestRender += 1; }, }; return { viewer: { scene }, scene, calls }; } beforeEach(() => _resetRenderGovernorForTest()); test('install with zero holds leaves the loop on demand', () => { const { viewer, scene } = makeViewer(); installRenderGovernor(framePortFor(viewer.scene)); assert.equal(scene.requestRenderMode, true); assert.equal(getRenderGovernorDiagnostics().mode, 'idle'); }); test('holds taken before install apply at install', () => { holdContinuousRender('boot'); const { viewer, scene } = makeViewer(); installRenderGovernor(framePortFor(viewer.scene)); assert.equal(scene.requestRenderMode, false); releaseContinuousRender('boot'); assert.equal(scene.requestRenderMode, true); }); test('uninstall gives back what the governor holds on the port', () => { const { viewer, scene } = makeViewer(); const frame = framePortFor(viewer.scene); installRenderGovernor(frame); holdContinuousRender('flights'); assert.equal(scene.requestRenderMode, false); uninstallRenderGovernor(frame); assert.equal(scene.requestRenderMode, true); assert.deepEqual(getRenderGovernorDiagnostics().holds, []); }); test('install needs a frame port', () => { assert.throws(() => installRenderGovernor({ scene: {} }), TypeError); }); test('a hold flips to continuous; releasing the last hold returns to idle with a settling frame', () => { const { viewer, scene, calls } = makeViewer(); installRenderGovernor(framePortFor(viewer.scene)); const settleBaseline = calls.requestRender; holdContinuousRender('flights'); assert.equal(scene.requestRenderMode, false); assert.equal(getRenderGovernorDiagnostics().mode, 'continuous'); releaseContinuousRender('flights'); assert.equal(scene.requestRenderMode, true); // Entering idle renders one settling frame. assert.equal(calls.requestRender, settleBaseline + 1); }); test('holds are identity-keyed: double-hold cannot leak, double-release cannot corrupt', () => { const { viewer, scene } = makeViewer(); installRenderGovernor(framePortFor(viewer.scene)); holdContinuousRender('traffic'); holdContinuousRender('traffic'); releaseContinuousRender('traffic'); assert.equal(scene.requestRenderMode, true, 'single release clears an idempotent double-hold'); releaseContinuousRender('traffic'); releaseContinuousRender('never-held'); assert.equal(scene.requestRenderMode, true); }); test('mode stays continuous until the LAST holder releases', () => { const { viewer, scene } = makeViewer(); installRenderGovernor(framePortFor(viewer.scene)); holdContinuousRender('flights'); holdContinuousRender('satellites'); releaseContinuousRender('flights'); assert.equal(scene.requestRenderMode, false); assert.deepEqual(getRenderGovernorDiagnostics().holds, ['satellites']); releaseContinuousRender('satellites'); assert.equal(scene.requestRenderMode, true); }); test('governorRequestRender forwards to the scene and records reasons only in idle mode', () => { const { viewer, calls } = makeViewer(); installRenderGovernor(framePortFor(viewer.scene)); const baseline = calls.requestRender; governorRequestRender('layer-tick:earthquakes'); assert.equal(calls.requestRender, baseline + 1); assert.equal(getRenderGovernorDiagnostics().recentRequests.at(-1).reason, 'layer-tick:earthquakes'); holdContinuousRender('flights'); const idleRequests = getRenderGovernorDiagnostics().recentRequests.length; governorRequestRender('slider'); assert.equal( getRenderGovernorDiagnostics().recentRequests.length, idleRequests, 'continuous-mode requests are not recorded as idle diagnostics', ); }); test('hold/release/request are safe no-ops before install (test environments without a viewer)', () => { holdContinuousRender('flights'); releaseContinuousRender('flights'); governorRequestRender('noop'); assert.equal(getRenderGovernorDiagnostics().installed, false); }); test('holds registered before install apply at install time', () => { holdContinuousRender('flights'); const { viewer, scene } = makeViewer(); installRenderGovernor(framePortFor(viewer.scene)); assert.equal(scene.requestRenderMode, false, 'pre-install hold keeps continuous mode'); releaseContinuousRender('flights'); assert.equal(scene.requestRenderMode, true); });