excalibur 0.28.3 → 0.28.4

package/build/dist/Util/Log.js

@@ -0,0 +1,195 @@
+/* eslint-disable no-console */
+/**
+ * Logging level that Excalibur will tag
+ */
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["Debug"] = 0] = "Debug";
+    LogLevel[LogLevel["Info"] = 1] = "Info";
+    LogLevel[LogLevel["Warn"] = 2] = "Warn";
+    LogLevel[LogLevel["Error"] = 3] = "Error";
+    LogLevel[LogLevel["Fatal"] = 4] = "Fatal";
+})(LogLevel || (LogLevel = {}));
+/**
+ * Static singleton that represents the logging facility for Excalibur.
+ * Excalibur comes built-in with a [[ConsoleAppender]] and [[ScreenAppender]].
+ * Derive from [[Appender]] to create your own logging appenders.
+ */
+export class Logger {
+    constructor() {
+        this._appenders = [];
+        /**
+         * Gets or sets the default logging level. Excalibur will only log
+         * messages if equal to or above this level. Default: [[LogLevel.Info]]
+         */
+        this.defaultLevel = LogLevel.Info;
+        if (Logger._INSTANCE) {
+            throw new Error('Logger is a singleton');
+        }
+        Logger._INSTANCE = this;
+        // Default console appender
+        Logger._INSTANCE.addAppender(new ConsoleAppender());
+        return Logger._INSTANCE;
+    }
+    /**
+     * Gets the current static instance of Logger
+     */
+    static getInstance() {
+        if (Logger._INSTANCE == null) {
+            Logger._INSTANCE = new Logger();
+        }
+        return Logger._INSTANCE;
+    }
+    /**
+     * Adds a new [[Appender]] to the list of appenders to write to
+     */
+    addAppender(appender) {
+        this._appenders.push(appender);
+    }
+    /**
+     * Clears all appenders from the logger
+     */
+    clearAppenders() {
+        this._appenders.length = 0;
+    }
+    /**
+     * Logs a message at a given LogLevel
+     * @param level  The LogLevel`to log the message at
+     * @param args   An array of arguments to write to an appender
+     */
+    _log(level, args) {
+        if (level == null) {
+            level = this.defaultLevel;
+        }
+        const len = this._appenders.length;
+        for (let i = 0; i < len; i++) {
+            if (level >= this.defaultLevel) {
+                this._appenders[i].log(level, args);
+            }
+        }
+    }
+    /**
+     * Writes a log message at the [[LogLevel.Debug]] level
+     * @param args  Accepts any number of arguments
+     */
+    debug(...args) {
+        this._log(LogLevel.Debug, args);
+    }
+    /**
+     * Writes a log message at the [[LogLevel.Info]] level
+     * @param args  Accepts any number of arguments
+     */
+    info(...args) {
+        this._log(LogLevel.Info, args);
+    }
+    /**
+     * Writes a log message at the [[LogLevel.Warn]] level
+     * @param args  Accepts any number of arguments
+     */
+    warn(...args) {
+        this._log(LogLevel.Warn, args);
+    }
+    /**
+     * Writes a log message at the [[LogLevel.Error]] level
+     * @param args  Accepts any number of arguments
+     */
+    error(...args) {
+        this._log(LogLevel.Error, args);
+    }
+    /**
+     * Writes a log message at the [[LogLevel.Fatal]] level
+     * @param args  Accepts any number of arguments
+     */
+    fatal(...args) {
+        this._log(LogLevel.Fatal, args);
+    }
+}
+Logger._INSTANCE = null;
+/**
+ * Console appender for browsers (i.e. `console.log`)
+ */
+export class ConsoleAppender {
+    /**
+     * Logs a message at the given [[LogLevel]]
+     * @param level  Level to log at
+     * @param args   Arguments to log
+     */
+    log(level, args) {
+        // Check for console support
+        if (!console && !console.log && console.warn && console.error) {
+            // todo maybe do something better than nothing
+            return;
+        }
+        // Create a new console args array
+        const consoleArgs = [];
+        consoleArgs.unshift.apply(consoleArgs, args);
+        consoleArgs.unshift('[' + LogLevel[level] + '] : ');
+        if (level < LogLevel.Warn) {
+            // Call .log for Debug/Info
+            if (console.log.apply) {
+                // this is required on some older browsers that don't support apply on console.log :(
+                console.log.apply(console, consoleArgs);
+            }
+            else {
+                console.log(consoleArgs.join(' '));
+            }
+        }
+        else if (level < LogLevel.Error) {
+            // Call .warn for Warn
+            if (console.warn.apply) {
+                console.warn.apply(console, consoleArgs);
+            }
+            else {
+                console.warn(consoleArgs.join(' '));
+            }
+        }
+        else {
+            // Call .error for Error/Fatal
+            if (console.error.apply) {
+                console.error.apply(console, consoleArgs);
+            }
+            else {
+                console.error(consoleArgs.join(' '));
+            }
+        }
+    }
+}
+/**
+ * On-screen (canvas) appender
+ */
+export class ScreenAppender {
+    /**
+     * @param width   Width of the screen appender in pixels
+     * @param height  Height of the screen appender in pixels
+     */
+    constructor(width, height) {
+        // @todo Clean this up
+        this._messages = [];
+        this._canvas = document.createElement('canvas');
+        this._canvas.width = width || window.innerWidth;
+        this._canvas.height = height || window.innerHeight;
+        this._canvas.style.position = 'absolute';
+        // eslint-disable-next-line
+        this._ctx = this._canvas.getContext('2d'); // eslint-disable-line
+        document.body.appendChild(this._canvas);
+    }
+    /**
+     * Logs a message at the given [[LogLevel]]
+     * @param level  Level to log at
+     * @param args   Arguments to log
+     */
+    log(level, args) {
+        const message = args.join(',');
+        this._ctx.clearRect(0, 0, this._canvas.width, this._canvas.height);
+        this._messages.unshift('[' + LogLevel[level] + '] : ' + message);
+        let pos = 10;
+        let opacity = 1.0;
+        for (let i = 0; i < this._messages.length; i++) {
+            this._ctx.fillStyle = 'rgba(255,255,255,' + opacity.toFixed(2) + ')';
+            this._ctx.fillText(this._messages[i], 200, pos);
+            pos += 10;
+            opacity = opacity > 0 ? opacity - 0.05 : 0;
+        }
+    }
+}
+//# sourceMappingURL=Log.js.map

package/build/dist/Util/Log.js.map

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

package/build/dist/Util/Observable.js

@@ -0,0 +1,66 @@
+/**
+ * Simple Observable implementation
+ * @template T is the typescript Type that defines the data being observed
+ */
+export class Observable {
+    constructor() {
+        this.observers = [];
+        this.subscriptions = [];
+    }
+    /**
+     * Register an observer to listen to this observable
+     * @param observer
+     */
+    register(observer) {
+        this.observers.push(observer);
+    }
+    /**
+     * Register a callback to listen to this observable
+     * @param func
+     */
+    subscribe(func) {
+        this.subscriptions.push(func);
+    }
+    /**
+     * Remove an observer from the observable
+     * @param observer
+     */
+    unregister(observer) {
+        const i = this.observers.indexOf(observer);
+        if (i !== -1) {
+            this.observers.splice(i, 1);
+        }
+    }
+    /**
+     * Remove a callback that is listening to this observable
+     * @param func
+     */
+    unsubscribe(func) {
+        const i = this.subscriptions.indexOf(func);
+        if (i !== -1) {
+            this.subscriptions.splice(i, 1);
+        }
+    }
+    /**
+     * Broadcasts a message to all observers and callbacks
+     * @param message
+     */
+    notifyAll(message) {
+        const observersLength = this.observers.length;
+        for (let i = 0; i < observersLength; i++) {
+            this.observers[i].notify(message);
+        }
+        const subscriptionsLength = this.subscriptions.length;
+        for (let i = 0; i < subscriptionsLength; i++) {
+            this.subscriptions[i](message);
+        }
+    }
+    /**
+     * Removes all observers and callbacks
+     */
+    clear() {
+        this.observers.length = 0;
+        this.subscriptions.length = 0;
+    }
+}
+//# sourceMappingURL=Observable.js.map

package/build/dist/Util/Observable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Observable.js","sourceRoot":"","sources":["../../../src/engine/Util/Observable.ts"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,MAAM,OAAO,UAAU;IAAvB;QACS,cAAS,GAAkB,EAAE,CAAC;QAC9B,kBAAa,GAAwB,EAAE,CAAC;IA8DjD,CAAC;IA5DC;;;OAGG;IACH,QAAQ,CAAC,QAAqB;QAC5B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,IAAqB;QAC7B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,QAAqB;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACb,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,IAAqB;QAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACb,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,OAAU;QAClB,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;QAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;QACD,MAAM,mBAAmB,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;QACtD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,mBAAmB,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;IAChC,CAAC;CACF"}

package/build/dist/Util/Pool.js

@@ -0,0 +1,74 @@
+import { Logger } from '..';
+export class Pool {
+    constructor(builder, recycler, maxObjects = 100) {
+        this.builder = builder;
+        this.recycler = recycler;
+        this.maxObjects = maxObjects;
+        this.totalAllocations = 0;
+        this.index = 0;
+        this.objects = [];
+        this.disableWarnings = false;
+        this._logger = Logger.getInstance();
+    }
+    preallocate() {
+        for (let i = 0; i < this.maxObjects; i++) {
+            this.objects[i] = this.builder();
+        }
+    }
+    /**
+     * Use many instances out of the in the context and return all to the pool.
+     *
+     * By returning values out of the context they will be un-hooked from the pool and are free to be passed to consumers
+     * @param context
+     */
+    using(context) {
+        const result = context(this);
+        if (result) {
+            return this.done(...result);
+        }
+        return this.done();
+    }
+    /**
+     * Use a single instance out of th pool and immediately return it to the pool
+     * @param context
+     */
+    borrow(context) {
+        const object = this.get();
+        context(object);
+        this.index--;
+    }
+    /**
+     * Retrieve a value from the pool, will allocate a new instance if necessary or recycle from the pool
+     * @param args
+     */
+    get(...args) {
+        if (this.index === this.maxObjects) {
+            if (!this.disableWarnings) {
+                this._logger.warn('Max pooled objects reached, possible memory leak? Doubling');
+            }
+            this.maxObjects = this.maxObjects * 2;
+        }
+        if (this.objects[this.index]) {
+            // Pool has an available object already constructed
+            return this.recycler(this.objects[this.index++], ...args);
+        }
+        else {
+            // New allocation
+            this.totalAllocations++;
+            const object = (this.objects[this.index++] = this.builder(...args));
+            return object;
+        }
+    }
+    done(...objects) {
+        // All objects in pool now considered "free"
+        this.index = 0;
+        for (const object of objects) {
+            const poolIndex = this.objects.indexOf(object);
+            // Build a new object to take the pool place
+            this.objects[poolIndex] = this.builder(); // TODO problematic 0-arg only support
+            this.totalAllocations++;
+        }
+        return objects;
+    }
+}
+//# sourceMappingURL=Pool.js.map

package/build/dist/Util/Pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pool.js","sourceRoot":"","sources":["../../../src/engine/Util/Pool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,MAAM,OAAO,IAAI;IAOf,YACS,OAAiC,EACjC,QAAkD,EAClD,aAAqB,GAAG;QAFxB,YAAO,GAAP,OAAO,CAA0B;QACjC,aAAQ,GAAR,QAAQ,CAA0C;QAClD,eAAU,GAAV,UAAU,CAAc;QAT1B,qBAAgB,GAAG,CAAC,CAAC;QACrB,UAAK,GAAG,CAAC,CAAC;QACV,YAAO,GAAW,EAAE,CAAC;QACrB,oBAAe,GAAG,KAAK,CAAC;QACvB,YAAO,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAMpC,CAAC;IAEJ,WAAW;QACT,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAA4C;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,OAA+B;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1B,OAAO,CAAC,MAAM,CAAC,CAAC;QAChB,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,GAAG,IAAW;QAChB,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;gBAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,mDAAmD;YACnD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,iBAAiB;YACjB,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;YACpE,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAWD,IAAI,CAAC,GAAG,OAAe;QACrB,4CAA4C;QAC5C,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC/C,4CAA4C;YAC5C,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,GAAI,IAAY,CAAC,OAAO,EAAE,CAAC,CAAC,sCAAsC;YACzF,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC1B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}

package/build/dist/Util/Semaphore.js

@@ -0,0 +1,55 @@
+import { Future } from './Future';
+class AsyncWaitQueue {
+    constructor() {
+        // Code from StephenCleary https://gist.github.com/StephenCleary/ba50b2da419c03b9cba1d20cb4654d5e
+        this._queue = [];
+    }
+    get length() {
+        return this._queue.length;
+    }
+    enqueue() {
+        const future = new Future();
+        this._queue.push(future);
+        return future.promise;
+    }
+    dequeue(value) {
+        const future = this._queue.shift();
+        future.resolve(value);
+    }
+}
+/**
+ * Semaphore allows you to limit the amount of async calls happening between `enter()` and `exit()`
+ *
+ * This can be useful when limiting the number of http calls, browser api calls, etc either for performance or to work
+ * around browser limitations like max Image.decode() calls in chromium being 256.
+ */
+export class Semaphore {
+    constructor(_count) {
+        this._count = _count;
+        this._waitQueue = new AsyncWaitQueue();
+    }
+    get count() {
+        return this._count;
+    }
+    get waiting() {
+        return this._waitQueue.length;
+    }
+    async enter() {
+        if (this._count !== 0) {
+            this._count--;
+            return Promise.resolve();
+        }
+        return this._waitQueue.enqueue();
+    }
+    exit(count = 1) {
+        if (count === 0) {
+            return;
+        }
+        while (count !== 0 && this._waitQueue.length !== 0) {
+            this._waitQueue.dequeue(null);
+            count--;
+        }
+        this._count += count;
+    }
+}
+//# sourceMappingURL=Semaphore.js.map

package/build/dist/Util/Semaphore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Semaphore.js","sourceRoot":"","sources":["../../../src/engine/Util/Semaphore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,cAAc;IAApB;QACE,iGAAiG;QACzF,WAAM,GAAgB,EAAE,CAAC;IAgBnC,CAAC;IAdC,IAAW,MAAM;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAEM,OAAO;QACZ,MAAM,MAAM,GAAG,IAAI,MAAM,EAAK,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAEM,OAAO,CAAC,KAAQ;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACnC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,SAAS;IAEpB,YAAoB,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QAD1B,eAAU,GAAG,IAAI,cAAc,EAAE,CAAC;IACJ,CAAC;IAEvC,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAW,OAAO;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAChC,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IAEM,IAAI,CAAC,QAAgB,CAAC;QAC3B,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QACD,OAAO,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC9B,KAAK,EAAE,CAAC;QACV,CAAC;QACD,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC;IACvB,CAAC;CACF"}

package/build/dist/Util/Sound.js

@@ -0,0 +1,22 @@
+import { Logger } from './Log';
+/**
+ * Whether or not the browser can play this file as HTML5 Audio
+ */
+export function canPlayFile(file) {
+    try {
+        const a = new Audio();
+        const filetype = /.*\.([A-Za-z0-9]+)(?:(?:\?|\#).*)*$/;
+        const type = file.match(filetype)[1];
+        if (a.canPlayType('audio/' + type)) {
+            return true;
+        }
+        else {
+            return false;
+        }
+    }
+    catch (e) {
+        Logger.getInstance().warn('Cannot determine audio support, assuming no support for the Audio Tag', e);
+        return false;
+    }
+}
+//# sourceMappingURL=Sound.js.map

package/build/dist/Util/Sound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Sound.js","sourceRoot":"","sources":["../../../src/engine/Util/Sound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,qCAAqC,CAAC;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC,WAAW,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;aAAM,CAAC;YACN,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,uEAAuE,EAAE,CAAC,CAAC,CAAC;QACtG,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/build/dist/Util/StateMachine.js

@@ -0,0 +1,79 @@
+export class StateMachine {
+    constructor() {
+        this.states = new Map();
+    }
+    get currentState() {
+        return this._currentState;
+    }
+    set currentState(state) {
+        this._currentState = state;
+    }
+    static create(machineDescription, data) {
+        const machine = new StateMachine();
+        machine.data = data;
+        for (const stateName in machineDescription.states) {
+            machine.states.set(stateName, {
+                name: stateName,
+                ...machineDescription.states[stateName]
+            });
+        }
+        // validate transitions are states
+        for (const state of machine.states.values()) {
+            for (const transitionState of state.transitions) {
+                if (transitionState === '*') {
+                    continue;
+                }
+                if (!machine.states.has(transitionState)) {
+                    throw Error(`Invalid state machine, state [${state.name}] has a transition to another state that doesn't exist [${transitionState}]`);
+                }
+            }
+        }
+        machine.currentState = machine.startState = machine.states.get(machineDescription.start);
+        return machine;
+    }
+    in(state) {
+        return this.currentState.name === state;
+    }
+    go(stateName, eventData) {
+        var _a, _b;
+        if (this.currentState.transitions.includes(stateName) || this.currentState.transitions.includes('*')) {
+            const potentialNewState = this.states.get(stateName);
+            if (this.currentState.onExit) {
+                const canExit = (_a = this.currentState) === null || _a === void 0 ? void 0 : _a.onExit({ to: potentialNewState.name, data: this.data });
+                if (canExit === false) {
+                    return false;
+                }
+            }
+            if (potentialNewState === null || potentialNewState === void 0 ? void 0 : potentialNewState.onEnter) {
+                const canEnter = potentialNewState === null || potentialNewState === void 0 ? void 0 : potentialNewState.onEnter({ from: this.currentState.name, eventData, data: this.data });
+                if (canEnter === false) {
+                    return false;
+                }
+            }
+            // console.log(`${this.currentState.name} => ${potentialNewState.name} (${eventData})`);
+            this.currentState = potentialNewState;
+            if ((_b = this.currentState) === null || _b === void 0 ? void 0 : _b.onState) {
+                this.currentState.onState();
+            }
+            return true;
+        }
+        return false;
+    }
+    update(elapsedMs) {
+        if (this.currentState.onUpdate) {
+            this.currentState.onUpdate(this.data, elapsedMs);
+        }
+    }
+    save(saveKey) {
+        localStorage.setItem(saveKey, JSON.stringify({
+            currentState: this.currentState.name,
+            data: this.data
+        }));
+    }
+    restore(saveKey) {
+        const state = JSON.parse(localStorage.getItem(saveKey));
+        this.currentState = this.states.get(state.currentState);
+        this.data = state.data;
+    }
+}
+//# sourceMappingURL=StateMachine.js.map

package/build/dist/Util/StateMachine.js.map

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

package/build/dist/Util/Toaster.css

@@ -1,29 +1,29 @@
-
-#ex-toast-container {
-  position: absolute;
-  height: 0;
-  min-width: 50%;
-  left: 50%;
-  top: 0;
-}
-
-.ex-toast-message {
-  left: -50%;
-  position: relative;
-  display: flex;
-  justify-content: space-between;
-
-
-  padding: 10px;
-  margin-top: 5px;
-  font-size: 18px;
-  font-family: sans-serif;
-  border-radius: 6px;
-  border: 3px solid #b7b779;
-  background-color: rgb(253, 253, 192);
-}
-
-
-.ex-toast-message button {
-  align-self: flex-start;
+
+#ex-toast-container {
+  position: absolute;
+  height: 0;
+  min-width: 50%;
+  left: 50%;
+  top: 0;
+}
+
+.ex-toast-message {
+  left: -50%;
+  position: relative;
+  display: flex;
+  justify-content: space-between;
+
+
+  padding: 10px;
+  margin-top: 5px;
+  font-size: 18px;
+  font-family: sans-serif;
+  border-radius: 6px;
+  border: 3px solid #b7b779;
+  background-color: rgb(253, 253, 192);
+}
+
+
+.ex-toast-message button {
+  align-self: flex-start;
 }

package/build/dist/Util/Toaster.js

@@ -0,0 +1,84 @@
+import toasterCss from './Toaster.css';
+/**
+ * The Toaster is only meant to be called from inside Excalibur to display messages to players
+ */
+export class Toaster {
+    constructor() {
+        this._toasterCss = toasterCss.toString();
+        this._isInitialized = false;
+    }
+    _initialize() {
+        if (!this._isInitialized) {
+            this._container = document.createElement('div');
+            this._container.id = 'ex-toast-container';
+            document.body.appendChild(this._container);
+            this._isInitialized = true;
+            this._styleBlock = document.createElement('style');
+            this._styleBlock.textContent = this._toasterCss;
+            document.head.appendChild(this._styleBlock);
+        }
+    }
+    dispose() {
+        this._container.parentElement.removeChild(this._container);
+        this._styleBlock.parentElement.removeChild(this._styleBlock);
+        this._isInitialized = false;
+    }
+    _createFragment(message) {
+        const toastMessage = document.createElement('span');
+        toastMessage.innerText = message;
+        return toastMessage;
+    }
+    /**
+     * Display a toast message to a player
+     * @param message Text of the message, messages may have a single "[LINK]" to influence placement
+     * @param linkTarget Optionally specify a link location
+     * @param linkName Optionally specify a name for that link location
+     */
+    toast(message, linkTarget, linkName) {
+        this._initialize();
+        const toast = document.createElement('div');
+        toast.className = 'ex-toast-message';
+        const messageFragments = message.split('[LINK]').map(message => this._createFragment(message));
+        if (linkTarget) {
+            const link = document.createElement('a');
+            link.href = linkTarget;
+            if (linkName) {
+                link.innerText = linkName;
+            }
+            else {
+                link.innerText = linkTarget;
+            }
+            messageFragments.splice(1, 0, link);
+        }
+        // Assembly message
+        const finalMessage = document.createElement('div');
+        messageFragments.forEach(message => {
+            finalMessage.appendChild(message);
+        });
+        toast.appendChild(finalMessage);
+        // Dismiss button
+        const dismissBtn = document.createElement('button');
+        dismissBtn.innerText = 'x';
+        dismissBtn.addEventListener('click', () => {
+            this._container.removeChild(toast);
+        });
+        toast.appendChild(dismissBtn);
+        // Escape to dismiss
+        const keydownHandler = (evt) => {
+            if (evt.key === 'Escape') {
+                try {
+                    this._container.removeChild(toast);
+                }
+                catch (_a) {
+                    // pass
+                }
+            }
+            document.removeEventListener('keydown', keydownHandler);
+        };
+        document.addEventListener('keydown', keydownHandler);
+        // Insert into container
+        const first = this._container.firstChild;
+        this._container.insertBefore(toast, first);
+    }
+}
+//# sourceMappingURL=Toaster.js.map