mage-engine 3.21.0 → 3.21.2

package/.prettierrc.js

@@ -0,0 +1,20 @@
+"use strict";
+
+module.exports = {
+  printWidth: 100,
+  trailingComma: "all",
+  arrowParens: "avoid",
+  semi: true,
+  tabWidth: 4,
+
+  overrides: [
+    {
+      files: ["*.md"],
+      options: { printWidth: 120 },
+    },
+    {
+      files: [".toolsharerc"],
+      options: { parser: "yaml" },
+    },
+  ],
+};

package/dist/mage.js

@@ -878,6 +878,27 @@ function updateContext(context, _event, assignActions, state) {
 
 var warn = function () {};
 
+if (!IS_PRODUCTION) {
+  warn = function (condition, message) {
+    var error = condition instanceof Error ? condition : undefined;
+
+    if (!error && condition) {
+      return;
+    }
+
+    if (console !== undefined) {
+      var args = ["Warning: " + message];
+
+      if (error) {
+        args.push(error);
+      } // tslint:disable-next-line:no-console
+
+
+      console.warn.apply(console, args);
+    }
+  };
+}
+
 function isArray$4(value) {
   return Array.isArray(value);
 } // tslint:disable-next-line:ban-types
@@ -948,6 +969,16 @@ function isMachine(value) {
   }
 }
 
+var uniqueId =
+/*#__PURE__*/
+function () {
+  var currentId = 0;
+  return function () {
+    currentId++;
+    return currentId.toString(16);
+  };
+}();
+
 function toEventObject(event, payload // id?: TEvent['type']
 ) {
   if (isString$4(event) || typeof event === 'number') {
@@ -996,6 +1027,47 @@ function normalizeTarget(target) {
   }
 
   return toArray$1(target);
+}
+
+function reportUnhandledExceptionOnInvocation(originalError, currentError, id) {
+  if (!IS_PRODUCTION) {
+    var originalStackTrace = originalError.stack ? " Stacktrace was '" + originalError.stack + "'" : '';
+
+    if (originalError === currentError) {
+      // tslint:disable-next-line:no-console
+      console.error("Missing onError handler for invocation '" + id + "', error was '" + originalError + "'." + originalStackTrace);
+    } else {
+      var stackTrace = currentError.stack ? " Stacktrace was '" + currentError.stack + "'" : ''; // tslint:disable-next-line:no-console
+
+      console.error("Missing onError handler and/or unhandled exception/promise rejection for invocation '" + id + "'. " + ("Original error: '" + originalError + "'. " + originalStackTrace + " Current error is '" + currentError + "'." + stackTrace));
+    }
+  }
+}function mapState(stateMap, stateId) {
+  var e_1, _a;
+
+  var foundStateId;
+
+  try {
+    for (var _b = __values(keys(stateMap)), _c = _b.next(); !_c.done; _c = _b.next()) {
+      var mappedStateId = _c.value;
+
+      if (matchesState(mappedStateId, stateId) && (!foundStateId || stateId.length > foundStateId.length)) {
+        foundStateId = mappedStateId;
+      }
+    }
+  } catch (e_1_1) {
+    e_1 = {
+      error: e_1_1
+    };
+  } finally {
+    try {
+      if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+    } finally {
+      if (e_1) throw e_1.error;
+    }
+  }
+
+  return stateMap[foundStateId];
 }var ActionTypes$1;
 
 (function (ActionTypes) {
@@ -1031,10 +1103,10 @@ var raise$1 = ActionTypes$1.Raise;
 var send$1 = ActionTypes$1.Send;
 var cancel$1 = ActionTypes$1.Cancel;
 var nullEvent = ActionTypes$1.NullEvent;
-var assign = ActionTypes$1.Assign;
+var assign$1 = ActionTypes$1.Assign;
 ActionTypes$1.After;
 ActionTypes$1.DoneState;
-var log = ActionTypes$1.Log;
+var log$1 = ActionTypes$1.Log;
 var init = ActionTypes$1.Init;
 var invoke = ActionTypes$1.Invoke;
 ActionTypes$1.ErrorExecution;
@@ -1196,6 +1268,71 @@ function resolveSend(action, ctx, _event, delaysMap) {
     delay: resolvedDelay
   });
 }
+/**
+ * Sends an event to this machine's parent.
+ *
+ * @param event The event to send to the parent machine.
+ * @param options Options to pass into the send event.
+ */
+
+
+function sendParent(event, options) {
+  return send(event, __assign(__assign({}, options), {
+    to: SpecialTargets.Parent
+  }));
+}
+/**
+ * Sends an update event to this machine's parent.
+ */
+
+
+function sendUpdate() {
+  return sendParent(update);
+}
+/**
+ * Sends an event back to the sender of the original event.
+ *
+ * @param event The event to send back to the sender
+ * @param options Options to pass into the send event
+ */
+
+
+function respond(event, options) {
+  return send(event, __assign(__assign({}, options), {
+    to: function (_, __, _a) {
+      var _event = _a._event;
+      return _event.origin; // TODO: handle when _event.origin is undefined
+    }
+  }));
+}
+
+var defaultLogExpr = function (context, event) {
+  return {
+    context: context,
+    event: event
+  };
+};
+/**
+ *
+ * @param expr The expression function to evaluate which will be logged.
+ *  Takes in 2 arguments:
+ *  - `ctx` - the current state context
+ *  - `event` - the event that caused this action to be executed.
+ * @param label The label to give to the logged expression.
+ */
+
+
+function log(expr, label) {
+  if (expr === void 0) {
+    expr = defaultLogExpr;
+  }
+
+  return {
+    type: log$1,
+    label: label,
+    expr: expr
+  };
+}
 
 var resolveLog = function (action, ctx, _event) {
   return __assign(__assign({}, action), {
@@ -1249,6 +1386,19 @@ function stop(activity) {
     exec: undefined
   };
 }
+/**
+ * Updates the current context of the machine.
+ *
+ * @param assignment An object that represents the partial context to update.
+ */
+
+
+var assign = function (assignment) {
+  return {
+    type: assign$1,
+    assignment: assignment
+  };
+};
 /**
  * Returns an event type that represents an implicit event that
  * is sent after the specified `delay`.
@@ -1321,6 +1471,40 @@ function error(id, data) {
   };
 
   return eventObject;
+}
+/**
+ * Forwards (sends) an event to a specified service.
+ *
+ * @param target The target service to forward the event to.
+ * @param options Options to pass into the send action creator.
+ */
+
+
+function forwardTo(target, options) {
+  return send(function (_, event) {
+    return event;
+  }, __assign(__assign({}, options), {
+    to: target
+  }));
+}
+/**
+ * Escalates an error by sending it as an event to this machine's parent.
+ *
+ * @param errorData The error data to send, or the expression function that
+ * takes in the `context`, `event`, and `meta`, and returns the error data to send.
+ * @param options Options to pass into the send action creator.
+ */
+
+
+function escalate(errorData, options) {
+  return sendParent(function (context, event, meta) {
+    return {
+      type: error$1,
+      data: isFunction$4(errorData) ? errorData(context, event, meta) : errorData
+    };
+  }, __assign(__assign({}, options), {
+    to: SpecialTargets.Parent
+  }));
 }var isLeafNode = function (stateNode) {
   return stateNode.type === 'atomic' || stateNode.type === 'final';
 };
@@ -1791,7 +1975,7 @@ function () {
   };
 
   return State;
-}();function createNullActor(id) {
+}();function createNullActor$1(id) {
   return {
     id: id,
     send: function () {
@@ -1820,7 +2004,7 @@ function () {
 
 
 function createInvocableActor(invokeDefinition) {
-  var tempActor = createNullActor(invokeDefinition.id);
+  var tempActor = createNullActor$1(invokeDefinition.id);
   tempActor.meta = invokeDefinition;
   return tempActor;
 }
@@ -2701,7 +2885,7 @@ function () {
     }
 
     var _b = __read(partition$1(actions, function (action) {
-      return action.type === assign;
+      return action.type === assign$1;
     }), 2),
         assignActions = _b[0],
         otherActions = _b[1];
@@ -2723,7 +2907,7 @@ function () {
 
           return sendAction;
 
-        case log:
+        case log$1:
           return resolveLog(actionObject, updatedContext, _event);
 
         case pure:
@@ -3389,7 +3573,16 @@ function () {
   };
 
   return StateNode;
-}();function createMachine(config, options) {
+}();function Machine(config, options, initialContext) {
+  if (initialContext === void 0) {
+    initialContext = config.context;
+  }
+
+  var resolvedInitialContext = typeof initialContext === 'function' ? initialContext() : initialContext;
+  return new StateNode(config, options, resolvedInitialContext);
+}
+
+function createMachine(config, options) {
   var resolvedInitialContext = typeof config.context === 'function' ? config.context() : config.context;
   return new StateNode(config, options, resolvedInitialContext);
 }var defaultOptions = {
@@ -3484,7 +3677,27 @@ var registry = {
   free: function (id) {
     children.delete(id);
   }
-};var DEFAULT_SPAWN_OPTIONS = {
+};function getDevTools() {
+  var w = window;
+
+  if (!!w.__xstate__) {
+    return w.__xstate__;
+  }
+
+  return undefined;
+}
+
+function registerService(service) {
+  if (IS_PRODUCTION || typeof window === 'undefined') {
+    return;
+  }
+
+  var devTools = getDevTools();
+
+  if (devTools) {
+    devTools.register(service);
+  }
+}var DEFAULT_SPAWN_OPTIONS = {
   sync: false,
   autoForward: false
 };
@@ -3656,6 +3869,9 @@ function () {
   });
   Object.defineProperty(Interpreter.prototype, "state", {
     get: function () {
+      if (!IS_PRODUCTION) {
+        warn(this._status !== InterpreterStatus.NotStarted, "Attempted to read state from uninitialized service '" + this.id + "'. Make sure the service is started first.");
+      }
 
       return this._state;
     },
@@ -4059,7 +4275,12 @@ function () {
   Interpreter.prototype.batch = function (events) {
     var _this = this;
 
-    if (this._status === InterpreterStatus.NotStarted && this.options.deferEvents) ; else if (this._status !== InterpreterStatus.Running) {
+    if (this._status === InterpreterStatus.NotStarted && this.options.deferEvents) {
+      // tslint:disable-next-line:no-console
+      if (!IS_PRODUCTION) {
+        warn(false, events.length + " event(s) were sent to uninitialized service \"" + this.machine.id + "\" and are deferred. Make sure .start() is called for this service.\nEvent: " + JSON.stringify(event));
+      }
+    } else if (this._status !== InterpreterStatus.Running) {
       throw new Error( // tslint:disable-next-line:max-line-length
       events.length + " event(s) were sent to uninitialized service \"" + this.machine.id + "\". Make sure .start() is called for this service, or set { deferEvents: true } in the service options.");
     }
@@ -4251,9 +4472,18 @@ function () {
             var id = activity.id,
                 data = activity.data;
 
+            if (!IS_PRODUCTION) {
+              warn(!('forward' in activity), // tslint:disable-next-line:max-line-length
+              "`forward` property is deprecated (found in invocation of '" + activity.src + "' in in machine '" + this.machine.id + "'). " + "Please use `autoForward` instead.");
+            }
+
             var autoForward = 'autoForward' in activity ? activity.autoForward : !!activity.forward;
 
             if (!serviceCreator) {
+              // tslint:disable-next-line:no-console
+              if (!IS_PRODUCTION) {
+                warn(false, "No service found for invocation '" + activity.src + "' in machine '" + this.machine.id + "'.");
+              }
 
               return;
             }
@@ -4286,7 +4516,7 @@ function () {
           break;
         }
 
-      case log:
+      case log$1:
         var label = action.label,
             value = action.value;
 
@@ -4296,6 +4526,13 @@ function () {
           this.logger(value);
         }
 
+        break;
+
+      default:
+        if (!IS_PRODUCTION) {
+          warn(false, "No implementation found for action type '" + action.type + "'");
+        }
+
         break;
     }
 
@@ -4394,6 +4631,7 @@ function () {
             origin: id
           }));
         } catch (error) {
+          reportUnhandledExceptionOnInvocation(errorData, error, id);
 
           if (_this.devTools) {
             _this.devTools.send(errorEvent, _this.state);
@@ -4567,6 +4805,9 @@ function () {
     var implementation = this.machine.options && this.machine.options.activities ? this.machine.options.activities[activity.type] : undefined;
 
     if (!implementation) {
+      if (!IS_PRODUCTION) {
+        warn(false, "No implementation found for activity '" + activity.type + "'");
+      } // tslint:disable-next-line:no-console
 
 
       return;
@@ -4621,6 +4862,9 @@ function () {
         }), this.machine);
         this.devTools.init(this.state);
       } // add XState-specific dev tooling hook
+
+
+      registerService(this);
     }
   };
 
@@ -4663,6 +4907,57 @@ function () {
   Interpreter.interpret = interpret;
   return Interpreter;
 }();
+
+var createNullActor = function (name) {
+  if (name === void 0) {
+    name = 'null';
+  }
+
+  return {
+    id: name,
+    send: function () {
+      return void 0;
+    },
+    subscribe: function () {
+      // tslint:disable-next-line:no-empty
+      return {
+        unsubscribe: function () {}
+      };
+    },
+    toJSON: function () {
+      return {
+        id: name
+      };
+    }
+  };
+};
+
+var resolveSpawnOptions = function (nameOrOptions) {
+  if (isString$4(nameOrOptions)) {
+    return __assign(__assign({}, DEFAULT_SPAWN_OPTIONS), {
+      name: nameOrOptions
+    });
+  }
+
+  return __assign(__assign(__assign({}, DEFAULT_SPAWN_OPTIONS), {
+    name: uniqueId()
+  }), nameOrOptions);
+};
+
+function spawn(entity, nameOrOptions) {
+  var resolvedOptions = resolveSpawnOptions(nameOrOptions);
+  return withServiceScope(undefined, function (service) {
+    if (!IS_PRODUCTION) {
+      warn(!!service, "Attempted to spawn an Actor (ID: \"" + (isMachine(entity) ? entity.id : 'undefined') + "\") outside of a service. This will have no effect.");
+    }
+
+    if (service) {
+      return service.spawn(entity, resolvedOptions.name, resolvedOptions);
+    } else {
+      return createNullActor(resolvedOptions.name);
+    }
+  });
+}
 /**
  * Creates a new Interpreter instance for the given machine with the provided options, if any.
  *
@@ -4674,7 +4969,50 @@ function () {
 function interpret(machine, options) {
   var interpreter = new Interpreter(machine, options);
   return interpreter;
-}// threejs.org/license
+}function matchState(state, patterns, defaultValue) {
+  var e_1, _a;
+
+  var resolvedState = State.from(state, state instanceof State ? state.context : undefined);
+
+  try {
+    for (var patterns_1 = __values(patterns), patterns_1_1 = patterns_1.next(); !patterns_1_1.done; patterns_1_1 = patterns_1.next()) {
+      var _b = __read(patterns_1_1.value, 2),
+          stateValue = _b[0],
+          getValue = _b[1];
+
+      if (resolvedState.matches(stateValue)) {
+        return getValue(resolvedState);
+      }
+    }
+  } catch (e_1_1) {
+    e_1 = {
+      error: e_1_1
+    };
+  } finally {
+    try {
+      if (patterns_1_1 && !patterns_1_1.done && (_a = patterns_1.return)) _a.call(patterns_1);
+    } finally {
+      if (e_1) throw e_1.error;
+    }
+  }
+
+  return defaultValue(resolvedState);
+}var actions = {
+  raise: raise,
+  send: send,
+  sendParent: sendParent,
+  sendUpdate: sendUpdate,
+  log: log,
+  cancel: cancel,
+  start: start,
+  stop: stop,
+  assign: assign,
+  after: after,
+  done: done,
+  respond: respond,
+  forwardTo: forwardTo,
+  escalate: escalate
+};var index$3=/*#__PURE__*/Object.freeze({__proto__:null,actions:actions,matchesState:matchesState,mapState:mapState,get ActionTypes(){return ActionTypes$1},get SpecialTargets(){return SpecialTargets},assign:assign,doneInvoke:doneInvoke,forwardTo:forwardTo,send:send,sendParent:sendParent,sendUpdate:sendUpdate,State:State,StateNode:StateNode,Machine:Machine,createMachine:createMachine,Interpreter:Interpreter,interpret:interpret,spawn:spawn,matchState:matchState});// threejs.org/license
 const REVISION = '126';
 const MOUSE = { LEFT: 0, MIDDLE: 1, RIGHT: 2, ROTATE: 0, DOLLY: 1, PAN: 2 };
 const TOUCH = { ROTATE: 0, PAN: 1, DOLLY_PAN: 2, DOLLY_ROTATE: 3 };
@@ -57413,7 +57751,7 @@ function applyMiddleware() {
 
 var thunk = createThunkMiddleware();
 thunk.withExtraArgument = createThunkMiddleware;var name = "mage-engine";
-var version$1 = "3.21.0";
+var version$1 = "3.21.2";
 var description = "A WebGL Javascript Game Engine, built on top of THREE.js and many other libraries.";
 var main = "dist/mage.js";
 var author$1 = {
@@ -59703,7 +60041,7 @@ var tweenTo = function tweenTo(origin, target) {
     var _options$serializable = _options.serializable,
         serializable = _options$serializable === void 0 ? true : _options$serializable,
         _options$tag = _options.tag,
-        tag = _options$tag === void 0 ? '' : _options$tag,
+        tag = _options$tag === void 0 ? "" : _options$tag,
         _options$tags = _options.tags,
         tags = _options$tags === void 0 ? [] : _options$tags;
     _this = _super.call(this);
@@ -59952,7 +60290,7 @@ var tweenTo = function tweenTo(origin, target) {
           var index = this.children.findIndex(function (m) {
             return m.equals(element);
           });
-          if (index) this.children.splice(index, 1);
+          if (index !== -1) this.children.splice(index, 1);
         } else {
           this.body.remove(element.getBody());
         }
@@ -60118,6 +60456,7 @@ var tweenTo = function tweenTo(origin, target) {
         type: ENTITY_EVENTS.DISPOSE
       });
       this.reset();
+      this.disposed = true;
     }
   }, {
     key: "addStateMachine",
@@ -60216,6 +60555,21 @@ var tweenTo = function tweenTo(origin, target) {
 
       return script;
     }
+  }, {
+    key: "removeScript",
+    value: function removeScript(name) {
+      var index = this.scripts.findIndex(function (script) {
+        return script.name === name;
+      });
+      var script = this.scripts[index].script;
+
+      if (script) {
+        script.onDispose();
+        this.scripts.splice(index, 1);
+      } else {
+        console.log(SCRIPT_NOT_FOUND);
+      }
+    }
   }, {
     key: "enableScripts",
     value: function enableScripts() {
@@ -60317,7 +60671,7 @@ var tweenTo = function tweenTo(origin, target) {
     value: function getWorldTransform() {
       var position = this.getBody().getWorldPosition(new Vector3$1());
       var quaternion = this.getBody().getWorldQuaternion(new Quaternion(0, 0, 0, 1));
-      var rotation = new Euler(0, 0, 0, 'XYZ').setFromQuaternion(quaternion, 'XYZ');
+      var rotation = new Euler(0, 0, 0, "XYZ").setFromQuaternion(quaternion, "XYZ");
       return {
         position: position,
         rotation: rotation,
@@ -92743,4 +93097,4 @@ var Shaders$1 = new Shaders();var Shader = function Shader(name, attributes, uni
   } else {
     this.instance = this.shader.instance;
   }
-};var constants = _objectSpread2$1(_objectSpread2$1({}, lib_constants), light_contants);export{AUDIO_RAMPS,AmbientLight,AmbientSound,Atmosphere,Audio$1 as Audio,Axes,BUILTIN,BaseScript,Box,Camera,Color,Cone,Config$1 as Config,Controls$1 as Controls,Cube,CurveLine,Cylinder,DirectionalSound,ENTITY_EVENTS,ENTITY_TYPES,Element$1 as Element,Entity,EventDispatcher,FEATURES,Features$1 as Features,GameRunner$1 as GameRunner,Grid,HemisphereLight,INPUT_EVENTS,Images$1 as Images,Input$1 as Input,Label,LabelComponent,Level,LightLoader$1 as LightLoader,Lights$1 as Lights,Line,MeshLoader$1 as MeshLoader,Mirror,Models$1 as Models,Ocean,PALETTES,PARTICLES,constants$1 as PHYSICS_CONSTANTS,PHYSICS_EVENTS,ParticleEmitter,ParticleEmitterGroup,Particles$1 as Particles,index$1 as Partykals,Physics$1 as Physics,Plane,PointLight,PostProcessing$1 as PostProcessing,Proton,ProtonParticleEmitter,Provider,Router$1 as Router,Scene$1 as Scene,Scripts$1 as Scripts,Shader,Sky,Skybox,Sound,Sphere,SpotLight,Sprite,Stats$1 as Stats,SunLight,three_module as THREE,Universe$1 as Universe,Vector3$1 as Vector3,Water,author,connect,constants,createElement,easing,functions,hitbox as hitboxUtils,index_esm as inferno,math,utils as physicsUtils,index$2 as rxjs,index as store,strings,uuid$1 as uuid,workers};
+};var constants = _objectSpread2$1(_objectSpread2$1({}, lib_constants), light_contants);export{AUDIO_RAMPS,AmbientLight,AmbientSound,Atmosphere,Audio$1 as Audio,Axes,BUILTIN,BaseScript,Box,Camera,Color,Cone,Config$1 as Config,Controls$1 as Controls,Cube,CurveLine,Cylinder,DirectionalSound,ENTITY_EVENTS,ENTITY_TYPES,Element$1 as Element,Entity,EventDispatcher,FEATURES,Features$1 as Features,GameRunner$1 as GameRunner,Grid,HemisphereLight,INPUT_EVENTS,Images$1 as Images,Input$1 as Input,Label,LabelComponent,Level,LightLoader$1 as LightLoader,Lights$1 as Lights,Line,MeshLoader$1 as MeshLoader,Mirror,Models$1 as Models,Ocean,PALETTES,PARTICLES,constants$1 as PHYSICS_CONSTANTS,PHYSICS_EVENTS,ParticleEmitter,ParticleEmitterGroup,Particles$1 as Particles,index$1 as Partykals,Physics$1 as Physics,Plane,PointLight,PostProcessing$1 as PostProcessing,Proton,ProtonParticleEmitter,Provider,Router$1 as Router,Scene$1 as Scene,Scripts$1 as Scripts,Shader,Sky,Skybox,Sound,Sphere,SpotLight,Sprite,Stats$1 as Stats,SunLight,three_module as THREE,Universe$1 as Universe,Vector3$1 as Vector3,Water,author,connect,constants,createElement,easing,functions,hitbox as hitboxUtils,index_esm as inferno,math,utils as physicsUtils,index$2 as rxjs,index as store,strings,uuid$1 as uuid,workers,index$3 as xstate};

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mage-engine",
-    "version": "3.21.0",
+    "version": "3.21.2",
     "description": "A WebGL Javascript Game Engine, built on top of THREE.js and many other libraries.",
     "main": "dist/mage.js",
     "author": {

package/prettier.config.js

@@ -1,7 +0,0 @@
-module.exports = {
-  trailingComma: "es5",
-  tabWidth: 4,
-  semi: true,
-  singleQuote: true,
-  organizeImportsSkipDestructiveCodeActions: true,
-};