Runtime

Invalidation

Tell Prism when app-owned data or surface state needs another paint pass.

Prism owns the paint lifecycle, but your app owns the state that changes what should be drawn.

Call the invalidation API from paint handlers when another runtime-owned pass is needed:

runtime.onPaint(({ drawSurface, invalidate }) => {
  drawSurface(surface);

  if (animationStillRunning) {
    invalidate();
  }
});

Keep app state outside Prism. Use invalidation to schedule painting, not to store application data.

paintOnce()

Wait for one Prism-owned paint pass.

Cleanup

Stop painting, dispose surfaces, and return DOM ownership cleanly.