excalibur 0.25.1 → 0.25.2

package/.nvmrc

@@ -1 +1 @@
-14.18.1
+16.13.2

package/CHANGELOG.md

@@ -5,9 +5,10 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased]
 
-### Breaking Changes
+## Breaking Changes
 
 -
+
 ### Deprecated
 
 -
@@ -16,7 +17,6 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 -
 
-
 ### Fixed
 
 -
@@ -29,15 +29,113 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 -
 
-
 <!--------------------------------- DO NOT EDIT BELOW THIS LINE --------------------------------->
 <!--------------------------------- DO NOT EDIT BELOW THIS LINE --------------------------------->
 <!--------------------------------- DO NOT EDIT BELOW THIS LINE --------------------------------->
-## [v0.25.1] - 2021-11-05
+
+
+## [0.25.2] - 2022-01-21
 
 ### Breaking Changes
 
+- `ex.Util.extend()` is removed, modern js spread operator `{...someobject, ...someotherobject}` handles this better.
+- Excalibur post processing is now moved to the `engine.graphicsContext.addPostProcessor()`
+- Breaking change to `ex.PostProcessor`, all post processors must now now implement this interface
+  ```typescript
+  export interface PostProcessor {
+    intialize(gl: WebGLRenderingContext): void;
+    getShader(): Shader;
+  }
+  ```
+### Deprecated
+
+- The static `Engine.createMainLoop` is now marked deprecated and will be removed in v0.26.0, it is replaced by the `Clock` api
+- Mark legacy draw routines in `ex.Engine`, `ex.Scene`, and `ex.Actor` deprecated
+
+### Added
+
+- Added ability to build custom renderer plugins that are accessible to the `ex.ExcaliburGraphicsContext.draw<TCustomRenderer>(...)` after registering them `ex.ExcaliburGraphicsContext.register(new LineRenderer())`
+- Added ability to draw circles and rectangles with outlines! `ex.ExcaliburGraphicsContext.drawCircle(...)` and `ex.ExcaliburGraphicsContext.drawRectangle(...)`
+- Added `ex.CoordPlane` can be set in the `new ex.Actor({coordPlane: CoordPlane.Screen})` constructor
+- Added convenience feature, setting the color, sets the color on default graphic if applicable
+- Added a `DebugGraphicsComponent` for doing direct debug draw in the `DebugSystem`
+- Added back TileMap debug draw
+- Added `ex.Scene.timers` to expose the list of timers
+- Added support for different webgl texture blending modes as `ex.ImageFiltering` :
+  * `ex.ImageFiltering.Blended` -  Blended is useful when you have high resolution artwork and would like it blended and smoothed
+  * `ex.ImageFiltering.Pixel` - Pixel is useful when you do not want smoothing aka antialiasing applied to your graphics.
+- Excalibur will set a "default" blend mode based on the `ex.EngineOption` antialiasing property, but can be overridden per graphic
+  - `antialiasing: true`, then the blend mode defaults to  `ex.ImageFiltering.Blended`
+  - `antialiasing: false`, then the blend mode defaults to `ex.ImageFiltering.Pixel`
+- `ex.Text/ex.Font` defaults to blended which improves the default look of text rendering dramatically!
+- `ex.Circle` and `ex.Polygon` also default to blended which improves the default look dramatically!
+- `ex.ImageSource` can now specify a blend mode before the Image is loaded, otherwise
+- Added new `measureText` method to the `ex.SpriteFont` and `ex.Font` to return the bounds of any particular text
+- Added new `Clock` api to manage the core main loop. Clocks hide the implementation detail of how the mainloop runs, users just knows that it ticks somehow. Clocks additionally encapsulate any related browser timing, like `performance.now()`
+  1. `StandardClock` encapsulates the existing `requestAnimationFrame` api logic
+  2. `TestClock` allows a user to manually step the mainloop, this can be useful for frame by frame debugging #1170 
+  3. The base abstract clock implements the specifics of elapsed time 
+
+- Added a new feature to Engine options to set a maximum fps `new ex.Engine({...options, maxFps: 30})`. This can be useful when needing to deliver a consistent experience across devices.
+- Pointers can now be configured to use the collider or the graphics bounds as the target for pointers with the `ex.PointerComponent`
+  - `useColliderShape` - (default true) uses the collider component geometry for pointer events
+  - `useGraphicsBounds` - (default false) uses the graphics bounds for pointer events
+
+
+### Fixed
+
+- Fixed issue [#2192] where Actor.center was not correct in child actors
+- Fixed issue where `ex.CircleCollider`s did not respect rotation/scale when offset
+- Fixed issue [#2157] when compiling in TS strict mode complaining about `ex.Poolable`
+- Fixed issue where scaled graphics were not calculating the correct bounds
+- Fixed unreleased issue where clock implementation was not updating frame id
+- Fixed alpha pre-multiply math in multiple shaders
+- Fixed label initialization of fonts, passing a font in the constructor work
+- Fixed bug in sprite bounds calculations not taking scale into account
+- Fixed bug with pointer api where clicking on screen coordinate actors didn't work
+- Fixed [#1815] issue where Camera would jitter when using a strategies based off of actors in the previous frame. 
+- Fixed issue where TileMaps would sometimes have a geometry seam that may not fall on an actual screen pixel causing a visible gap between tiles and the background
+  -- ![image](https://user-images.githubusercontent.com/612071/144700377-ac4585ba-3f4c-44b8-95db-ad36c5fc9a32.png)
+- Fixed unreleased issue where SpriteFonts log every frame they detect a misconfigured font.
+- Fixed unreleased issue where clock when constraining fps would pass larger than expected elapsed times to the simulation causing things to "speed up" bizarrely
+- Fixed unreleased issue where games with no resources would crash
+- Fixed issue [#2152] where shared state in `ex.Font` and `ex.SpriteFont` prevented text from aligning properly when re-used
+- Fixed issue where fast moving `CompositeCollider`s were erroneously generating pairs for their constituent parts
+- Fixed Safari 13.1 crash when booting Excalibur because of they odd MediaQuery API in older Safari
+- Fixed issue where pointers did not work because of missing types
+- Fixed issue with `ArcadeSolver` where stacked/overlapped tiles would double solve the position of the collider for the same overlap
+- Fixed issue where changing the `ex.Sprite.width` or `ex.Sprite.height` did not resize the graphic.
+- Fixed issue where initial Actor anchors set in the constructor were not being set in the graphics component
+- EventDispatcher
+  - `EventDispatcher` - doesn't require the target object. The context of `this` is not tampered anymore.
+- Pointers
+  - `PointerAbstraction` - is fixed to maintain reference
 -
+
+### Updates
+
+- The following Engine's pieces: `Collision` `Graphics` `Resources` `Trigger` are updated to reflect the new EventDispatcher behavior.
+- Refactor camera/screen interaction to utilize transforms instead of bespoke coordinate conversion
+### Changed
+
+- Updated Graphics to improve general performance
+- Updated the webgl primitives to make building `ex.Shader`s, `ex.VertexBuffer`s, and `ex.VertexLayout`s much easier 
+- Broke up the internal monolithic shader into separate internal renderer plugins
+- Changed the debug system to separate displaying the debug position point (`game.debug.transform.showPosition = true`) and debug position label (`game.debug.transform.showPositionLabel = true`)
+- `ex.ColorBlindCorrector` is renamed to `ex.ColorBlindnessPostProcessor`, and `ex.ColorBlindness` is renamed to `ex.ColorBlindnessMode`
+   - Color blindness can still be corrected or simulated:
+      * `game.debug.colorBlindMode.correct(ex.ColorBlindnessMode.Deuteranope)`
+      * `game.debug.colorBlindMode.simulate(ex.ColorBlindnessMode.Deuteranope)`
+- Excalibur now uses pre-multiplied alpha automatically, images will be unpacked into memory using `gl.pixelStorei(gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, true)`
+- Excalibur FPS is now sampled over 100ms blocks, this gives a more usable fps in the stats. The sampler is available off of the engine clock `engine.clock.fpsSampler.fps` 
+- Pointer Events:
+  * Event types (up, down, move, etc) now all exist in 2 types `ex.Input.PointerEvent` and `ex.Input.WheelEvent`
+  * The `stopPropagation()` method used to cancel further dispatches has been renamed to `cancel()` to match other events API.
+  * Events no longer have a reference to the `pointer` but now have all of the same information that was availabe on the pointer `worldPos`, `screenPos`, `pagePos`
+
+
+## [0.25.1] - 2021-11-05
+
 ### Added
 
 - *Experimental:* Native ES module bundle distribution in package `esm/excalibur.js` entrypoint ([#2064](https://github.com/excaliburjs/Excalibur/pull/2064))
@@ -45,21 +143,22 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 - Story to show a play / pause implementation. 
 - `ex.Animation` now support `totalDuration` that will calculate automatically each frame duration based on how many frames have.
 - `ex.Animation` now supports `.reverse()` to reverse the direction of play in an animation, use the `ex.Animation.direction` to inspect if the animation is playing in the `ex.AnimationDirection.Forward` direction or the `ex.AnimationDirection.Backward` direction.
--
 ### Changed
 
+- Pointer system refactored into 2 parts:
+   * First is an ECS style system `ex.PointerSystem` that dispatches events to Entities/Actors
+   * Second is an event receiver `ex.PointerEventReceiver` which is responsible for collecting the native browser events
+   * The API is mostly backwards compatible breaking changes are listed in the breaking change section, event types have been simplified, and `stopPropagation()` and been renamed to `cancel()`
 - Internal Actions implementation converted to ECS system and component, this is a backwards compatible change with v0.25.0
   - `ex.ActionsSystem` and `ex.ActionsComponent` now wrap the existing `ex.ActionContext`
   - Actions can be shared with all entities now!
 - Dispatch the `hidePlayButton` on the Button Event to prevent that keep on the screen on some situations [#1431].
 - Revert VSCode Workbench Colors
--
+
 ### Deprecated
 
 - Actions `asPromise()` renamed to `toPromise()`
-### Removed
 
--
 ### Fixed
 
 - Fixed loader button position on window resize
@@ -123,7 +222,6 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 - Directly changing debug drawing by `engine.isDebug = value` has been replaced by `engine.showDebug(value)` and `engine.toggleDebug()` ([#1655](https://github.com/excaliburjs/Excalibur/issues/1655))
 - `UIActor` Class instances need to be replaced to `ScreenElement` (This Class it's marked as Obsolete) ([#1656](https://github.com/excaliburjs/Excalibur/issues/1656))
 - Switch to browser based promise, the Excalibur implementation `ex.Promise` is marked deprecated ([#994](https://github.com/excaliburjs/Excalibur/issues/994))
-
 - `DisplayMode`'s have changed ([#1733](https://github.com/excaliburjs/Excalibur/issues/1733)) & ([#1928](https://github.com/excaliburjs/Excalibur/issues/1928)):
 
   - `DisplayMode.FitContainer` fits the screen to the available width/height in the canvas parent element, while maintaining aspect ratio and resolution
@@ -199,6 +297,7 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 - Add `KeyEvent.originalEvent?: KeyboardEvent` which exposes the raw keyboard event handled from the browser.
 - Added a new getter to GraphicsComponent.ts called currentKeys that will return the names of the graphics shown in all layers
 - Added a new getter to GraphicsLayer called currentKeys that will the names of the graphics shown in this layer
+
 ### Changed
 
 - `Gif` now supports new graphics component
@@ -219,8 +318,6 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 - `ex.Promise` is marked deprecated ([#994](https://github.com/excaliburjs/Excalibur/issues/994))
 - `ex.DisplayMode.Position` CSS can accomplish this task better than Excalibur ([#1733](https://github.com/excaliburjs/Excalibur/issues/1733))
 
-### Removed
-
 ### Fixed
 
 - Fixed allow `ex.ColliderComponent` to not have a collider
@@ -253,8 +350,9 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 - Fixed `anchor` properly of single shape `Actor` [#1535](https://github.com/excaliburjs/Excalibur/issues/1535)
 - Fixed Safari bug where `Sound` resources would fail to load ([#1848](https://github.com/excaliburjs/Excalibur/issues/1848))
 
+<!----------------------------------------------------------------------------------------------->
 
-## [[0.24.5] - 2020-09-07
+## [0.24.5] - 2020-09-07
 
 ### Breaking Changes
 
@@ -269,19 +367,13 @@ This project adheres to [Semantic Versioning](http://semver.org/).
   - Adds new `ex.System` type which operates on matching Entities to do some behavior in Excalibur.
   - Adds new `ex.Observable` a small observable implementation for observing Entity component changes over time
 
-### Changed
-
-### Deprecated
-
-### Removed
-
 ### Fixed
 
 - Fixed Animation flicker bug on the first frame when using animations with scale, anchors, or rotation. ([#1636](https://github.com/excaliburjs/Excalibur/issues/1636))
 
-## [0.24.4] - 2020-09-02
+<!----------------------------------------------------------------------------------------------->
 
-### Breaking Changes
+## [0.24.4] - 2020-09-02
 
 ### Added
 
@@ -302,10 +394,6 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 - Upgrade Excalibur to TypeScript 3.9.2
 - Upgrade Excalibur to Node 12 LTS
 
-### Deprecated
-
-### Removed
-
 ### Fixed
 
 - Fixed Loader play button markup and styles are now cleaned up after clicked ([#1431](https://github.com/excaliburjs/Excalibur/issues/1431))
@@ -315,6 +403,8 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 - Fixed issue where actors that were not in scene still received pointer events ([#1555](https://github.com/excaliburjs/Excalibur/issues/1555))
 - Fixed Scene initialization order when using the lifecycle overrides ([#1553](https://github.com/excaliburjs/Excalibur/issues/1553))
 
+<!----------------------------------------------------------------------------------------------->
+
 ## [0.24.0] - 2020-04-23
 
 ### Breaking Changes
@@ -382,7 +472,6 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 - Changed `moveBy`, `rotateBy`, and `scaleBy` to operate relative to the current actor position at a speed, instead of moving to an absolute by a certain time.
 - Changed event handlers in excalibur to expect non-null event objects, before `hander: (event?: GameEvent) => void` implied that event could be null. This change addresses ([#1147](https://github.com/excaliburjs/Excalibur/issues/1147)) making strict null/function checks compatible with new TypeScript.
 - Changed collision system to remove actor coupling, in addition `ex.Collider` is a new type that encapsulates all collision behavior. Use `ex.Actor.body.collider` to interact with collisions in Excalibur ([#1119](https://github.com/excaliburjs/Excalibur/issues/1119))
-
   - Add new `ex.Collider` type that is the housing for all collision related code
     - The source of truth for `ex.CollisionType` is now on collider, with a convenience getter on actor
     - The collision system now operates on `ex.Collider`'s not `ex.Actor`'s
@@ -422,7 +511,6 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 - Removed `NaiveCollisionBroadphase` as it was no longer used
 - Renamed methods and properties will be available until `v0.24.0`
 - Deprecated collision attributes on actor, use `Actor.body.collider`
-
   - `Actor.x` & `Actor.y` will be removed in `v0.24.0` use `Actor.pos.x` & `Actor.pos.y`
   - `Actor.collisionArea` will be removed in `v0.24.0` use `Actor.body.collider.shape`
   - `Actor.getLeft()`, `Actor.getRight()`, `Actor.getTop()`, and `Actor.getBottom` are deprecated
@@ -1184,7 +1272,11 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 <!----------------------------------------------------------------------------------------------->
 
-[unreleased]: https://github.com/excaliburjs/Excalibur/compare/v0.24.0...HEAD
+[unreleased]: https://github.com/excaliburjs/Excalibur/compare/v0.25.1...HEAD
+[0.25.1]: https://github.com/excaliburjs/Excalibur/compare/v0.25.0...v0.25.1
+[0.25.0]: https://github.com/excaliburjs/Excalibur/compare/v0.24.5...v0.25.0
+[0.24.5]: https://github.com/excaliburjs/Excalibur/compare/v0.24.4...v0.24.5
+[0.24.4]: https://github.com/excaliburjs/Excalibur/compare/v0.24.0...v0.24.4
 [0.24.0]: https://github.com/excaliburjs/Excalibur/compare/v0.23.0...v0.24.0
 [0.23.0]: https://github.com/excaliburjs/Excalibur/compare/v0.22.0...v0.23.0
 [0.22.0]: https://github.com/excaliburjs/Excalibur/compare/v0.21.0...v0.22.0

package/README.md

@@ -1,6 +1,5 @@
 ![Logo](/assets/logo.png?raw=true)
 
-[![Build Status](https://img.shields.io/travis/excaliburjs/Excalibur/main.svg)](https://travis-ci.org/excaliburjs/Excalibur)
 [![Appveyor status](https://img.shields.io/appveyor/ci/eonarheim/excalibur/main.svg)](https://ci.appveyor.com/project/eonarheim/excalibur)
 [![Coverage Status](https://coveralls.io/repos/github/excaliburjs/Excalibur/badge.svg?branch=main)](https://coveralls.io/github/excaliburjs/Excalibur?branch=main)
 [![npm version](https://img.shields.io/npm/v/excalibur.svg)](https://www.npmjs.com/package/excalibur)

package/build/dist/Actions/ActionsComponent.d.ts

@@ -18,7 +18,7 @@ export declare class ActionsComponent extends Component<'ex.actions'> implements
     onRemove(): void;
     /**
      * Returns the internal action queue
-     * @returns action queu
+     * @returns action queue
      */
     getQueue(): ActionQueue;
     /**

package/build/dist/Actor.d.ts

@@ -1,6 +1,5 @@
 import { Texture } from './Drawing/Texture';
 import { InitializeEvent, KillEvent, PreUpdateEvent, PostUpdateEvent, PreDrawEvent, PostDrawEvent, PreDebugDrawEvent, PostDebugDrawEvent, PostCollisionEvent, PreCollisionEvent, CollisionStartEvent, CollisionEndEvent, PostKillEvent, PreKillEvent, GameEvent, ExitTriggerEvent, EnterTriggerEvent, EnterViewPortEvent, ExitViewPortEvent } from './Events';
-import { PointerEvent, WheelEvent, PointerDragEvent } from './Input/PointerEvents';
 import { Engine } from './Engine';
 import { Color } from './Color';
 import { Sprite } from './Drawing/Sprite';
@@ -16,12 +15,14 @@ import * as Events from './Events';
 import { PointerEvents } from './Interfaces/PointerEventHandlers';
 import { CollisionType } from './Collision/CollisionType';
 import { Entity } from './EntityComponentSystem/Entity';
-import { TransformComponent } from './EntityComponentSystem/Components/TransformComponent';
+import { CoordPlane, TransformComponent } from './EntityComponentSystem/Components/TransformComponent';
 import { MotionComponent } from './EntityComponentSystem/Components/MotionComponent';
 import { GraphicsComponent } from './Graphics/GraphicsComponent';
 import { ColliderComponent } from './Collision/ColliderComponent';
 import { Collider, CollisionGroup } from './Collision/Index';
-import { CapturePointerConfig } from './Input/CapturePointerConfig';
+import { PointerEvent } from './Input/PointerEvent';
+import { WheelEvent } from './Input/WheelEvent';
+import { PointerComponent } from './Input/PointerComponent';
 import { ActionsComponent } from './Actions/ActionsComponent';
 /**
  * Type guard for checking if something is an Actor
@@ -45,9 +46,13 @@ export interface ActorArgs {
      */
     y?: number;
     /**
-     * Optionaly set the (x, y) position of the actor as a vector, default is (0, 0)
+     * Optionally set the (x, y) position of the actor as a vector, default is (0, 0)
      */
     pos?: Vector;
+    /**
+     * Optionally set the coordinate plane of the actor, default is [[CoordPlane.World]] meaning actor is subject to camera positioning
+     */
+    coordPlane?: CoordPlane;
     /**
      * Optionally set the width of a box collider for the actor
      */
@@ -145,7 +150,11 @@ export declare class Actor extends Entity implements Eventable, PointerEvents, C
      */
     get collider(): ColliderComponent;
     /**
-     * Useful for quickly scripting actor behavior, like moving to a place, patroling back and forth, blinking, etc.
+     * Access to the Actor's built in [[PointerComponent]] config
+     */
+    get pointer(): PointerComponent;
+    /**
+     * Useful for quickly scripting actor behavior, like moving to a place, patrolling back and forth, blinking, etc.
      *
      *  Access to the Actor's built in [[ActionsComponent]] which forwards to the
      * [[ActionContext|Action context]] of the actor.
@@ -258,6 +267,9 @@ export declare class Actor extends Entity implements Eventable, PointerEvents, C
      * The scene that the actor is in
      */
     scene: Scene;
+    /**
+     * @deprecated will be removed in v0.26.0
+     */
     frames: {
         [key: string]: Drawable;
     };
@@ -265,7 +277,7 @@ export declare class Actor extends Entity implements Eventable, PointerEvents, C
      * Access to the current drawing for the actor, this can be
      * an [[Animation]], [[Sprite]], or [[Polygon]].
      * Set drawings with [[setDrawing]].
-     * @deprecated
+     * @deprecated will be removed in v0.26.0
      */
     currentDrawing: Drawable;
     /**
@@ -281,26 +293,15 @@ export declare class Actor extends Entity implements Eventable, PointerEvents, C
     set draggable(isDraggable: boolean);
     /**
      * Modify the current actor update pipeline.
+     * @deprecated will be removed in v0.26.0
      */
     traits: Trait[];
     /**
-     * Sets the color of the actor. A rectangle of this color will be
-     * drawn if no [[Drawable]] is specified as the actors drawing.
-     *
-     * The default is `null` which prevents a rectangle from being drawn.
+     * Sets the color of the actor's current graphic
      */
     get color(): Color;
     set color(v: Color);
     private _color;
-    /**
-     * Whether or not to enable the [[Traits.CapturePointer]] trait that propagates
-     * pointer events to this actor
-     */
-    enableCapturePointer: boolean;
-    /**
-     * Configuration for [[Traits.CapturePointer]] trait
-     */
-    capturePointer: CapturePointerConfig;
     /**
      *
      * @param config
@@ -321,10 +322,6 @@ export declare class Actor extends Entity implements Eventable, PointerEvents, C
      * @internal
      */
     _initialize(engine: Engine): void;
-    private _capturePointerEvents;
-    private _captureMoveEvents;
-    private _captureDragEvents;
-    private _checkForPointerOptIn;
     on(eventName: Events.exittrigger, handler: (event: ExitTriggerEvent) => void): void;
     on(eventName: Events.entertrigger, handler: (event: EnterTriggerEvent) => void): void;
     /**
@@ -379,11 +376,11 @@ export declare class Actor extends Entity implements Eventable, PointerEvents, C
     on(eventName: Events.pointermove, handler: (event: PointerEvent) => void): void;
     on(eventName: Events.pointercancel, handler: (event: PointerEvent) => void): void;
     on(eventName: Events.pointerwheel, handler: (event: WheelEvent) => void): void;
-    on(eventName: Events.pointerdragstart, handler: (event: PointerDragEvent) => void): void;
-    on(eventName: Events.pointerdragend, handler: (event: PointerDragEvent) => void): void;
-    on(eventName: Events.pointerdragenter, handler: (event: PointerDragEvent) => void): void;
-    on(eventName: Events.pointerdragleave, handler: (event: PointerDragEvent) => void): void;
-    on(eventName: Events.pointerdragmove, handler: (event: PointerDragEvent) => void): void;
+    on(eventName: Events.pointerdragstart, handler: (event: PointerEvent) => void): void;
+    on(eventName: Events.pointerdragend, handler: (event: PointerEvent) => void): void;
+    on(eventName: Events.pointerdragenter, handler: (event: PointerEvent) => void): void;
+    on(eventName: Events.pointerdragleave, handler: (event: PointerEvent) => void): void;
+    on(eventName: Events.pointerdragmove, handler: (event: PointerEvent) => void): void;
     on(eventName: Events.enterviewport, handler: (event: EnterViewPortEvent) => void): void;
     on(eventName: Events.exitviewport, handler: (event: ExitViewPortEvent) => void): void;
     on(eventName: string, handler: (event: GameEvent<Actor>) => void): void;
@@ -441,11 +438,11 @@ export declare class Actor extends Entity implements Eventable, PointerEvents, C
     once(eventName: Events.pointermove, handler: (event: PointerEvent) => void): void;
     once(eventName: Events.pointercancel, handler: (event: PointerEvent) => void): void;
     once(eventName: Events.pointerwheel, handler: (event: WheelEvent) => void): void;
-    once(eventName: Events.pointerdragstart, handler: (event: PointerDragEvent) => void): void;
-    once(eventName: Events.pointerdragend, handler: (event: PointerDragEvent) => void): void;
-    once(eventName: Events.pointerdragenter, handler: (event: PointerDragEvent) => void): void;
-    once(eventName: Events.pointerdragleave, handler: (event: PointerDragEvent) => void): void;
-    once(eventName: Events.pointerdragmove, handler: (event: PointerDragEvent) => void): void;
+    once(eventName: Events.pointerdragstart, handler: (event: PointerEvent) => void): void;
+    once(eventName: Events.pointerdragend, handler: (event: PointerEvent) => void): void;
+    once(eventName: Events.pointerdragenter, handler: (event: PointerEvent) => void): void;
+    once(eventName: Events.pointerdragleave, handler: (event: PointerEvent) => void): void;
+    once(eventName: Events.pointerdragmove, handler: (event: PointerEvent) => void): void;
     once(eventName: Events.enterviewport, handler: (event: EnterViewPortEvent) => void): void;
     once(eventName: Events.exitviewport, handler: (event: ExitViewPortEvent) => void): void;
     once(eventName: string, handler: (event: GameEvent<Actor>) => void): void;
@@ -493,11 +490,11 @@ export declare class Actor extends Entity implements Eventable, PointerEvents, C
     off(eventName: Events.pointermove, handler?: (event: PointerEvent) => void): void;
     off(eventName: Events.pointercancel, handler?: (event: PointerEvent) => void): void;
     off(eventName: Events.pointerwheel, handler?: (event: WheelEvent) => void): void;
-    off(eventName: Events.pointerdragstart, handler?: (event: PointerDragEvent) => void): void;
-    off(eventName: Events.pointerdragend, handler?: (event: PointerDragEvent) => void): void;
-    off(eventName: Events.pointerdragenter, handler?: (event: PointerDragEvent) => void): void;
-    off(eventName: Events.pointerdragleave, handler?: (event: PointerDragEvent) => void): void;
-    off(eventName: Events.pointerdragmove, handler?: (event: PointerDragEvent) => void): void;
+    off(eventName: Events.pointerdragstart, handler?: (event: PointerEvent) => void): void;
+    off(eventName: Events.pointerdragend, handler?: (event: PointerEvent) => void): void;
+    off(eventName: Events.pointerdragenter, handler?: (event: PointerEvent) => void): void;
+    off(eventName: Events.pointerdragleave, handler?: (event: PointerEvent) => void): void;
+    off(eventName: Events.pointerdragmove, handler?: (event: PointerEvent) => void): void;
     off(eventName: Events.prekill, handler?: (event: PreKillEvent) => void): void;
     off(eventName: Events.postkill, handler?: (event: PostKillEvent) => void): void;
     off(eventName: Events.initialize, handler?: (event: Events.InitializeEvent<Actor>) => void): void;
@@ -563,19 +560,19 @@ export declare class Actor extends Entity implements Eventable, PointerEvents, C
     setDrawing(key: number): void;
     /**
      * Adds a whole texture as the "default" drawing. Set a drawing using [[setDrawing]].
-     * @deprecated Use [[GraphicsComponent.add|Actor.graphics.add]]
+     * @deprecated Use [[GraphicsComponent.add|Actor.graphics.add]], will be removed in v0.26.0
      */
     addDrawing(texture: Texture): void;
     /**
      * Adds a whole sprite as the "default" drawing. Set a drawing using [[setDrawing]].
-     * @deprecated Use [[GraphicsComponent.add|Actor.graphics.add]]
+     * @deprecated Use [[GraphicsComponent.add|Actor.graphics.add]], will be removed in v0.26.0
      */
     addDrawing(sprite: Sprite): void;
     /**
      * Adds a drawing to the list of available drawings for an actor. Set a drawing using [[setDrawing]].
      * @param key     The key to associate with a drawing for this actor
      * @param drawing This can be an [[Animation]], [[Sprite]], or [[Polygon]].
-     * @deprecated Use [[GraphicsComponent.add|Actor.graphics.add]]
+     * @deprecated Use [[GraphicsComponent.add|Actor.graphics.add]], will be removed in v0.26.0
      */
     addDrawing(key: any, drawing: Drawable): void;
     /**
@@ -584,7 +581,7 @@ export declare class Actor extends Entity implements Eventable, PointerEvents, C
      */
     get z(): number;
     /**
-     * @deprecated Use [[Actor.z]]
+     * @deprecated Use [[Actor.z]], will be removed in v0.26.0
      */
     getZIndex(): number;
     /**
@@ -596,13 +593,17 @@ export declare class Actor extends Entity implements Eventable, PointerEvents, C
     set z(newZ: number);
     /**
      * @param newIndex new z-index to assign
-     * @deprecated Use [[Actor.z]]
+     * @deprecated Use [[Actor.z]], will be removed in v0.26.0
      */
     setZIndex(newIndex: number): void;
     /**
-     * Get the center point of an actor
+     * Get the center point of an actor (global position)
      */
     get center(): Vector;
+    /**
+     * Get the local center point of an actor
+     */
+    get localCenter(): Vector;
     get width(): number;
     get height(): number;
     /**
@@ -720,7 +721,7 @@ export declare class Actor extends Entity implements Eventable, PointerEvents, C
      *
      *
      * **Warning** only works with Flags.useLegacyDrawing() enabled
-     * @deprecated Use Actor.graphics.onPostDraw, will be removed in v0.26.0
+     * @deprecated will be removed in v0.26.0
      * @internal
      */
     debugDraw(_ctx: CanvasRenderingContext2D): void;

package/build/dist/Camera.d.ts

@@ -7,6 +7,7 @@ import { PreUpdateEvent, PostUpdateEvent, GameEvent, InitializeEvent } from './E
 import { Class } from './Class';
 import { BoundingBox } from './Collision/BoundingBox';
 import { ExcaliburGraphicsContext } from './Graphics/Context/ExcaliburGraphicsContext';
+import { Matrix } from './Math/matrix';
 /**
  * Interface that describes a custom camera strategy for tracking targets
  */
@@ -148,6 +149,8 @@ export declare class LimitCameraBoundsStrategy implements CameraStrategy<Boundin
  *
  */
 export declare class Camera extends Class implements CanUpdate, CanInitialize {
+    transform: Matrix;
+    inverse: Matrix;
     protected _follow: Actor;
     private _cameraStrategies;
     strategy: StrategyContainer;
@@ -171,6 +174,7 @@ export declare class Camera extends Class implements CanUpdate, CanInitialize {
     rotation: number;
     /**
      * Current angular velocity
+     * @deprecated will be removed in v0.26.0, use angularVelocity
      */
     rx: number;
     /**
@@ -190,7 +194,7 @@ export declare class Camera extends Class implements CanUpdate, CanInitialize {
      */
     vel: Vector;
     /**
-     * GEt or set the camera's acceleration
+     * Get or set the camera's acceleration
      */
     acc: Vector;
     private _cameraMoving;
@@ -328,6 +332,7 @@ export declare class Camera extends Class implements CanUpdate, CanInitialize {
      */
     onPostUpdate(_engine: Engine, _delta: number): void;
     private _engine;
+    private _screen;
     private _isInitialized;
     get isInitialized(): boolean;
     _initialize(_engine: Engine): void;
@@ -348,13 +353,16 @@ export declare class Camera extends Class implements CanUpdate, CanInitialize {
     once(eventName: 'preupdate', handler: (event: PreUpdateEvent) => void): void;
     once(eventName: 'postupdate', handler: (event: PostUpdateEvent) => void): void;
     once(eventName: string, handler: (event: GameEvent<Camera>) => void): void;
+    runStrategies(engine: Engine, delta: number): void;
+    updateViewport(): void;
     update(_engine: Engine, delta: number): void;
     /**
      * Applies the relevant transformations to the game canvas to "move" or apply effects to the Camera
-     * @param ctx    Canvas context to apply transformations
+     * @param ctx Canvas context to apply transformations
      */
     draw(ctx: CanvasRenderingContext2D): void;
     draw(ctx: ExcaliburGraphicsContext): void;
+    updateTransform(): void;
     debugDraw(_ctx: CanvasRenderingContext2D): void;
     private _isDoneShaking;
 }

package/build/dist/Class.d.ts

@@ -1,4 +1,3 @@
-import { GameEvent } from './Events';
 import { EventDispatcher } from './EventDispatcher';
 import { Eventable } from './Interfaces/Evented';
 /**
@@ -17,7 +16,7 @@ export declare class Class implements Eventable {
      * @param eventName  Name of the event to listen for
      * @param handler    Event handler for the thrown event
      */
-    on(eventName: string, handler: (event: GameEvent<any>) => void): void;
+    on(eventName: string, handler: (event: any) => void): void;
     /**
      * Alias for `removeEventListener`. If only the eventName is specified
      * it will remove all handlers registered for that specific event. If the eventName
@@ -26,18 +25,18 @@ export declare class Class implements Eventable {
      * @param eventName  Name of the event to listen for
      * @param handler    Event handler for the thrown event
      */
-    off(eventName: string, handler?: (event: GameEvent<any>) => void): void;
+    off(eventName: string, handler?: (event: any) => void): void;
     /**
      * Emits a new event
      * @param eventName   Name of the event to emit
      * @param eventObject Data associated with this event
      */
-    emit(eventName: string, eventObject: GameEvent<any>): void;
+    emit(eventName: string, eventObject: any): void;
     /**
      * Once listens to an event one time, then unsubscribes from that event
      *
      * @param eventName The name of the event to subscribe to once
      * @param handler   The handler of the event that will be auto unsubscribed
      */
-    once(eventName: string, handler: (event: GameEvent<any>) => void): void;
+    once(eventName: string, handler: (event: any) => void): void;
 }

package/build/dist/Collision/BodyComponent.d.ts

@@ -26,7 +26,7 @@ export declare class BodyComponent extends Component<'ex.body'> implements Clona
     dependencies: (typeof TransformComponent | typeof MotionComponent)[];
     static _ID: number;
     readonly id: Id<'body'>;
-    events: EventDispatcher<this>;
+    events: EventDispatcher<any>;
     constructor(options?: BodyComponentOptions);
     /**
      * Collision type for the rigidbody physics simulation, by default [[CollisionType.PreventCollision]]
@@ -195,7 +195,7 @@ export declare class BodyComponent extends Component<'ex.body'> implements Clona
      */
     applyLinearImpulse(impulse: Vector): void;
     /**
-     * Apply only angular impuse to the body
+     * Apply only angular impulse to the body
      * @param point
      * @param impulse
      */
@@ -204,5 +204,9 @@ export declare class BodyComponent extends Component<'ex.body'> implements Clona
      * Sets the old versions of pos, vel, acc, and scale.
      */
     captureOldTransform(): void;
+    /**
+     * @deprecated signature will change in v0.26.0
+     * @param _ctx
+     */
     debugDraw(_ctx: CanvasRenderingContext2D): void;
 }

package/build/dist/Collision/BoundingBox.d.ts

@@ -99,6 +99,12 @@ export declare class BoundingBox {
      * @param bb The other actor to test
      */
     intersectWithSide(bb: BoundingBox): Side;
+    /**
+     *
+     * @deprecated signature will change in v0.26.0
+     * @param ctx
+     * @param color
+     */
     debugDraw(ctx: CanvasRenderingContext2D, color?: Color): void;
     /**
      * Draw a debug bounding box