excalibur 0.28.1 → 0.28.2

package/.nvmrc

@@ -1 +1 @@
-18.17.0
+18.19.0

package/CHANGELOG.md

@@ -3,11 +3,58 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
-
 ## [Unreleased]
 
 ### Breaking Changes
 
+-
+
+### Deprecated
+
+-
+
+### Added
+
+- Added `ex.Engine.version` to report the current excalibur version build string
+- Added new `ex.Screen.events`
+  - `screen.events.on('resize', (evt) => )` Will emit when the screen is resized
+  - `screen.events.on('fullscreen', (evt) => )` Will emit when the screen is changed into browser fullscreen mode
+  - `screen.events.on('pixelratio', (evt) => )` Will emit when the screen's pixel ratio changes (moving from a hidpi screen to a non, or vice versa)
+
+### Fixed
+
+- Fixed issue where removing handlers by function reference only removed the first registered one
+- Fixed issue where play button was hidden when going fullscreen mode
+- Fixed issue where screen resizing caused artifacts on the loading screen
+- Fixed bug in `useCanvas2DFallback()` where `antialiasing` settings could be lost
+- Fixed bug in `useCanvas2DFallback()` where opacity was not respected in `save
+- Fixed typo in trigger event signature `entertrigger` should have been `enter`
+- Fixed typo in trigger event signature `exittrigger` should have been `exit`
+- Fixed typo in animation event signature `ended` should have been `end`
+- Fixed issue where some excalibur `clear()` implementations modified the collection they were iterating over
+- Fixed async issue where sound could not be stopped if `stop()`/`start()` were called in rapid succession
+- Fixed issue with input mapper where `keyboard.wasPressed(...)` did not fire
+- Fixed issue issue where TileMaps would not properly draw Tiles when setup in screen space coordinates
+- Fixed issue where the ex.Line graphics bounds were incorrect causing erroneous offscreen culling
+- Fixed event type signature on `ex.Engine.input.pointers.primary.on('wheel', ...)` for wheel events
+
+### Updates
+
+- Improved performance in TileMaps when drawing tiles using QuadTree data structure
+
+### Changed
+
+- Changed the canvas 2d fallback default, no longer is enabled by default. Developers must opt in.
+- Allow entity names to be set after construction! Entities will now default to a name "Entity#1234" followed by an id.
+
+<!--------------------------------- DO NOT EDIT BELOW THIS LINE --------------------------------->
+<!--------------------------------- DO NOT EDIT BELOW THIS LINE --------------------------------->
+<!--------------------------------- DO NOT EDIT BELOW THIS LINE --------------------------------->
+
+## [v0.28.0]
+
+### Breaking Changes
+
 - Removed `ex.Class` base class type, this was a common base class for many excalibur types that provided old on/off event functionality. This functionality has been preserved on the types that had it before using `ex.EventEmitter`
 
 ### Deprecated
@@ -193,11 +240,6 @@ stored `ex.Graphics` causing them to be shared across clones.
 - Excalibur resources by default no longer add cache busting query string to resources. All built in resources now expose a `bustCache` property to allow setting this before loading, for example `ex.Sound.bustCache`.
 
 
-
-<!--------------------------------- DO NOT EDIT BELOW THIS LINE --------------------------------->
-<!--------------------------------- DO NOT EDIT BELOW THIS LINE --------------------------------->
-<!--------------------------------- DO NOT EDIT BELOW THIS LINE --------------------------------->
-
 ## [0.27.0] - 2022-07-08
 
 ### Breaking Changes

package/build/dist/Actions/Action/ActionSequence.d.ts

@@ -1,19 +1,19 @@
-import { Entity } from '../../EntityComponentSystem';
-import { Action } from '../Action';
-import { ActionContext } from '../ActionContext';
-/**
- * Action that can represent a sequence of actions, this can be useful in conjunction with
- * [[ParallelActions]] to run multiple sequences in parallel.
- */
-export declare class ActionSequence implements Action {
-    private _actionQueue;
-    private _stopped;
-    private _sequenceContext;
-    private _sequenceBuilder;
-    constructor(entity: Entity, actionBuilder: (actionContext: ActionContext) => any);
-    update(delta: number): void;
-    isComplete(): boolean;
-    stop(): void;
-    reset(): void;
-    clone(entity: Entity): ActionSequence;
-}
+import { Entity } from '../../EntityComponentSystem';
+import { Action } from '../Action';
+import { ActionContext } from '../ActionContext';
+/**
+ * Action that can represent a sequence of actions, this can be useful in conjunction with
+ * [[ParallelActions]] to run multiple sequences in parallel.
+ */
+export declare class ActionSequence implements Action {
+    private _actionQueue;
+    private _stopped;
+    private _sequenceContext;
+    private _sequenceBuilder;
+    constructor(entity: Entity, actionBuilder: (actionContext: ActionContext) => any);
+    update(delta: number): void;
+    isComplete(): boolean;
+    stop(): void;
+    reset(): void;
+    clone(entity: Entity): ActionSequence;
+}

package/build/dist/Actions/Action/Blink.d.ts

@@ -1,17 +1,17 @@
-import { Entity } from '../../EntityComponentSystem/Entity';
-import { Action } from '../Action';
-export declare class Blink implements Action {
-    private _graphics;
-    private _timeVisible;
-    private _timeNotVisible;
-    private _elapsedTime;
-    private _totalTime;
-    private _duration;
-    private _stopped;
-    private _started;
-    constructor(entity: Entity, timeVisible: number, timeNotVisible: number, numBlinks?: number);
-    update(delta: number): void;
-    isComplete(): boolean;
-    stop(): void;
-    reset(): void;
-}
+import { Entity } from '../../EntityComponentSystem/Entity';
+import { Action } from '../Action';
+export declare class Blink implements Action {
+    private _graphics;
+    private _timeVisible;
+    private _timeNotVisible;
+    private _elapsedTime;
+    private _totalTime;
+    private _duration;
+    private _stopped;
+    private _started;
+    constructor(entity: Entity, timeVisible: number, timeNotVisible: number, numBlinks?: number);
+    update(delta: number): void;
+    isComplete(): boolean;
+    stop(): void;
+    reset(): void;
+}

package/build/dist/Actions/Action/CallMethod.d.ts

@@ -1,10 +1,10 @@
-import { Action } from '../Action';
-export declare class CallMethod implements Action {
-    private _method;
-    private _hasBeenCalled;
-    constructor(method: () => any);
-    update(_delta: number): void;
-    isComplete(): boolean;
-    reset(): void;
-    stop(): void;
-}
+import { Action } from '../Action';
+export declare class CallMethod implements Action {
+    private _method;
+    private _hasBeenCalled;
+    constructor(method: () => any);
+    update(_delta: number): void;
+    isComplete(): boolean;
+    reset(): void;
+    stop(): void;
+}

package/build/dist/Actions/Action/Delay.d.ts

@@ -1,12 +1,12 @@
-import { Action } from '../Action';
-export declare class Delay implements Action {
-    private _elapsedTime;
-    private _delay;
-    private _started;
-    private _stopped;
-    constructor(delay: number);
-    update(delta: number): void;
-    isComplete(): boolean;
-    stop(): void;
-    reset(): void;
-}
+import { Action } from '../Action';
+export declare class Delay implements Action {
+    private _elapsedTime;
+    private _delay;
+    private _started;
+    private _stopped;
+    constructor(delay: number);
+    update(delta: number): void;
+    isComplete(): boolean;
+    stop(): void;
+    reset(): void;
+}

package/build/dist/Actions/Action/Die.d.ts

@@ -1,11 +1,11 @@
-import { Entity } from '../../EntityComponentSystem/Entity';
-import { Action } from '../Action';
-export declare class Die implements Action {
-    private _entity;
-    private _stopped;
-    constructor(entity: Entity);
-    update(_delta: number): void;
-    isComplete(): boolean;
-    stop(): void;
-    reset(): void;
-}
+import { Entity } from '../../EntityComponentSystem/Entity';
+import { Action } from '../Action';
+export declare class Die implements Action {
+    private _entity;
+    private _stopped;
+    constructor(entity: Entity);
+    update(_delta: number): void;
+    isComplete(): boolean;
+    stop(): void;
+    reset(): void;
+}

package/build/dist/Actions/Action/EaseBy.d.ts

@@ -1,20 +1,20 @@
-import { Entity } from '../../EntityComponentSystem/Entity';
-import { Action } from '../Action';
-export declare class EaseBy implements Action {
-    easingFcn: (currentTime: number, startValue: number, endValue: number, duration: number) => number;
-    private _tx;
-    private _motion;
-    private _currentLerpTime;
-    private _lerpDuration;
-    private _lerpStart;
-    private _lerpEnd;
-    private _offset;
-    private _initialized;
-    private _stopped;
-    constructor(entity: Entity, offsetX: number, offsetY: number, duration: number, easingFcn: (currentTime: number, startValue: number, endValue: number, duration: number) => number);
-    private _initialize;
-    update(delta: number): void;
-    isComplete(): boolean;
-    reset(): void;
-    stop(): void;
-}
+import { Entity } from '../../EntityComponentSystem/Entity';
+import { Action } from '../Action';
+export declare class EaseBy implements Action {
+    easingFcn: (currentTime: number, startValue: number, endValue: number, duration: number) => number;
+    private _tx;
+    private _motion;
+    private _currentLerpTime;
+    private _lerpDuration;
+    private _lerpStart;
+    private _lerpEnd;
+    private _offset;
+    private _initialized;
+    private _stopped;
+    constructor(entity: Entity, offsetX: number, offsetY: number, duration: number, easingFcn: (currentTime: number, startValue: number, endValue: number, duration: number) => number);
+    private _initialize;
+    update(delta: number): void;
+    isComplete(): boolean;
+    reset(): void;
+    stop(): void;
+}

package/build/dist/Actions/Action/EaseTo.d.ts

@@ -1,19 +1,19 @@
-import { Entity } from '../../EntityComponentSystem/Entity';
-import { Action } from '../Action';
-export declare class EaseTo implements Action {
-    easingFcn: (currentTime: number, startValue: number, endValue: number, duration: number) => number;
-    private _tx;
-    private _motion;
-    private _currentLerpTime;
-    private _lerpDuration;
-    private _lerpStart;
-    private _lerpEnd;
-    private _initialized;
-    private _stopped;
-    constructor(entity: Entity, x: number, y: number, duration: number, easingFcn: (currentTime: number, startValue: number, endValue: number, duration: number) => number);
-    private _initialize;
-    update(delta: number): void;
-    isComplete(): boolean;
-    reset(): void;
-    stop(): void;
-}
+import { Entity } from '../../EntityComponentSystem/Entity';
+import { Action } from '../Action';
+export declare class EaseTo implements Action {
+    easingFcn: (currentTime: number, startValue: number, endValue: number, duration: number) => number;
+    private _tx;
+    private _motion;
+    private _currentLerpTime;
+    private _lerpDuration;
+    private _lerpStart;
+    private _lerpEnd;
+    private _initialized;
+    private _stopped;
+    constructor(entity: Entity, x: number, y: number, duration: number, easingFcn: (currentTime: number, startValue: number, endValue: number, duration: number) => number);
+    private _initialize;
+    update(delta: number): void;
+    isComplete(): boolean;
+    reset(): void;
+    stop(): void;
+}

package/build/dist/Actions/Action/Fade.d.ts

@@ -1,18 +1,18 @@
-import { Entity } from '../../EntityComponentSystem/Entity';
-import { Action } from '../Action';
-export declare class Fade implements Action {
-    private _graphics;
-    x: number;
-    y: number;
-    private _endOpacity;
-    private _speed;
-    private _ogspeed;
-    private _multiplier;
-    private _started;
-    private _stopped;
-    constructor(entity: Entity, endOpacity: number, speed: number);
-    update(delta: number): void;
-    isComplete(): boolean;
-    stop(): void;
-    reset(): void;
-}
+import { Entity } from '../../EntityComponentSystem/Entity';
+import { Action } from '../Action';
+export declare class Fade implements Action {
+    private _graphics;
+    x: number;
+    y: number;
+    private _endOpacity;
+    private _speed;
+    private _ogspeed;
+    private _multiplier;
+    private _started;
+    private _stopped;
+    constructor(entity: Entity, endOpacity: number, speed: number);
+    update(delta: number): void;
+    isComplete(): boolean;
+    stop(): void;
+    reset(): void;
+}

package/build/dist/Actions/Action/Follow.d.ts

@@ -1,23 +1,23 @@
-import { Entity } from '../../EntityComponentSystem/Entity';
-import { Action } from '../Action';
-export declare class Follow implements Action {
-    private _tx;
-    private _motion;
-    private _followTx;
-    private _followMotion;
-    x: number;
-    y: number;
-    private _current;
-    private _end;
-    private _dir;
-    private _speed;
-    private _maximumDistance;
-    private _distanceBetween;
-    private _started;
-    private _stopped;
-    constructor(entity: Entity, entityToFollow: Entity, followDistance?: number);
-    update(_delta: number): void;
-    stop(): void;
-    isComplete(): boolean;
-    reset(): void;
-}
+import { Entity } from '../../EntityComponentSystem/Entity';
+import { Action } from '../Action';
+export declare class Follow implements Action {
+    private _tx;
+    private _motion;
+    private _followTx;
+    private _followMotion;
+    x: number;
+    y: number;
+    private _current;
+    private _end;
+    private _dir;
+    private _speed;
+    private _maximumDistance;
+    private _distanceBetween;
+    private _started;
+    private _stopped;
+    constructor(entity: Entity, entityToFollow: Entity, followDistance?: number);
+    update(_delta: number): void;
+    stop(): void;
+    isComplete(): boolean;
+    reset(): void;
+}

package/build/dist/Actions/Action/Meet.d.ts

@@ -1,23 +1,23 @@
-import { Entity } from '../../EntityComponentSystem/Entity';
-import { Action } from '../Action';
-export declare class Meet implements Action {
-    private _tx;
-    private _motion;
-    private _meetTx;
-    private _meetMotion;
-    x: number;
-    y: number;
-    private _current;
-    private _end;
-    private _dir;
-    private _speed;
-    private _distanceBetween;
-    private _started;
-    private _stopped;
-    private _speedWasSpecified;
-    constructor(actor: Entity, actorToMeet: Entity, speed?: number);
-    update(_delta: number): void;
-    isComplete(): boolean;
-    stop(): void;
-    reset(): void;
-}
+import { Entity } from '../../EntityComponentSystem/Entity';
+import { Action } from '../Action';
+export declare class Meet implements Action {
+    private _tx;
+    private _motion;
+    private _meetTx;
+    private _meetMotion;
+    x: number;
+    y: number;
+    private _current;
+    private _end;
+    private _dir;
+    private _speed;
+    private _distanceBetween;
+    private _started;
+    private _stopped;
+    private _speedWasSpecified;
+    constructor(actor: Entity, actorToMeet: Entity, speed?: number);
+    update(_delta: number): void;
+    isComplete(): boolean;
+    stop(): void;
+    reset(): void;
+}

package/build/dist/Actions/Action/MoveBy.d.ts

@@ -1,22 +1,22 @@
-import { Entity } from '../../EntityComponentSystem/Entity';
-import { Action } from '../Action';
-export declare class MoveBy implements Action {
-    private _tx;
-    private _motion;
-    private _entity;
-    x: number;
-    y: number;
-    private _distance;
-    private _speed;
-    private _start;
-    private _offset;
-    private _end;
-    private _dir;
-    private _started;
-    private _stopped;
-    constructor(entity: Entity, offsetX: number, offsetY: number, speed: number);
-    update(_delta: number): void;
-    isComplete(entity: Entity): boolean;
-    stop(): void;
-    reset(): void;
-}
+import { Entity } from '../../EntityComponentSystem/Entity';
+import { Action } from '../Action';
+export declare class MoveBy implements Action {
+    private _tx;
+    private _motion;
+    private _entity;
+    x: number;
+    y: number;
+    private _distance;
+    private _speed;
+    private _start;
+    private _offset;
+    private _end;
+    private _dir;
+    private _started;
+    private _stopped;
+    constructor(entity: Entity, offsetX: number, offsetY: number, speed: number);
+    update(_delta: number): void;
+    isComplete(entity: Entity): boolean;
+    stop(): void;
+    reset(): void;
+}

package/build/dist/Actions/Action/MoveTo.d.ts

@@ -1,21 +1,21 @@
-import { Entity } from '../../EntityComponentSystem/Entity';
-import { Action } from '../Action';
-export declare class MoveTo implements Action {
-    entity: Entity;
-    private _tx;
-    private _motion;
-    x: number;
-    y: number;
-    private _start;
-    private _end;
-    private _dir;
-    private _speed;
-    private _distance;
-    private _started;
-    private _stopped;
-    constructor(entity: Entity, destx: number, desty: number, speed: number);
-    update(_delta: number): void;
-    isComplete(entity: Entity): boolean;
-    stop(): void;
-    reset(): void;
-}
+import { Entity } from '../../EntityComponentSystem/Entity';
+import { Action } from '../Action';
+export declare class MoveTo implements Action {
+    entity: Entity;
+    private _tx;
+    private _motion;
+    x: number;
+    y: number;
+    private _start;
+    private _end;
+    private _dir;
+    private _speed;
+    private _distance;
+    private _started;
+    private _stopped;
+    constructor(entity: Entity, destx: number, desty: number, speed: number);
+    update(_delta: number): void;
+    isComplete(entity: Entity): boolean;
+    stop(): void;
+    reset(): void;
+}

package/build/dist/Actions/Action/ParallelActions.d.ts

@@ -1,13 +1,13 @@
-import { Entity } from '../../EntityComponentSystem';
-import { Action } from '../Action';
-/**
- * Action that can run multiple [[Action]]s or [[ActionSequence]]s at the same time
- */
-export declare class ParallelActions implements Action {
-    private _actions;
-    constructor(parallelActions: Action[]);
-    update(delta: number): void;
-    isComplete(entity: Entity): boolean;
-    reset(): void;
-    stop(): void;
-}
+import { Entity } from '../../EntityComponentSystem';
+import { Action } from '../Action';
+/**
+ * Action that can run multiple [[Action]]s or [[ActionSequence]]s at the same time
+ */
+export declare class ParallelActions implements Action {
+    private _actions;
+    constructor(parallelActions: Action[]);
+    update(delta: number): void;
+    isComplete(entity: Entity): boolean;
+    reset(): void;
+    stop(): void;
+}

package/build/dist/Actions/Action/Repeat.d.ts

@@ -1,16 +1,16 @@
-import { Entity } from '../../EntityComponentSystem/Entity';
-import { Action } from '../Action';
-import { ActionContext } from '../ActionContext';
-export declare class Repeat implements Action {
-    private _actionQueue;
-    private _repeat;
-    private _originalRepeat;
-    private _stopped;
-    private _repeatContext;
-    private _repeatBuilder;
-    constructor(entity: Entity, repeatBuilder: (repeatContext: ActionContext) => any, repeat: number);
-    update(delta: number): void;
-    isComplete(): boolean;
-    stop(): void;
-    reset(): void;
-}
+import { Entity } from '../../EntityComponentSystem/Entity';
+import { Action } from '../Action';
+import { ActionContext } from '../ActionContext';
+export declare class Repeat implements Action {
+    private _actionQueue;
+    private _repeat;
+    private _originalRepeat;
+    private _stopped;
+    private _repeatContext;
+    private _repeatBuilder;
+    constructor(entity: Entity, repeatBuilder: (repeatContext: ActionContext) => any, repeat: number);
+    update(delta: number): void;
+    isComplete(): boolean;
+    stop(): void;
+    reset(): void;
+}

package/build/dist/Actions/Action/RepeatForever.d.ts

@@ -1,20 +1,20 @@
-import { Entity } from '../../EntityComponentSystem/Entity';
-import { Action } from '../Action';
-import { ActionContext } from '../ActionContext';
-/**
- * RepeatForever Action implementation, it is recommended you use the fluent action
- * context API.
- *
- *
- */
-export declare class RepeatForever implements Action {
-    private _actionQueue;
-    private _stopped;
-    private _repeatContext;
-    private _repeatBuilder;
-    constructor(entity: Entity, repeatBuilder: (repeatContext: ActionContext) => any);
-    update(delta: number): void;
-    isComplete(): boolean;
-    stop(): void;
-    reset(): void;
-}
+import { Entity } from '../../EntityComponentSystem/Entity';
+import { Action } from '../Action';
+import { ActionContext } from '../ActionContext';
+/**
+ * RepeatForever Action implementation, it is recommended you use the fluent action
+ * context API.
+ *
+ *
+ */
+export declare class RepeatForever implements Action {
+    private _actionQueue;
+    private _stopped;
+    private _repeatContext;
+    private _repeatBuilder;
+    constructor(entity: Entity, repeatBuilder: (repeatContext: ActionContext) => any);
+    update(delta: number): void;
+    isComplete(): boolean;
+    stop(): void;
+    reset(): void;
+}