3.4.0 - postprocess: replace PostEffect API with managed Vfx API
Breaking: client.v1.postprocess (PostEffectManager/PostEffectLayer/
PostEffectHandle/PostProcessResources) is deleted, replaced by client.v1.vfx:
- VfxManager/VfxEffect/VfxHandle: framework-owned lifecycle - lazy init,
auto close on disconnect (re-inits on next use), priority + when() gating,
per-effect diagnostics (skip reason, frame cost) with throttled error logs - VfxLevelPhase + prepare(): effects can run mid-level-render (mask drawing,
before-translucent compositing) via Fabric LevelRenderEvents that the
manager registers - replaces per-consumer event wiring and hasMask latches - VfxTargetSet: N named screen-sized/fixed render targets with auto resize
and clear, replaces the hardcoded main+mask pair - VfxPostChain: reload-safe per-frame chain fetch, arbitrary external
targets, generic TargetBundle - one code path for 1 or 40 targets - ManagedUniform: self-healing dynamic uniform slot across F3+T chain
recreation; PostChain/PostPass accessor mixins no longer leak to consumers - VfxScope: try-with-resources guard for outputColorTextureOverride
- VfxManager.shaderPackActive(): reflection-based IrisApi probe +
VfxEffect.skipUnderShaderPacks() opt-out
Docs: RENDER_PIPELINE_REDESIGN.md - implementation status on the design
notes plus a 26.2 migration impact map (MultiBufferSource removal,
reverse-Z depth, GpuFormat targets, buffer mapping changes).