[hunterbecton]

Why

Registering or unregistering an Effect rebuilds the output material but draws nothing. On a parked scene, a changed Effect prop or a removed Effect left the old image on screen until something else asked for a frame.

What changes

useSceneRegistration now calls requestRender() after each registration and each unregistration. useResample and usePostProcessPass both go through it, so this covers every Effect, and PaletteMap's local workaround is gone. A running scene pays nothing, because requestRender() returns at once unless the scene is idle.

The new cleanup also runs when a whole scene unmounts, after the scheduler may be disposed. A parked-scene test and a FrameScheduler test confirm that this queues no frame.

Closes SHA-311

[github-actions]

React Doctor found no new issues. 🎉

_{Reviewed by React Doctor for commit 29d0fbe.}

[Copilot]

🟢 Approval recommended

No active review issues remain for the shared Effect registration redraw change.

No open issues 🎉

What changed in this PR

Fixes stale images on parked shader scenes by moving Effect redraw requests into the shared registration hook, covering both resample and post-process Effects.

Changes:

• Requests a frame after Effect registration and unregistration, replacing PaletteMap’s local workaround.
• Adds lifecycle-order and disposal regression tests, and updates scheduler mocks.
• Documents the shared redraw behavior and adds a patch changeset.

File	Description
packages/​shaders/​src/​runtime/​frame-scheduler/​frame-scheduler.test.ts	Tests that render requests after disposal queue no frame.
packages/​shaders/​src/​react/​hooks/​use-scene-registration/​use-scene-registration.ts	Requests redraws after registration and cleanup.
packages/​shaders/​src/​react/​hooks/​use-scene-registration/​use-scene-registration.test.tsx	Tests redraw ordering on mount, unmount, and dependency changes.
packages/​shaders/​src/​react/​hooks/​use-resample/​use-resample.test.tsx	Adds requestRender to the scheduler mock.
packages/​shaders/​src/​react/​hooks/​use-overlay-pass/​use-overlay-pass.test.tsx	Updates scheduler mocks for shared redraw requests.
packages/​shaders/​src/​react/​hooks/​use-base-pass-uv/​use-base-pass-uv.test.tsx	Adds requestRender to the scheduler mock.
packages/​shaders/​src/​react/​components/​shader-scene/​shader-scene.test.tsx	Tests parked-scene teardown with an Effect mounted.
packages/​shaders/​src/​components/​palette-map/​shader.tsx	Removes the redundant local redraw workaround.
docs/​agents/​tsl.md	Documents redraw requests during Effect registration changes.
.changeset/​effect-registration-frame.md	Records the parked-scene fix as a patch release.

_{Review effort: Balanced}