@m2c2kit/core 0.3.19 → 0.3.21

package/dist/index.js

@@ -499,32 +499,534 @@ const _Timer = class _Timer {
 _Timer._timers = new Array();
 let Timer = _Timer;
 
+class WebColors {
+}
+WebColors.Transparent = [0, 0, 0, 0];
+WebColors.MediumVioletRed = [199, 21, 133, 1];
+WebColors.DeepPink = [255, 20, 147, 1];
+WebColors.PaleVioletRed = [219, 112, 147, 1];
+WebColors.HotPink = [255, 105, 180, 1];
+WebColors.LightPink = [255, 182, 193, 1];
+WebColors.Pink = [255, 192, 203, 1];
+WebColors.DarkRed = [139, 0, 0, 1];
+WebColors.Red = [255, 0, 0, 1];
+WebColors.Firebrick = [178, 34, 34, 1];
+WebColors.Crimson = [220, 20, 60, 1];
+WebColors.IndianRed = [205, 92, 92, 1];
+WebColors.LightCoral = [240, 128, 128, 1];
+WebColors.Salmon = [250, 128, 114, 1];
+WebColors.DarkSalmon = [233, 150, 122, 1];
+WebColors.LightSalmon = [255, 160, 122, 1];
+WebColors.OrangeRed = [255, 69, 0, 1];
+WebColors.Tomato = [255, 99, 71, 1];
+WebColors.DarkOrange = [255, 140, 0, 1];
+WebColors.Coral = [255, 127, 80, 1];
+WebColors.Orange = [255, 165, 0, 1];
+WebColors.DarkKhaki = [189, 183, 107, 1];
+WebColors.Gold = [255, 215, 0, 1];
+WebColors.Khaki = [240, 230, 140, 1];
+WebColors.PeachPuff = [255, 218, 185, 1];
+WebColors.Yellow = [255, 255, 0, 1];
+WebColors.PaleGoldenrod = [238, 232, 170, 1];
+WebColors.Moccasin = [255, 228, 181, 1];
+WebColors.PapayaWhip = [255, 239, 213, 1];
+WebColors.LightGoldenrodYellow = [250, 250, 210, 1];
+WebColors.LemonChiffon = [255, 250, 205, 1];
+WebColors.LightYellow = [255, 255, 224, 1];
+WebColors.Maroon = [128, 0, 0, 1];
+WebColors.Brown = [165, 42, 42, 1];
+WebColors.SaddleBrown = [139, 69, 19, 1];
+WebColors.Sienna = [160, 82, 45, 1];
+WebColors.Chocolate = [210, 105, 30, 1];
+WebColors.DarkGoldenrod = [184, 134, 11, 1];
+WebColors.Peru = [205, 133, 63, 1];
+WebColors.RosyBrown = [188, 143, 143, 1];
+WebColors.Goldenrod = [218, 165, 32, 1];
+WebColors.SandyBrown = [244, 164, 96, 1];
+WebColors.Tan = [210, 180, 140, 1];
+WebColors.Burlywood = [222, 184, 135, 1];
+WebColors.Wheat = [245, 222, 179, 1];
+WebColors.NavajoWhite = [255, 222, 173, 1];
+WebColors.Bisque = [255, 228, 196, 1];
+WebColors.BlanchedAlmond = [255, 235, 205, 1];
+WebColors.Cornsilk = [255, 248, 220, 1];
+WebColors.DarkGreen = [0, 100, 0, 1];
+WebColors.Green = [0, 128, 0, 1];
+WebColors.DarkOliveGreen = [85, 107, 47, 1];
+WebColors.ForestGreen = [34, 139, 34, 1];
+WebColors.SeaGreen = [46, 139, 87, 1];
+WebColors.Olive = [128, 128, 0, 1];
+WebColors.OliveDrab = [107, 142, 35, 1];
+WebColors.MediumSeaGreen = [60, 179, 113, 1];
+WebColors.LimeGreen = [50, 205, 50, 1];
+WebColors.Lime = [0, 255, 0, 1];
+WebColors.SpringGreen = [0, 255, 127, 1];
+WebColors.MediumSpringGreen = [0, 250, 154, 1];
+WebColors.DarkSeaGreen = [143, 188, 143, 1];
+WebColors.MediumAquamarine = [102, 205, 170, 1];
+WebColors.YellowGreen = [154, 205, 50, 1];
+WebColors.LawnGreen = [124, 252, 0, 1];
+WebColors.Chartreuse = [127, 255, 0, 1];
+WebColors.LightGreen = [144, 238, 144, 1];
+WebColors.GreenYellow = [173, 255, 47, 1];
+WebColors.PaleGreen = [152, 251, 152, 1];
+WebColors.Teal = [0, 128, 128, 1];
+WebColors.DarkCyan = [0, 139, 139, 1];
+WebColors.LightSeaGreen = [32, 178, 170, 1];
+WebColors.CadetBlue = [95, 158, 160, 1];
+WebColors.DarkTurquoise = [0, 206, 209, 1];
+WebColors.MediumTurquoise = [72, 209, 204, 1];
+WebColors.Turquoise = [64, 224, 208, 1];
+WebColors.Aqua = [0, 255, 255, 1];
+WebColors.Cyan = [0, 255, 255, 1];
+WebColors.Aquamarine = [127, 255, 212, 1];
+WebColors.PaleTurquoise = [175, 238, 238, 1];
+WebColors.LightCyan = [224, 255, 255, 1];
+WebColors.Navy = [0, 0, 128, 1];
+WebColors.DarkBlue = [0, 0, 139, 1];
+WebColors.MediumBlue = [0, 0, 205, 1];
+WebColors.Blue = [0, 0, 255, 1];
+WebColors.MidnightBlue = [25, 25, 112, 1];
+WebColors.RoyalBlue = [65, 105, 225, 1];
+WebColors.SteelBlue = [70, 130, 180, 1];
+WebColors.DodgerBlue = [30, 144, 255, 1];
+WebColors.DeepSkyBlue = [0, 191, 255, 1];
+WebColors.CornflowerBlue = [100, 149, 237, 1];
+WebColors.SkyBlue = [135, 206, 235, 1];
+WebColors.LightSkyBlue = [135, 206, 250, 1];
+WebColors.LightSteelBlue = [176, 196, 222, 1];
+WebColors.LightBlue = [173, 216, 230, 1];
+WebColors.PowderBlue = [176, 224, 230, 1];
+WebColors.Indigo = [75, 0, 130, 1];
+WebColors.Purple = [128, 0, 128, 1];
+WebColors.DarkMagenta = [139, 0, 139, 1];
+WebColors.DarkViolet = [148, 0, 211, 1];
+WebColors.DarkSlateBlue = [72, 61, 139, 1];
+WebColors.BlueViolet = [138, 43, 226, 1];
+WebColors.DarkOrchid = [153, 50, 204, 1];
+WebColors.Fuchsia = [255, 0, 255, 1];
+WebColors.Magenta = [255, 0, 255, 1];
+WebColors.SlateBlue = [106, 90, 205, 1];
+WebColors.MediumSlateBlue = [123, 104, 238, 1];
+WebColors.MediumOrchid = [186, 85, 211, 1];
+WebColors.MediumPurple = [147, 112, 219, 1];
+WebColors.Orchid = [218, 112, 214, 1];
+WebColors.Violet = [238, 130, 238, 1];
+WebColors.Plum = [221, 160, 221, 1];
+WebColors.Thistle = [216, 191, 216, 1];
+WebColors.Lavender = [230, 230, 250, 1];
+WebColors.MistyRose = [255, 228, 225, 1];
+WebColors.AntiqueWhite = [250, 235, 215, 1];
+WebColors.Linen = [250, 240, 230, 1];
+WebColors.Beige = [245, 245, 220, 1];
+WebColors.WhiteSmoke = [245, 245, 245, 1];
+WebColors.LavenderBlush = [255, 240, 245, 1];
+WebColors.OldLace = [253, 245, 230, 1];
+WebColors.AliceBlue = [240, 248, 255, 1];
+WebColors.Seashell = [255, 245, 238, 1];
+WebColors.GhostWhite = [248, 248, 255, 1];
+WebColors.Honeydew = [240, 255, 240, 1];
+WebColors.FloralWhite = [255, 250, 240, 1];
+WebColors.Azure = [240, 255, 255, 1];
+WebColors.MintCream = [245, 255, 250, 1];
+WebColors.Snow = [255, 250, 250, 1];
+WebColors.Ivory = [255, 255, 240, 1];
+WebColors.White = [255, 255, 255, 1];
+WebColors.Black = [0, 0, 0, 1];
+WebColors.DarkSlateGray = [47, 79, 79, 1];
+WebColors.DimGray = [105, 105, 105, 1];
+WebColors.SlateGray = [112, 128, 144, 1];
+WebColors.Gray = [128, 128, 128, 1];
+WebColors.LightSlateGray = [119, 136, 153, 1];
+WebColors.DarkGray = [169, 169, 169, 1];
+WebColors.Silver = [192, 192, 192, 1];
+WebColors.LightGray = [211, 211, 211, 1];
+WebColors.Gainsboro = [220, 220, 220, 1];
+WebColors.RebeccaPurple = [102, 51, 153, 1];
+
+class Constants {
+}
+/** Size of the font showing frames per second */
+Constants.FPS_DISPLAY_TEXT_FONT_SIZE = 12;
+/** Color of the font showing frames per second */
+Constants.FPS_DISPLAY_TEXT_COLOR = [0, 0, 0, 0.5];
+/** Frequency, in milliseconds, at which to update frames per second metric shown on the screen */
+Constants.FPS_DISPLAY_UPDATE_INTERVAL = 1e3;
+/** Maximum number of activity metrics to log. */
+Constants.MAXIMUM_RECORDED_ACTIVITY_METRICS = 32;
+/** The frames per second will be logged in game metrics if the FPS is lower than this value */
+Constants.FPS_METRIC_REPORT_THRESHOLD = 59;
+/** Scene color, if none is specified. */
+Constants.DEFAULT_SCENE_BACKGROUND_COLOR = WebColors.White;
+/** Shape fill color, if none is specified. */
+Constants.DEFAULT_SHAPE_FILL_COLOR = WebColors.Red;
+/** Color of paths in a shape, if none is specified. */
+Constants.DEFAULT_PATH_STROKE_COLOR = WebColors.Red;
+/** Line width of paths in a shape, if none is specified. */
+Constants.DEFAULT_PATH_LINE_WIDTH = 2;
+/** Color of text in Label and TextLine, if none is specified. */
+Constants.DEFAULT_FONT_COLOR = WebColors.Black;
+/** Font size in Label and TextLine, if none is specified. */
+Constants.DEFAULT_FONT_SIZE = 16;
+Constants.LIMITED_FPS_RATE = 5;
+Constants.FREE_NODES_SCENE_NAME = "__freeNodesScene";
+Constants.OUTGOING_SCENE_NAME = "__outgoingScene";
+Constants.OUTGOING_SCENE_SPRITE_NAME = "__outgoingSceneSprite";
+Constants.OUTGOING_SCENE_IMAGE_NAME = "__outgoingSceneSnapshot";
+Constants.SESSION_INITIALIZATION_POLLING_INTERVAL_MS = 50;
+/** Placeholder that will be populated during the build process. */
+Constants.MODULE_METADATA_PLACEHOLDER = {
+  name: "",
+  version: "",
+  dependencies: {}
+};
+Constants.DEFAULT_ROOT_ELEMENT_ID = "m2c2kit";
+Constants.ERUDA_URL = "https://cdn.jsdelivr.net/npm/eruda@3.2.3/eruda.js";
+Constants.ERUDA_SRI = "sha384-KlRzgy/c+nZSV+eiFqoTkkbZ5pUqToho7HsNuebTbOsYTh4m0m/PAqkGsTMLXK14";
+
 class M2c2KitHelpers {
   /**
-   * Returns the URL as it appears in the game's manifest.json file.
+   * Returns the URL as it appears in the game's manifest.json file.
+   *
+   * @remarks This is used to return the hashed URL.
+   *
+   * @param game - game object
+   * @param url - the URL
+   * @returns the hashed URL from the manifest, or the original URL if there is no manifest or the URL is not in the manifest.
+   */
+  static getUrlFromManifest(game, url) {
+    const manifest = game.manifest;
+    if (manifest && manifest[url]) {
+      return manifest[url];
+    }
+    return url;
+  }
+  /**
+   * Does the URL have a scheme?
+   *
+   * @param url - the URL to test
+   * @returns true if the url begins with a scheme (e.g., "http://",
+   * "https://", "file://", etc.)
+   */
+  static urlHasScheme(url) {
+    return /^[a-z]+:\/\//i.test(url);
+  }
+  /**
+   * Converts a value to a JSON schema type or one of types.
+   *
+   * @remarks The value can be of the target type, or a string that can be
+   * parsed into the target type. For example, a string `"3"` can be converted
+   * to a number, and a string `'{ "color" : "red" }'` can be converted to an
+   * object. If the target type if an object or array, the value can be a
+   * string parsable into the target type: this string can be the string
+   * representation of the object or array, or the URI encoded string.
+   * Throws an error if the value cannot be converted to the type or one of the
+   * types. Converting an object, null, or array to a string is often not the
+   * desired behavior, so a warning is logged if this occurs.
+   *
+   * @param value - the value to convert
+   * @param type - A JSON Schema type or types to convert the value to, e.g.,
+   * "string" or ["string", "null"]
+   * @returns the converted value
+   */
+  static convertValueToType(value, type) {
+    function canBeString(value2) {
+      if (typeof value2 === "string") {
+        return true;
+      }
+      if (typeof value2 === "object") {
+        return true;
+      }
+      if (!Number.isNaN(parseFloat(value2))) {
+        return true;
+      }
+      if (typeof value2 === "boolean") {
+        return true;
+      }
+      return false;
+    }
+    function asString(value2) {
+      if (typeof value2 === "string") {
+        return value2;
+      }
+      if (typeof value2 === "object") {
+        console.warn(
+          `convertValueToType() converted an object to a string. This may not be the desired behavior. The object was: ${JSON.stringify(value2)}`
+        );
+        return JSON.stringify(value2);
+      }
+      if (!Number.isNaN(parseFloat(value2))) {
+        return value2;
+      }
+      if (typeof value2 === "boolean") {
+        return value2.toString();
+      }
+      throw new Error(`Error parsing "${value2}" as a string.`);
+    }
+    function canBeNumber(value2) {
+      if (typeof value2 === "number") {
+        return true;
+      }
+      if (typeof value2 !== "string") {
+        return false;
+      }
+      const n = parseFloat(value2);
+      if (Number.isNaN(n)) {
+        return false;
+      }
+      return true;
+    }
+    function asNumber(value2) {
+      if (typeof value2 === "number") {
+        return value2;
+      }
+      if (typeof value2 !== "string") {
+        throw new Error(`Error parsing "${value2}" as a number.`);
+      }
+      const n = parseFloat(value2);
+      if (Number.isNaN(n)) {
+        throw new Error(`Error parsing "${value2}" as a number.`);
+      }
+      return n;
+    }
+    function canBeInteger(value2) {
+      if (typeof value2 === "number") {
+        return true;
+      }
+      if (typeof value2 !== "string") {
+        return false;
+      }
+      const n = parseInt(value2);
+      if (Number.isNaN(n)) {
+        return false;
+      }
+      return true;
+    }
+    function asInteger(value2) {
+      if (typeof value2 === "number") {
+        return value2;
+      }
+      if (typeof value2 !== "string") {
+        throw new Error(`Error parsing "${value2}" as an integer.`);
+      }
+      const n = parseInt(value2);
+      if (Number.isNaN(n)) {
+        throw new Error(`Error parsing "${value2}" as an integer.`);
+      }
+      return n;
+    }
+    function canBeBoolean(value2) {
+      if (typeof value2 === "boolean") {
+        return true;
+      }
+      if (value2 !== "true" && value2 !== "false") {
+        return false;
+      }
+      return true;
+    }
+    function asBoolean(value2) {
+      if (typeof value2 === "boolean") {
+        return value2;
+      }
+      if (value2 !== "true" && value2 !== "false") {
+        throw new Error(`Error parsing "${value2}" as a boolean.`);
+      }
+      return value2 === "true";
+    }
+    function canBeArray(value2) {
+      if (Array.isArray(value2)) {
+        return true;
+      }
+      if (typeof value2 !== "string") {
+        return false;
+      }
+      try {
+        const a = JSON.parse(value2);
+        if (Array.isArray(a)) {
+          return true;
+        }
+      } catch {
+        const a = JSON.parse(decodeURIComponent(value2));
+        if (Array.isArray(a)) {
+          return true;
+        }
+      }
+      return false;
+    }
+    function asArray(value2) {
+      if (Array.isArray(value2)) {
+        return value2;
+      }
+      if (typeof value2 !== "string") {
+        throw new Error(`Error parsing "${value2}" as an array.`);
+      }
+      try {
+        const a = JSON.parse(value2);
+        if (Array.isArray(a)) {
+          return a;
+        }
+      } catch {
+        const a = JSON.parse(decodeURIComponent(value2));
+        if (Array.isArray(a)) {
+          return a;
+        }
+      }
+      throw new Error(`Error parsing "${value2}" as an array.`);
+    }
+    function canBeObject(value2) {
+      if (typeof value2 === "object" && !Array.isArray(value2) && value2 !== null) {
+        return true;
+      }
+      if (typeof value2 !== "string") {
+        return false;
+      }
+      try {
+        const o = JSON.parse(value2);
+        if (typeof o === "object" && !Array.isArray(o) && o !== null) {
+          return true;
+        }
+      } catch {
+        const o = JSON.parse(decodeURIComponent(value2));
+        if (typeof o === "object" && !Array.isArray(o) && o !== null) {
+          return true;
+        }
+      }
+      return false;
+    }
+    function asObject(value2) {
+      if (typeof value2 === "object" && !Array.isArray(value2) && value2 !== null) {
+        return value2;
+      }
+      if (typeof value2 !== "string") {
+        throw new Error(`Error parsing "${value2}" as an object.`);
+      }
+      try {
+        const o = JSON.parse(value2);
+        if (typeof o === "object" && !Array.isArray(o) && o !== null) {
+          return o;
+        }
+      } catch {
+        const o = JSON.parse(decodeURIComponent(value2));
+        if (typeof o === "object" && !Array.isArray(o) && o !== null) {
+          return o;
+        }
+      }
+      throw new Error(`Error parsing "${value2}" as an object.`);
+    }
+    function canBeNull(value2) {
+      if (value2 === null || value2 === "null") {
+        return true;
+      }
+      return false;
+    }
+    function asNull(value2) {
+      if (value2 !== "null" && value2 !== null) {
+        throw new Error(`Error parsing "${value2}" as null.`);
+      }
+      return null;
+    }
+    const typeCheckers = {
+      string: canBeString,
+      number: canBeNumber,
+      integer: canBeInteger,
+      boolean: canBeBoolean,
+      array: canBeArray,
+      object: canBeObject,
+      null: canBeNull
+    };
+    const typeConverters = {
+      string: asString,
+      number: asNumber,
+      integer: asInteger,
+      boolean: asBoolean,
+      array: asArray,
+      object: asObject,
+      null: asNull
+    };
+    if (type === void 0) {
+      throw new Error(`Error with "${value}" as a target type.`);
+    }
+    if (!Array.isArray(type)) {
+      if (typeCheckers[type](value)) {
+        return typeConverters[type](value);
+      }
+      throw new Error(`Error parsing "${value}" as a ${type}.`);
+    }
+    for (const t of type) {
+      if (typeCheckers[t](value)) {
+        return typeConverters[t](value);
+      }
+    }
+    throw new Error(`Error parsing "${value}" as one of ${type}.`);
+  }
+  /**
+   * Load scripts from URLs.
    *
-   * @remarks This is used to return the hashed URL.
+   * @remarks This is for debugging purposes only. If this is unwanted, it
+   * can be disabled on the server side with an appropriate Content
+   * Security Policy (CSP) header.
    *
-   * @param game - game object
-   * @param url - the URL
-   * @returns the hashed URL from the manifest, or the original URL if there is no manifest or the URL is not in the manifest.
+   * @param urls - URLs with scripts to load
    */
-  static getUrlFromManifest(game, url) {
-    const manifest = game.manifest;
-    if (manifest && manifest[url]) {
-      return manifest[url];
+  static loadScriptUrls(urls) {
+    if (!Array.isArray(urls) || !urls.every((s) => typeof s === "string")) {
+      console.warn(
+        `Error parsing "scripts" parameter. "scripts" must be an array of URL strings, and it is recommended to be URI encoded.`
+      );
+      return;
     }
-    return url;
+    urls.forEach((url) => {
+      if (!m2c2Globals.addedScriptUrls.includes(url)) {
+        const script = document.createElement("script");
+        script.src = url;
+        script.async = true;
+        document.head.appendChild(script);
+        console.log(`\u26AA added script: ${url}`);
+        m2c2Globals.addedScriptUrls.push(url);
+      }
+    });
   }
   /**
-   * Does the URL have a scheme?
+   * Loads eruda from a CDN and initializes it.
    *
-   * @param url - the URL to test
-   * @returns true if the url begins with a scheme (e.g., "http://",
-   * "https://", "file://", etc.)
+   * @remarks This is for debugging purposes only. If this is unwanted, it
+   * can be disabled on the server side with an appropriate Content
+   * Security Policy (CSP) header.
+   * eruda is a dev console overlay for mobile web browsers and web views.
+   * see https://github.com/liriliri/eruda
+   *
+   * @param pollingIntervalMs - milliseconds between each attempt
+   * @param maxAttempts - how many attempts to make
    */
-  static urlHasScheme(url) {
-    return /^[a-z]+:\/\//i.test(url);
+  static loadEruda(pollingIntervalMs = 100, maxAttempts = 50) {
+    if (m2c2Globals.erudaRequested === true) {
+      return;
+    }
+    console.log(`\u26AA added eruda script: ${Constants.ERUDA_URL}`);
+    const script = document.createElement("script");
+    script.src = Constants.ERUDA_URL;
+    script.integrity = Constants.ERUDA_SRI;
+    script.crossOrigin = "anonymous";
+    script.async = true;
+    document.head.appendChild(script);
+    m2c2Globals.erudaRequested = true;
+    let attempts = 0;
+    const waitForEruda = () => {
+      const eruda = window?.eruda;
+      if (typeof eruda !== "undefined") {
+        console.log("\u26AA eruda ready");
+        eruda.init();
+        m2c2Globals.erudaInitialized = true;
+      } else if (attempts < maxAttempts) {
+        attempts++;
+        setTimeout(waitForEruda, pollingIntervalMs);
+      } else {
+        console.log(
+          `eruda was requested, but could not be loaded after ${pollingIntervalMs * maxAttempts} milliseconds.`
+        );
+      }
+    };
+    waitForEruda();
   }
   /**
    * Registers a `M2Node` class with the global class registry.
@@ -2026,189 +2528,6 @@ class MutablePath {
   }
 }
 
-class WebColors {
-}
-WebColors.Transparent = [0, 0, 0, 0];
-WebColors.MediumVioletRed = [199, 21, 133, 1];
-WebColors.DeepPink = [255, 20, 147, 1];
-WebColors.PaleVioletRed = [219, 112, 147, 1];
-WebColors.HotPink = [255, 105, 180, 1];
-WebColors.LightPink = [255, 182, 193, 1];
-WebColors.Pink = [255, 192, 203, 1];
-WebColors.DarkRed = [139, 0, 0, 1];
-WebColors.Red = [255, 0, 0, 1];
-WebColors.Firebrick = [178, 34, 34, 1];
-WebColors.Crimson = [220, 20, 60, 1];
-WebColors.IndianRed = [205, 92, 92, 1];
-WebColors.LightCoral = [240, 128, 128, 1];
-WebColors.Salmon = [250, 128, 114, 1];
-WebColors.DarkSalmon = [233, 150, 122, 1];
-WebColors.LightSalmon = [255, 160, 122, 1];
-WebColors.OrangeRed = [255, 69, 0, 1];
-WebColors.Tomato = [255, 99, 71, 1];
-WebColors.DarkOrange = [255, 140, 0, 1];
-WebColors.Coral = [255, 127, 80, 1];
-WebColors.Orange = [255, 165, 0, 1];
-WebColors.DarkKhaki = [189, 183, 107, 1];
-WebColors.Gold = [255, 215, 0, 1];
-WebColors.Khaki = [240, 230, 140, 1];
-WebColors.PeachPuff = [255, 218, 185, 1];
-WebColors.Yellow = [255, 255, 0, 1];
-WebColors.PaleGoldenrod = [238, 232, 170, 1];
-WebColors.Moccasin = [255, 228, 181, 1];
-WebColors.PapayaWhip = [255, 239, 213, 1];
-WebColors.LightGoldenrodYellow = [250, 250, 210, 1];
-WebColors.LemonChiffon = [255, 250, 205, 1];
-WebColors.LightYellow = [255, 255, 224, 1];
-WebColors.Maroon = [128, 0, 0, 1];
-WebColors.Brown = [165, 42, 42, 1];
-WebColors.SaddleBrown = [139, 69, 19, 1];
-WebColors.Sienna = [160, 82, 45, 1];
-WebColors.Chocolate = [210, 105, 30, 1];
-WebColors.DarkGoldenrod = [184, 134, 11, 1];
-WebColors.Peru = [205, 133, 63, 1];
-WebColors.RosyBrown = [188, 143, 143, 1];
-WebColors.Goldenrod = [218, 165, 32, 1];
-WebColors.SandyBrown = [244, 164, 96, 1];
-WebColors.Tan = [210, 180, 140, 1];
-WebColors.Burlywood = [222, 184, 135, 1];
-WebColors.Wheat = [245, 222, 179, 1];
-WebColors.NavajoWhite = [255, 222, 173, 1];
-WebColors.Bisque = [255, 228, 196, 1];
-WebColors.BlanchedAlmond = [255, 235, 205, 1];
-WebColors.Cornsilk = [255, 248, 220, 1];
-WebColors.DarkGreen = [0, 100, 0, 1];
-WebColors.Green = [0, 128, 0, 1];
-WebColors.DarkOliveGreen = [85, 107, 47, 1];
-WebColors.ForestGreen = [34, 139, 34, 1];
-WebColors.SeaGreen = [46, 139, 87, 1];
-WebColors.Olive = [128, 128, 0, 1];
-WebColors.OliveDrab = [107, 142, 35, 1];
-WebColors.MediumSeaGreen = [60, 179, 113, 1];
-WebColors.LimeGreen = [50, 205, 50, 1];
-WebColors.Lime = [0, 255, 0, 1];
-WebColors.SpringGreen = [0, 255, 127, 1];
-WebColors.MediumSpringGreen = [0, 250, 154, 1];
-WebColors.DarkSeaGreen = [143, 188, 143, 1];
-WebColors.MediumAquamarine = [102, 205, 170, 1];
-WebColors.YellowGreen = [154, 205, 50, 1];
-WebColors.LawnGreen = [124, 252, 0, 1];
-WebColors.Chartreuse = [127, 255, 0, 1];
-WebColors.LightGreen = [144, 238, 144, 1];
-WebColors.GreenYellow = [173, 255, 47, 1];
-WebColors.PaleGreen = [152, 251, 152, 1];
-WebColors.Teal = [0, 128, 128, 1];
-WebColors.DarkCyan = [0, 139, 139, 1];
-WebColors.LightSeaGreen = [32, 178, 170, 1];
-WebColors.CadetBlue = [95, 158, 160, 1];
-WebColors.DarkTurquoise = [0, 206, 209, 1];
-WebColors.MediumTurquoise = [72, 209, 204, 1];
-WebColors.Turquoise = [64, 224, 208, 1];
-WebColors.Aqua = [0, 255, 255, 1];
-WebColors.Cyan = [0, 255, 255, 1];
-WebColors.Aquamarine = [127, 255, 212, 1];
-WebColors.PaleTurquoise = [175, 238, 238, 1];
-WebColors.LightCyan = [224, 255, 255, 1];
-WebColors.Navy = [0, 0, 128, 1];
-WebColors.DarkBlue = [0, 0, 139, 1];
-WebColors.MediumBlue = [0, 0, 205, 1];
-WebColors.Blue = [0, 0, 255, 1];
-WebColors.MidnightBlue = [25, 25, 112, 1];
-WebColors.RoyalBlue = [65, 105, 225, 1];
-WebColors.SteelBlue = [70, 130, 180, 1];
-WebColors.DodgerBlue = [30, 144, 255, 1];
-WebColors.DeepSkyBlue = [0, 191, 255, 1];
-WebColors.CornflowerBlue = [100, 149, 237, 1];
-WebColors.SkyBlue = [135, 206, 235, 1];
-WebColors.LightSkyBlue = [135, 206, 250, 1];
-WebColors.LightSteelBlue = [176, 196, 222, 1];
-WebColors.LightBlue = [173, 216, 230, 1];
-WebColors.PowderBlue = [176, 224, 230, 1];
-WebColors.Indigo = [75, 0, 130, 1];
-WebColors.Purple = [128, 0, 128, 1];
-WebColors.DarkMagenta = [139, 0, 139, 1];
-WebColors.DarkViolet = [148, 0, 211, 1];
-WebColors.DarkSlateBlue = [72, 61, 139, 1];
-WebColors.BlueViolet = [138, 43, 226, 1];
-WebColors.DarkOrchid = [153, 50, 204, 1];
-WebColors.Fuchsia = [255, 0, 255, 1];
-WebColors.Magenta = [255, 0, 255, 1];
-WebColors.SlateBlue = [106, 90, 205, 1];
-WebColors.MediumSlateBlue = [123, 104, 238, 1];
-WebColors.MediumOrchid = [186, 85, 211, 1];
-WebColors.MediumPurple = [147, 112, 219, 1];
-WebColors.Orchid = [218, 112, 214, 1];
-WebColors.Violet = [238, 130, 238, 1];
-WebColors.Plum = [221, 160, 221, 1];
-WebColors.Thistle = [216, 191, 216, 1];
-WebColors.Lavender = [230, 230, 250, 1];
-WebColors.MistyRose = [255, 228, 225, 1];
-WebColors.AntiqueWhite = [250, 235, 215, 1];
-WebColors.Linen = [250, 240, 230, 1];
-WebColors.Beige = [245, 245, 220, 1];
-WebColors.WhiteSmoke = [245, 245, 245, 1];
-WebColors.LavenderBlush = [255, 240, 245, 1];
-WebColors.OldLace = [253, 245, 230, 1];
-WebColors.AliceBlue = [240, 248, 255, 1];
-WebColors.Seashell = [255, 245, 238, 1];
-WebColors.GhostWhite = [248, 248, 255, 1];
-WebColors.Honeydew = [240, 255, 240, 1];
-WebColors.FloralWhite = [255, 250, 240, 1];
-WebColors.Azure = [240, 255, 255, 1];
-WebColors.MintCream = [245, 255, 250, 1];
-WebColors.Snow = [255, 250, 250, 1];
-WebColors.Ivory = [255, 255, 240, 1];
-WebColors.White = [255, 255, 255, 1];
-WebColors.Black = [0, 0, 0, 1];
-WebColors.DarkSlateGray = [47, 79, 79, 1];
-WebColors.DimGray = [105, 105, 105, 1];
-WebColors.SlateGray = [112, 128, 144, 1];
-WebColors.Gray = [128, 128, 128, 1];
-WebColors.LightSlateGray = [119, 136, 153, 1];
-WebColors.DarkGray = [169, 169, 169, 1];
-WebColors.Silver = [192, 192, 192, 1];
-WebColors.LightGray = [211, 211, 211, 1];
-WebColors.Gainsboro = [220, 220, 220, 1];
-WebColors.RebeccaPurple = [102, 51, 153, 1];
-
-class Constants {
-}
-/** Size of the font showing frames per second */
-Constants.FPS_DISPLAY_TEXT_FONT_SIZE = 12;
-/** Color of the font showing frames per second */
-Constants.FPS_DISPLAY_TEXT_COLOR = [0, 0, 0, 0.5];
-/** Frequency, in milliseconds, at which to update frames per second metric shown on the screen */
-Constants.FPS_DISPLAY_UPDATE_INTERVAL = 1e3;
-/** Maximum number of activity metrics to log. */
-Constants.MAXIMUM_RECORDED_ACTIVITY_METRICS = 32;
-/** The frames per second will be logged in game metrics if the FPS is lower than this value */
-Constants.FPS_METRIC_REPORT_THRESHOLD = 59;
-/** Scene color, if none is specified. */
-Constants.DEFAULT_SCENE_BACKGROUND_COLOR = WebColors.White;
-/** Shape fill color, if none is specified. */
-Constants.DEFAULT_SHAPE_FILL_COLOR = WebColors.Red;
-/** Color of paths in a shape, if none is specified. */
-Constants.DEFAULT_PATH_STROKE_COLOR = WebColors.Red;
-/** Line width of paths in a shape, if none is specified. */
-Constants.DEFAULT_PATH_LINE_WIDTH = 2;
-/** Color of text in Label and TextLine, if none is specified. */
-Constants.DEFAULT_FONT_COLOR = WebColors.Black;
-/** Font size in Label and TextLine, if none is specified. */
-Constants.DEFAULT_FONT_SIZE = 16;
-Constants.LIMITED_FPS_RATE = 5;
-Constants.FREE_NODES_SCENE_NAME = "__freeNodesScene";
-Constants.OUTGOING_SCENE_NAME = "__outgoingScene";
-Constants.OUTGOING_SCENE_SPRITE_NAME = "__outgoingSceneSprite";
-Constants.OUTGOING_SCENE_IMAGE_NAME = "__outgoingSceneSnapshot";
-Constants.SESSION_INITIALIZATION_POLLING_INTERVAL_MS = 50;
-/** Placeholder that will be populated during the build process. */
-Constants.MODULE_METADATA_PLACEHOLDER = {
-  name: "",
-  version: "",
-  dependencies: {}
-};
-Constants.DEFAULT_ROOT_ELEMENT_ID = "m2c2kit";
-
 class ColorfulMutablePath extends MutablePath {
   constructor() {
     super(...arguments);
@@ -7942,7 +8261,6 @@ class EventMaterializer {
         `EventMaterializer: composite node of type ${event.compositeType} with uuid ${event.target} not found when handling CompositeEvent ${event.compositeEventType}`
       );
     } else {
-      console.log(`calling handleCompositeEvent on composite node`);
       if (node.type === M2NodeType.Composite) {
         node.handleCompositeEvent(event);
       } else {
@@ -8278,6 +8596,11 @@ class Game {
         dependencies: {}
       };
     }
+    if (options.moduleMetadata?.name && options.version) {
+      console.log(
+        `\u26AA ${options.moduleMetadata.name} version ${options.version}`
+      );
+    }
   }
   createFreeNodesScene() {
     this.freeNodesScene.game = this;
@@ -8384,7 +8707,29 @@ class Game {
       ...M2c2KitHelpers.createFrameUpdateTimestamps()
     });
   }
+  async waitForErudaInitialization(maxWaitDurationMs = 5e3) {
+    await new Promise((resolve) => {
+      let cumulativeWaitTime = 0;
+      const intervalId = setInterval(() => {
+        if (m2c2Globals.erudaInitialized === true) {
+          clearInterval(intervalId);
+          resolve(void 0);
+        }
+        cumulativeWaitTime = cumulativeWaitTime + 100;
+        if (cumulativeWaitTime > maxWaitDurationMs) {
+          console.warn(
+            `Could not initialize eruda within ${maxWaitDurationMs} milliseconds.`
+          );
+          clearInterval(intervalId);
+          resolve(void 0);
+        }
+      }, 100);
+    });
+  }
   async initialize() {
+    if (m2c2Globals.erudaRequested === true) {
+      await this.waitForErudaInitialization();
+    }
     if (this.options.recordEvents === true) {
       this.eventStore.mode = EventStoreMode.Record;
     }
@@ -8694,17 +9039,50 @@ class Game {
   setParameters(additionalParameters) {
     const { parameters } = this.options;
     Object.keys(additionalParameters).forEach((key) => {
+      if (key === "eruda") {
+        const erudaRequested = additionalParameters[key] === true;
+        if (erudaRequested) {
+          M2c2KitHelpers.loadEruda();
+        }
+        return;
+      }
+      if (key === "scripts") {
+        const scriptUrls = additionalParameters[key];
+        if (scriptUrls) {
+          M2c2KitHelpers.loadScriptUrls(scriptUrls);
+        }
+        return;
+      }
       if (!parameters || !(key in parameters)) {
         console.warn(
-          // eslint-disable-next-line @typescript-eslint/no-explicit-any
           `game ${this.options.name} does not have a parameter named ${key}. attempt to set parameter ${key} to value ${// eslint-disable-next-line @typescript-eslint/no-explicit-any
           additionalParameters[key]} will be ignored`
         );
       } else if (this.options.parameters && this.options.parameters[key]) {
-        this.options.parameters[key].default = additionalParameters[key];
+        const providedValue = additionalParameters[key];
+        let value;
+        if (this.options.parameters[key].type !== void 0 && providedValue !== void 0) {
+          try {
+            value = M2c2KitHelpers.convertValueToType(
+              providedValue,
+              this.options.parameters[key].type
+            );
+          } catch (e) {
+            throw new Error(
+              "Error setting parameter " + key + ": " + e.message
+            );
+          }
+        } else {
+          value = providedValue;
+        }
+        this.options.parameters[key].default = value;
+      }
+      if (this.additionalParameters === void 0) {
+        this.additionalParameters = {};
       }
+      this.additionalParameters[key] = // eslint-disable-next-line @typescript-eslint/no-explicit-any
+      additionalParameters[key];
     });
-    this.additionalParameters = additionalParameters;
   }
   get canvasKit() {
     if (!this._canvasKit) {
@@ -10507,8 +10885,8 @@ class Game {
       handled: false,
       ...M2c2KitHelpers.createTimestamps()
     };
-    this.processDomPointerDown(scene, nodeEvent, domPointerEvent);
     this.processDomPointerDown(this.freeNodesScene, nodeEvent, domPointerEvent);
+    this.processDomPointerDown(scene, nodeEvent, domPointerEvent);
   }
   htmlCanvasPointerUpHandler(domPointerEvent) {
     domPointerEvent.preventDefault();
@@ -10522,8 +10900,8 @@ class Game {
       handled: false,
       ...M2c2KitHelpers.createTimestamps()
     };
-    this.processDomPointerUp(scene, nodeEvent, domPointerEvent);
     this.processDomPointerUp(this.freeNodesScene, nodeEvent, domPointerEvent);
+    this.processDomPointerUp(scene, nodeEvent, domPointerEvent);
   }
   htmlCanvasPointerMoveHandler(domPointerEvent) {
     domPointerEvent.preventDefault();
@@ -10537,8 +10915,8 @@ class Game {
       handled: false,
       ...M2c2KitHelpers.createTimestamps()
     };
-    this.processDomPointerMove(scene, nodeEvent, domPointerEvent);
     this.processDomPointerMove(this.freeNodesScene, nodeEvent, domPointerEvent);
+    this.processDomPointerMove(scene, nodeEvent, domPointerEvent);
   }
   htmlCanvasPointerLeaveHandler(domPointerEvent) {
     if (!this.currentScene) {
@@ -10555,12 +10933,12 @@ class Game {
       handled: false,
       ...M2c2KitHelpers.createTimestamps()
     };
-    this.processDomPointerLeave(scene, nodeEvent, domPointerEvent);
     this.processDomPointerLeave(
       this.freeNodesScene,
       nodeEvent,
       domPointerEvent
     );
+    this.processDomPointerLeave(scene, nodeEvent, domPointerEvent);
   }
   /**
    * Determines if/how m2c2kit nodes respond to the DOM PointerDown event
@@ -11052,7 +11430,8 @@ function initializeGlobalVariables() {
     get eventSequence() {
       m2c2Globals.__sequence++;
       return m2c2Globals.__sequence - 1;
-    }
+    },
+    addedScriptUrls: []
   };
 }
 initializeGlobalVariables();
@@ -11651,7 +12030,7 @@ class Story {
   }
 }
 
-console.log("\u26AA @m2c2kit/core version 0.3.19 (0679492d)");
+console.log("\u26AA @m2c2kit/core version 0.3.21 (05ed0dd2)");
 
 export { Action, ActivityType, CanvasKitHelpers, ColorfulMutablePath, Composite, Constants, ConstraintType, CustomAction, Dimensions, Easings, Equal, Equals, EventStore, EventStoreMode, FadeAlphaAction, FontManager, Game, GroupAction, I18n, ImageManager, Label, LabelHorizontalAlignmentMode, LayoutConstraint, LegacyTimer, M2EventType, M2ImageStatus, M2Node, M2NodeFactory, M2NodeType, M2SoundStatus, M2c2KitHelpers, MoveAction, MutablePath, NoneTransition, PlayAction, RandomDraws, RepeatAction, RepeatForeverAction, RotateAction, ScaleAction, Scene, SceneTransition, SequenceAction, Shape, ShapeType, SlideTransition, SoundManager, SoundPlayer, SoundRecorder, Sprite, Story, TextLine, Timer, Transition, TransitionDirection, TransitionType, Uuid, WaitAction, WebColors, WebGlInfo, handleInterfaceOptions };
 //# sourceMappingURL=index.js.map