pixijs-migration-v8

PixiJS Migration v8 is a breaking-change checklist for upgrading a PixiJS v7 codebase to v8 and for diagnosing v7 code that broke after an upgrade. It maps each old v7 pattern to its v8 replacement and is designed to be worked through top-down, category by category. The recommended porting order is imports, then Application init, Graphics, Text, events, shaders and filters, and finally cleanup.

Coverage spans the major breaking areas of the release. Initialization moves to an asynchronous pattern: construct new Application() and await app.init(...) rather than passing options to the constructor, and app.canvas replaces the deprecated app.view. Imports collapse to the single pixi.js package, and the doc enumerates the deprecated v7 core @pixi/* sub-packages that must no longer be used, while noting that supplemental packages like @pixi/sound remain valid; custom builds can set skipExtensionImports: true and import only needed extensions. The Graphics API switches to shape-then-fill, with renamed shape methods (drawRect becomes rect, drawCircle becomes circle, and so on), fill() and stroke() replacing beginFill and lineStyle, cut() replacing beginHole/endHole, and GraphicsContext replacing GraphicsGeometry.

Further sections cover Text, BitmapText, and HTMLText moving to options-object constructors and bitmap-font import requirements; sprite and mesh changes including Texture.from no longer loading URLs (call Assets.load first), NineSliceSprite, mesh renames, and ParticleContainer using Particle instances; and an events rewrite where eventMode replaces interactive, with a default of passive meaning no events unless set to static or dynamic. It also flags subtle runtime traps, such as the Ticker callback now receiving a Ticker object rather than a delta number, so old code compiles but silently coerces rotation to NaN, plus the removal of updateTransform in favor of onRender, and the shader rework where Shader.from takes an options object with gl and resources. Triggers include migrating v7, v8 breaking changes, @pixi/ imports, DisplayObject, beginFill/endFill, cacheAsBitmap, BaseTexture, and deprecated APIs.