refactor: extract application construction and lifecycle

src/annotations/annotationEngine.test.mjs

@@ -668,3 +668,44 @@ test('duplicate-replacement: a throw AFTER partial renderer state leaves nothing
   assert.equal(retry.drawn, 1);
   assert.equal(live.size, 1, 'the recoloured mark redraws once, with no orphan underneath');
 });
+
+test('destroy releases the renderer and prevents subsequent annotation work', async (t) => {
+  installAnimationFrameStubs(t);
+  const { renderer, calls } = fakeRenderer();
+  let destroyed = 0;
+  renderer.destroy = () => { destroyed++; };
+  const engine = createAnnotationEngine({ viewer: {}, renderer });
+  const drawn = await engine.annotate([{ type: 'pin', longitude: -97.74, latitude: 30.27 }]);
+  assert.equal(drawn.drawn, 1);
+  engine.destroy();
+  const additions = calls.add;
+  const result = await engine.annotate([{ type: 'pin', target: 'Must not resolve' }]);
+  assert.equal(result.error, 'destroyed');
+  assert.equal(calls.add, additions);
+  assert.equal(engine.count(), 0);
+  engine.destroy();
+  assert.equal(destroyed, 1);
+  assert.ok(!getRenderGovernorDiagnostics().holds.includes('annotations'));
+});
+
+test('a late annotation resolver cannot redraw after destruction', async (t) => {
+  installAnimationFrameStubs(t);
+  const { renderer, calls } = fakeRenderer();
+  renderer.destroy = () => {};
+  let release;
+  let signal;
+  const engine = createAnnotationEngine({
+    viewer: {}, renderer,
+    resolveTarget: (options) => {
+      signal = options.signal;
+      return new Promise((resolve) => { release = resolve; });
+    },
+  });
+  const pending = engine.annotate([{ type: 'pin', target: 'Pending place' }]);
+  engine.destroy();
+  assert.equal(signal.aborted, true);
+  release({ lon: -97.74, lat: 30.27 });
+  await pending;
+  assert.equal(calls.add, 0);
+  assert.equal(engine.count(), 0);
+});