build(deps): bump phaser from 3.90.0 to 4.2.1

[dependabot]

Bumps phaser from 3.90.0 to 4.2.1.

Release notes

Sourced from phaser's releases.

Phaser v4.2.1

Version 4.2.1 - Giedi - 9th July 2026

Fixes

• Stencil option stencilInvert works correctly (an alpha bug prevented it from having the intended effect)
• Framebuffers now correctly clear stencil on use
  • The global stencil settings defaulted to deactivating the stencil write mask, so it couldn't actually run the clear process correctly. Write mask is now enabled by default, but is never triggered because default stencil operations keep existing values.
• Remove inline access of Phaser namespace from CombineColorMatrix, ImageLight, and Texture. These would break in the ESM build. Thanks @​scobo!
• Fix ScaleManager not resizing to parent container. Fix #7213 (thanks @​VijayVPatil13)
• Docs: correct AnimationManager get() return type (thanks @​samme)
• Tweens with a startDelay set weren't having their state updated from START_DELAY to ACTIVE. This left them stuck in their initial state, even once the startDelay had elapsed. Fix #7093 (thanks @​Bambosh)

Phaser v4.2.0

Version 4.2.0 - Giedi - 19th June 2026

New Features

• New game config options:
  • render.alphaStrategy: hint to shaders to handle alpha in different ways.
  • render.stencil: disable stencil buffer creation in a game, saving memory.
  • render.stencilAlphaStrategy: set the default alpha strategy used within Stencil objects, where regular alpha does nothing.
• CustomContext game object is a container which can modify the DrawingContext at render time. This is an advanced rendering technique which reaches into the deep settings of the renderer. Potential uses include:
  • Toggling stencil testing
  • Selectively activating alpha handling strategies
  • Freehand GL scissor modification
• Mesh2D game object renders textured triangles. It batches with regular sprites.
  • Mesh2D#buildOrderedIndices precomputes an optimized index list (Mesh2D#indicesOrdered) which arranges triangles into quad-forming pairs, synthesizing degenerate triangles where a triangle has no edge-sharing partner. You choose the optimization strategy (0 fast, 1 medium, 2 high), paying the cost once when the topology is stable. Use Mesh2D#useOrderedIndices (and Mesh2D#setUseOrderedIndices) to toggle between the ordered and unordered lists without rebuilding.
  • Mesh2D#renderAsTriangles (and Mesh2D#setRenderAsTriangles) renders the mesh as individual triangles via the new BatchHandlerTri render node, which is suitable for dynamic topology that cannot be optimized into quads.
• BatchHandlerTri render node draws individual textured triangles (gl.TRIANGLES) as a batch. It extends BatchHandlerQuad, reusing its shader, vertex layout, and texture handling, and adds a batchTriangles method which accepts vertex and index arrays directly.
• TransformerVertex render node now splits its per-vertex run into setupMatrix (build the transform matrix once per GameObject) and transformVertex (project a single vertex with the cached matrix). Mesh rendering uses this to avoid rebuilding the transform matrix for every vertex. run is unchanged for existing callers.
• Stencil game object is a container whose contents modify the stencil buffer. This is a fast way to persistently mask the game canvas. There are many ways to combine stencils. The default approach is to add layers to the stencil mask.
  • Unlike stencil masks in Phaser 3, Stencil objects are universal, persistent, and support anything as a stencil source, so long as it draws pixels. Use sprites and filter outputs as stencil sources!
  • Operating modes include addLayer, subtractLayer, clear, and clearRegion. Add and subtract can be inverted.
• StencilReference game object re-renders a target Stencil with different settings. This is useful for removing or reusing stencil geometry.
• AlphaStrategy setting used in the render system allows you to use GLSL discard instead of alpha in many shaders. This is inefficient, but is useful for some effects and situations.
  • Game config can set a default alpha strategy.
  • Stencil and CustomContext allow you to set an alpha strategy.
  • Most Phaser shaders handle alpha strategy. Custom shaders must implement it themselves, but you can use compositing (filtersForceComposite) to run graphics through a compatible shader.
  • Strategies include:
    • keep: use alpha as normal.
    • dither: use a dithering algorithm to select pixels to discard.
    • threshold: discard all pixels below a certain alpha.
• BatchHandler render node now has a config option for topology, allowing extended nodes to opt into different triangulation modes.
• BatchHandlerTri render node renders textured triangles. It is used by Mesh2D in triangle rendering mode. This can be more efficient than attempting to compile triangles into quads, which is the default strategy.
• DrawingContext adds more controls:
  • Alpha strategy
  • Color writemask
  • Stencil parameters
• WebGLGlobalWrapper now handles stencil write mask.

... (truncated)

Changelog

Sourced from phaser's changelog.

Phaser Change Logs

Phaser 4

Document	Description
4.2.1 Changelog	Full changelog for Phaser 4.2.1
4.2.0 Changelog	Full changelog for Phaser 4.2.0
4.1.0 Changelog	Full changelog for Phaser 4.1.0
4.0.0 Changelog	Full changelog for Phaser 4.0.0
Migration Guide	Guide for upgrading from Phaser 3 to Phaser 4

---

Phaser 3

You can find the exhaustive Change Logs for all versions of Phaser 3 below.

Version	Name	Release Date
3.90	Tsugumi	23rd May 2025
3.88.2	Minami	13th February 2025
3.88.1	Minami	12th February 2025
3.88	Minami	11th February 2025
3.87	Hanabi	14th November 2024
3.86	Aoi	11th October 2024
3.85.2	Itsuki	17th September 2024
3.85.0	Itsuki	5th September 2024
3.80.1	Nino	27th February 2024
3.80	Nino	21st February 2024
3.70	Yotsuba	10th November 2023
3.60	Miku	12th April 2023
3.55.2	Ichika	27th May 2021
3.55.1	Ichika	26th May 2021
3.55	Ichika	24th May 2021
3.54	Futaro	26th March 2021
3.53.1	Anastasia	8th March 2021
3.53	Anastasia	8th March 2021
3.52	Crusch	14th January 2021
3.51	Emilia	5th January 2021
3.50.1	Subaru	21st December 2020
3.50	Subaru	16th December 2020
3.24.1	Rem	14th July 2020
3.24	Rem	13th July 2020
3.23	Ginro	27th April 2020
3.22	Kohaku	January 15th 2020
3.21	Senku	22nd November 2019
3.20.1	Fitoria	15th October 2019
3.20	Fitoria	11th October 2019
3.19	Naofumi	8th August 2019

... (truncated)

Commits

• 41be1e4 4.2.1
• 4eced25 updated change log
• 10b3bfb Merge pull request #7150 from Bambosh/fix-tween-startDelay
• 55d1180 Merge pull request #7332 from samme/docs/anims-get
• 1c9b697 Merge pull request #7222 from VijayVPatil13/fix-scale-resize-issue-7213
• 539e718 Merge pull request #7328 from samme/docs/7325-setSizeToFrame
• e6a4d9a Docs: correct AnimationManager get() return type
• fe754a2 Docs: correct setSizeToFrame()
• 8a01674 Fix CDN links.
• 37b41bc Bump version to 4.2.1. Build phaser.d.ts.
• Additional commits viewable in compare view