[fand]

Implements parts 1 and 4 of #268.

Changes

• Add EffectContext.resetState(). It writes back the GL state the pipeline assumes, without any getParameter per call (the texture unit count is queried once and cached):
  • Draw/read framebuffer to the canvas, drawBuffers([BACK]), viewport to the whole canvas
  • DEPTH_TEST, CULL_FACE, STENCIL_TEST, SCISSOR_TEST, BLEND, POLYGON_OFFSET_FILL, RASTERIZER_DISCARD, SAMPLE_ALPHA_TO_COVERAGE, SAMPLE_COVERAGE disabled
  • depthMask(true), depthFunc(LESS), colorMask(true × 4), stencilMask(~0), frontFace(CCW), cullFace(BACK), clearColor(0, 0, 0, 0) (the player's per-frame clears rely on it without setting it)
  • Program, VAO, transform feedback and the ARRAY / PIXEL_PACK / PIXEL_UNPACK / UNIFORM / COPY_READ / COPY_WRITE buffer bindings unbound
  • Samplers unbound on every texture unit, active texture set to TEXTURE0
  • Pixel store reset to the WebGL defaults
  • No-op while the context is lost or after dispose. Works in init() / update() too.
• The ctx.gl doc comment now lists the state VFX-JS relies on. Only ctx.draw / ctx.blit / ctx.clear turn off scissor; the rest of the frame doesn't, so the docs say to call resetState() before the next ctx.* call and before render() returns. It also notes that transform feedback must be ended first.
• skills/vfx-js/references/effects.md: add resetState() to the context table and a rule for raw GL use.
• Changeset: @vfx-js/core minor.

Not included

• ctx.rawGL(fn): it would only wrap try { fn(ctx.gl) } finally { ctx.resetState() }, so it was left out. It can be added later without a breaking change.
• Part 3 (defensive pipeline that sets depth test / culling / masks on every draw): it changes the existing draw path, so it fits better with Proposal: depth buffer (and MSAA) for render targets, depth/cull options for ctx.draw #267.

Testing

• pnpm --filter @vfx-js/core test (451 passed, 6 new for resetState)
• pnpm --filter @vfx-js/core lint
• pnpm --filter docs test

[github-actions]

🚀 Cloudflare Pages preview — 4d12c8f

Page	URL
Top	https://claude-gracious-lamport-r71z.vfx-js.pages.dev/vfx-js/
Examples	https://claude-gracious-lamport-r71z.vfx-js.pages.dev/vfx-js/examples/
Storybook	https://claude-gracious-lamport-r71z.vfx-js.pages.dev/vfx-js/storybook/
Docs	https://claude-gracious-lamport-r71z.vfx-js.pages.dev/vfx-js/docs/
Transition	https://claude-gracious-lamport-r71z.vfx-js.pages.dev/vfx-js-transitions/

_{This branch URL stays the same across pushes. Latest deploy: https://980c155e.vfx-js.pages.dev}