# What changed in pixi-viewport

> 39 changes in pixi-viewport 7 from its official release notes, upgrade guides and advisories: 9 breaking, 1 deprecations, 10 new APIs and options. Each one cited. Sources checked 2026-11-12. HTML: https://unstale.sh/npm/pixi-viewport/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## pixi-viewport 7

### Breaking changes

- removeOnInterrupt also stops animation on wheel events. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Built-in plugins always run in their default order, regardless of the order in which they are added. User plugins still go at the end unless an index is passed. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Calling clamp() without options no longer clamps. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Setting bottom to false means that side is not clamped; it is no longer treated as 0. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Setting left to false means that side is not clamped; it is no longer treated as 0. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Setting right to false means that side is not clamped; it is no longer treated as 0. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Setting top to false means that side is not clamped; it is no longer treated as 0. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Adds scrolling when the mouse is near screen edges, with speed measured in screen pixels per second. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- With passiveWheel false, stopping a wheel event from reaching the viewport also prevents the page from scrolling. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)

### Deprecations

- mouseEdges() is deprecated and remains unchanged. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)

### New APIs and options

- Setting keepAspectRatio to false clamps one axis at a time, enabling zooming along a single axis. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- When true, one-finger touch drags are ignored so the page can scroll. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- The event type is exported. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Accepts an optional Rectangle to write results into. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- The mouse-edge-start event is emitted. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- The event type is exported. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- When true, wheel events bubbling from other elements, such as HTML overlays, are ignored. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Enables faster trackpad pinch zooming without changing mouse wheel zooming. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Controls trackpad pinch zoom speed; the default of 1 keeps the current speed. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- The event type is exported. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)

### Performance

- The default hit area no longer allocates a new object every frame. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)

### Behavior and default changes

- An exports map makes Node imports load the ES module build and share the application's copy of pixi.js; deep imports continue to work. (7.0.1) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.1)
- The UMD build uses the PIXI global. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- A pixi object inside the viewport can stop propagation of its wheel event to prevent viewport zooming. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)

### Tooling

- Type declarations use .js import extensions, which works with moduleResolution NodeNext. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)

### Fixes and other changes

- Dragging a viewport with no parent, such as one passed straight to renderer.render(viewport), no longer drifts away from the pointer. (7.0.2) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.2)
- Pinching a viewport with no parent no longer runs away to an enormous scale. (7.0.2) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.2)
- Wheel zoom on a viewport with no parent now stays around the pointer. (7.0.2) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.2)
- Clamping now stops deceleration at the edge and re-clamps when only the screen size changes. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Decelerate removes its event listeners when removed. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- The screen field reports the pointer's screen position. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- The screen field reports the pointer's screen position. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Following works with nested targets, acceleration no longer exceeds speed, and following a destroyed target stops instead of throwing repeatedly. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- The mouse-edge-end event is emitted, including when the plugin is paused or removed while scrolling. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Negative scale no longer breaks input. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Using time 0 no longer throws. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Touches left without a pointerup are cleared when a new gesture starts. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- Wheel removes its event listeners when removed. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)
- With wheelZoom false, an unused plain wheel event no longer blocks page scrolling when passiveWheel is false. (7.0.0) — [release notes](https://github.com/pixijs-userland/pixi-viewport/releases/tag/7.0.0)