excalibur 0.28.3 → 0.28.4

package/build/dist/Events.js

@@ -0,0 +1,473 @@
+export var EventTypes;
+(function (EventTypes) {
+    EventTypes["Kill"] = "kill";
+    EventTypes["PreKill"] = "prekill";
+    EventTypes["PostKill"] = "postkill";
+    EventTypes["PreDraw"] = "predraw";
+    EventTypes["PostDraw"] = "postdraw";
+    EventTypes["PreDebugDraw"] = "predebugdraw";
+    EventTypes["PostDebugDraw"] = "postdebugdraw";
+    EventTypes["PreUpdate"] = "preupdate";
+    EventTypes["PostUpdate"] = "postupdate";
+    EventTypes["PreFrame"] = "preframe";
+    EventTypes["PostFrame"] = "postframe";
+    EventTypes["PreCollision"] = "precollision";
+    EventTypes["CollisionStart"] = "collisionstart";
+    EventTypes["CollisionEnd"] = "collisionend";
+    EventTypes["PostCollision"] = "postcollision";
+    EventTypes["Initialize"] = "initialize";
+    EventTypes["Activate"] = "activate";
+    EventTypes["Deactivate"] = "deactivate";
+    EventTypes["ExitViewport"] = "exitviewport";
+    EventTypes["EnterViewport"] = "enterviewport";
+    EventTypes["ExitTrigger"] = "exit";
+    EventTypes["EnterTrigger"] = "enter";
+    EventTypes["Connect"] = "connect";
+    EventTypes["Disconnect"] = "disconnect";
+    EventTypes["Button"] = "button";
+    EventTypes["Axis"] = "axis";
+    EventTypes["Visible"] = "visible";
+    EventTypes["Hidden"] = "hidden";
+    EventTypes["Start"] = "start";
+    EventTypes["Stop"] = "stop";
+    EventTypes["PointerUp"] = "pointerup";
+    EventTypes["PointerDown"] = "pointerdown";
+    EventTypes["PointerMove"] = "pointermove";
+    EventTypes["PointerEnter"] = "pointerenter";
+    EventTypes["PointerLeave"] = "pointerleave";
+    EventTypes["PointerCancel"] = "pointercancel";
+    EventTypes["PointerWheel"] = "pointerwheel";
+    EventTypes["Up"] = "up";
+    EventTypes["Down"] = "down";
+    EventTypes["Move"] = "move";
+    EventTypes["Enter"] = "enter";
+    EventTypes["Leave"] = "leave";
+    EventTypes["Cancel"] = "cancel";
+    EventTypes["Wheel"] = "wheel";
+    EventTypes["Press"] = "press";
+    EventTypes["Release"] = "release";
+    EventTypes["Hold"] = "hold";
+    EventTypes["PointerDragStart"] = "pointerdragstart";
+    EventTypes["PointerDragEnd"] = "pointerdragend";
+    EventTypes["PointerDragEnter"] = "pointerdragenter";
+    EventTypes["PointerDragLeave"] = "pointerdragleave";
+    EventTypes["PointerDragMove"] = "pointerdragmove";
+})(EventTypes || (EventTypes = {}));
+/**
+ * Base event type in Excalibur that all other event types derive from. Not all event types are thrown on all Excalibur game objects,
+ * some events are unique to a type, others are not.
+ *
+ */
+export class GameEvent {
+    constructor() {
+        this._bubbles = true;
+    }
+    /**
+     * If set to false, prevents event from propagating to other actors. If true it will be propagated
+     * to all actors that apply.
+     */
+    get bubbles() {
+        return this._bubbles;
+    }
+    set bubbles(value) {
+        this._bubbles = value;
+    }
+    /**
+     * Prevents event from bubbling
+     */
+    stopPropagation() {
+        this.bubbles = false;
+    }
+}
+/**
+ * The 'kill' event is emitted on actors when it is killed. The target is the actor that was killed.
+ */
+export class KillEvent extends GameEvent {
+    constructor(target) {
+        super();
+        this.target = target;
+    }
+}
+/**
+ * The 'prekill' event is emitted directly before an actor is killed.
+ */
+export class PreKillEvent extends GameEvent {
+    constructor(target) {
+        super();
+        this.target = target;
+    }
+}
+/**
+ * The 'postkill' event is emitted directly after the actor is killed.
+ */
+export class PostKillEvent extends GameEvent {
+    constructor(target) {
+        super();
+        this.target = target;
+    }
+}
+/**
+ * The 'start' event is emitted on engine when has started and is ready for interaction.
+ */
+export class GameStartEvent extends GameEvent {
+    constructor(target) {
+        super();
+        this.target = target;
+    }
+}
+/**
+ * The 'stop' event is emitted on engine when has been stopped and will no longer take input, update or draw.
+ */
+export class GameStopEvent extends GameEvent {
+    constructor(target) {
+        super();
+        this.target = target;
+    }
+}
+/**
+ * The 'predraw' event is emitted on actors, scenes, and engine before drawing starts. Actors' predraw happens inside their graphics
+ * transform so that all drawing takes place with the actor as the origin.
+ *
+ */
+export class PreDrawEvent extends GameEvent {
+    constructor(ctx, delta, target) {
+        super();
+        this.ctx = ctx;
+        this.delta = delta;
+        this.target = target;
+    }
+}
+/**
+ * The 'postdraw' event is emitted on actors, scenes, and engine after drawing finishes. Actors' postdraw happens inside their graphics
+ * transform so that all drawing takes place with the actor as the origin.
+ *
+ */
+export class PostDrawEvent extends GameEvent {
+    constructor(ctx, delta, target) {
+        super();
+        this.ctx = ctx;
+        this.delta = delta;
+        this.target = target;
+    }
+}
+/**
+ * The 'predebugdraw' event is emitted on actors, scenes, and engine before debug drawing starts.
+ */
+export class PreDebugDrawEvent extends GameEvent {
+    constructor(ctx, target) {
+        super();
+        this.ctx = ctx;
+        this.target = target;
+    }
+}
+/**
+ * The 'postdebugdraw' event is emitted on actors, scenes, and engine after debug drawing starts.
+ */
+export class PostDebugDrawEvent extends GameEvent {
+    constructor(ctx, target) {
+        super();
+        this.ctx = ctx;
+        this.target = target;
+    }
+}
+/**
+ * The 'preupdate' event is emitted on actors, scenes, camera, and engine before the update starts.
+ */
+export class PreUpdateEvent extends GameEvent {
+    constructor(engine, delta, target) {
+        super();
+        this.engine = engine;
+        this.delta = delta;
+        this.target = target;
+    }
+}
+/**
+ * The 'postupdate' event is emitted on actors, scenes, camera, and engine after the update ends.
+ */
+export class PostUpdateEvent extends GameEvent {
+    constructor(engine, delta, target) {
+        super();
+        this.engine = engine;
+        this.delta = delta;
+        this.target = target;
+    }
+}
+/**
+ * The 'preframe' event is emitted on the engine, before the frame begins.
+ */
+export class PreFrameEvent extends GameEvent {
+    constructor(engine, prevStats) {
+        super();
+        this.engine = engine;
+        this.prevStats = prevStats;
+        this.target = engine;
+    }
+}
+/**
+ * The 'postframe' event is emitted on the engine, after a frame ends.
+ */
+export class PostFrameEvent extends GameEvent {
+    constructor(engine, stats) {
+        super();
+        this.engine = engine;
+        this.stats = stats;
+        this.target = engine;
+    }
+}
+/**
+ * Event received when a gamepad is connected to Excalibur. [[Gamepads]] receives this event.
+ */
+export class GamepadConnectEvent extends GameEvent {
+    constructor(index, gamepad) {
+        super();
+        this.index = index;
+        this.gamepad = gamepad;
+        this.target = gamepad;
+    }
+}
+/**
+ * Event received when a gamepad is disconnected from Excalibur. [[Gamepads]] receives this event.
+ */
+export class GamepadDisconnectEvent extends GameEvent {
+    constructor(index, gamepad) {
+        super();
+        this.index = index;
+        this.gamepad = gamepad;
+        this.target = gamepad;
+    }
+}
+/**
+ * Gamepad button event. See [[Gamepads]] for information on responding to controller input. [[Gamepad]] instances receive this event;
+ */
+export class GamepadButtonEvent extends GameEvent {
+    /**
+     * @param button  The Gamepad button
+     * @param value   A numeric value between 0 and 1
+     */
+    constructor(button, value, target) {
+        super();
+        this.button = button;
+        this.value = value;
+        this.target = target;
+    }
+}
+/**
+ * Gamepad axis event. See [[Gamepads]] for information on responding to controller input. [[Gamepad]] instances receive this event;
+ */
+export class GamepadAxisEvent extends GameEvent {
+    /**
+     * @param axis  The Gamepad axis
+     * @param value A numeric value between -1 and 1
+     */
+    constructor(axis, value, target) {
+        super();
+        this.axis = axis;
+        this.value = value;
+        this.target = target;
+    }
+}
+/**
+ * Event received by the [[Engine]] when the browser window is visible on a screen.
+ */
+export class VisibleEvent extends GameEvent {
+    constructor(target) {
+        super();
+        this.target = target;
+    }
+}
+/**
+ * Event received by the [[Engine]] when the browser window is hidden from all screens.
+ */
+export class HiddenEvent extends GameEvent {
+    constructor(target) {
+        super();
+        this.target = target;
+    }
+}
+/**
+ * Event thrown on an [[Actor|actor]] when a collision will occur this frame if it resolves
+ */
+export class PreCollisionEvent extends GameEvent {
+    /**
+     * @param actor         The actor the event was thrown on
+     * @param other         The actor that will collided with the current actor
+     * @param side          The side that will be collided with the current actor
+     * @param intersection  Intersection vector
+     */
+    constructor(actor, other, side, intersection) {
+        super();
+        this.other = other;
+        this.side = side;
+        this.intersection = intersection;
+        this.target = actor;
+    }
+}
+/**
+ * Event thrown on an [[Actor|actor]] when a collision has been resolved (body reacted) this frame
+ */
+export class PostCollisionEvent extends GameEvent {
+    /**
+     * @param actor         The actor the event was thrown on
+     * @param other         The actor that did collide with the current actor
+     * @param side          The side that did collide with the current actor
+     * @param intersection  Intersection vector
+     */
+    constructor(actor, other, side, intersection) {
+        super();
+        this.other = other;
+        this.side = side;
+        this.intersection = intersection;
+        this.target = actor;
+    }
+    get actor() {
+        return this.target;
+    }
+    set actor(actor) {
+        this.target = actor;
+    }
+}
+export class ContactStartEvent {
+    constructor(target, other, contact) {
+        this.target = target;
+        this.other = other;
+        this.contact = contact;
+    }
+}
+export class ContactEndEvent {
+    constructor(target, other) {
+        this.target = target;
+        this.other = other;
+    }
+}
+export class CollisionPreSolveEvent {
+    constructor(target, other, side, intersection, contact) {
+        this.target = target;
+        this.other = other;
+        this.side = side;
+        this.intersection = intersection;
+        this.contact = contact;
+    }
+}
+export class CollisionPostSolveEvent {
+    constructor(target, other, side, intersection, contact) {
+        this.target = target;
+        this.other = other;
+        this.side = side;
+        this.intersection = intersection;
+        this.contact = contact;
+    }
+}
+/**
+ * Event thrown the first time an [[Actor|actor]] collides with another, after an actor is in contact normal collision events are fired.
+ */
+export class CollisionStartEvent extends GameEvent {
+    /**
+     *
+     * @param actor
+     * @param other
+     * @param contact
+     */
+    constructor(actor, other, contact) {
+        super();
+        this.other = other;
+        this.contact = contact;
+        this.target = actor;
+    }
+    get actor() {
+        return this.target;
+    }
+    set actor(actor) {
+        this.target = actor;
+    }
+}
+/**
+ * Event thrown when the [[Actor|actor]] is no longer colliding with another
+ */
+export class CollisionEndEvent extends GameEvent {
+    /**
+     *
+     */
+    constructor(actor, other) {
+        super();
+        this.other = other;
+        this.target = actor;
+    }
+    get actor() {
+        return this.target;
+    }
+    set actor(actor) {
+        this.target = actor;
+    }
+}
+/**
+ * Event thrown on an [[Actor]], [[Scene]], and [[Engine]] only once before the first update call
+ */
+export class InitializeEvent extends GameEvent {
+    /**
+     * @param engine  The reference to the current engine
+     */
+    constructor(engine, target) {
+        super();
+        this.engine = engine;
+        this.target = target;
+    }
+}
+/**
+ * Event thrown on a [[Scene]] on activation
+ */
+export class ActivateEvent extends GameEvent {
+    /**
+     * @param context  The context for the scene activation
+     */
+    constructor(context, target) {
+        super();
+        this.context = context;
+        this.target = target;
+    }
+}
+/**
+ * Event thrown on a [[Scene]] on deactivation
+ */
+export class DeactivateEvent extends GameEvent {
+    /**
+     * @param context  The context for the scene deactivation
+     */
+    constructor(context, target) {
+        super();
+        this.context = context;
+        this.target = target;
+    }
+}
+/**
+ * Event thrown on an [[Actor]] when it completely leaves the screen.
+ */
+export class ExitViewPortEvent extends GameEvent {
+    constructor(target) {
+        super();
+        this.target = target;
+    }
+}
+/**
+ * Event thrown on an [[Actor]] when it completely leaves the screen.
+ */
+export class EnterViewPortEvent extends GameEvent {
+    constructor(target) {
+        super();
+        this.target = target;
+    }
+}
+export class EnterTriggerEvent extends GameEvent {
+    constructor(target, actor) {
+        super();
+        this.target = target;
+        this.actor = actor;
+    }
+}
+export class ExitTriggerEvent extends GameEvent {
+    constructor(target, actor) {
+        super();
+        this.target = target;
+        this.actor = actor;
+    }
+}
+//# sourceMappingURL=Events.js.map

package/build/dist/Events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Events.js","sourceRoot":"","sources":["../../src/engine/Events.ts"],"names":[],"mappings":"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"}

package/build/dist/Flags.js

@@ -0,0 +1,67 @@
+/**
+ * Flags is a feature flag implementation for Excalibur. They can only be operated **before [[Engine]] construction**
+ * after which they are frozen and are read-only.
+ *
+ * Flags are used to enable experimental or preview features in Excalibur.
+ */
+export class Flags {
+    /**
+     * Force excalibur to load the Canvas 2D graphics context fallback
+     * @warning not all features of excalibur are supported in the Canvas 2D fallback
+     */
+    static useCanvasGraphicsContext() {
+        Flags.enable('use-canvas-context');
+    }
+    /**
+     * Freeze all flag modifications making them readonly
+     */
+    static freeze() {
+        Flags._FROZEN = true;
+    }
+    /**
+     * Resets internal flag state, not meant to be called by users. Only used for testing.
+     *
+     * Calling this in your game is UNSUPPORTED
+     * @internal
+     */
+    static _reset() {
+        Flags._FROZEN = false;
+        Flags._FLAGS = {};
+    }
+    /**
+     * Enable a specific feature flag by name. **Note: can only be set before [[Engine]] constructor time**
+     * @param flagName
+     */
+    static enable(flagName) {
+        if (this._FROZEN) {
+            throw Error('Feature flags can only be enabled before Engine constructor time');
+        }
+        Flags._FLAGS[flagName] = true;
+    }
+    /**
+     * Disable a specific feature flag by name. **Note: can only be set before [[Engine]] constructor time**
+     * @param flagName
+     */
+    static disable(flagName) {
+        if (this._FROZEN) {
+            throw Error('Feature flags can only be disabled before Engine constructor time');
+        }
+        Flags._FLAGS[flagName] = false;
+    }
+    /**
+     * Check if a flag is enabled. If the flag is disabled or does not exist `false` is returned
+     * @param flagName
+     */
+    static isEnabled(flagName) {
+        return !!Flags._FLAGS[flagName];
+    }
+    /**
+     * Show a list of currently known flags
+     */
+    static show() {
+        return Object.keys(Flags._FLAGS);
+    }
+}
+Flags._FROZEN = false;
+Flags._FLAGS = {};
+//# sourceMappingURL=Flags.js.map

package/build/dist/Flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Flags.js","sourceRoot":"","sources":["../../src/engine/Flags.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,MAAM,OAAO,KAAK;IAKhB;;;OAGG;IACI,MAAM,CAAC,wBAAwB;QACpC,KAAK,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,MAAM;QAClB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,MAAM;QAClB,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC;QACtB,KAAK,CAAC,MAAM,GAAG,EAAE,CAAC;IACpB,CAAC;IACD;;;OAGG;IACI,MAAM,CAAC,MAAM,CAAC,QAAgB;QACnC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,KAAK,CAAC,kEAAkE,CAAC,CAAC;QAClF,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAChC,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,OAAO,CAAC,QAAgB;QACpC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,KAAK,CAAC,mEAAmE,CAAC,CAAC;QACnF,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IACjC,CAAC;IAED;;;OAGG;IACI,MAAM,CAAC,SAAS,CAAC,QAAgB;QACtC,OAAO,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,IAAI;QAChB,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;;AAhEc,aAAO,GAAG,KAAK,CAAC;AAChB,YAAM,GAA4B,EAAE,CAAC"}