@woosh/meep-engine 2.85.0 → 2.85.2

package/build/meep.module.js

@@ -89385,6 +89385,7 @@ class GraphicsEngine {
             return intersectObject;
         })();
     }
+
     /**
      *
      * @returns {MaterialManager}
@@ -89468,7 +89469,7 @@ class GraphicsEngine {
 
     start() {
         const canvas = document.createElement("canvas");
-        const context = canvas.getContext("webgl2", {antialias: false});
+        const context = canvas.getContext("webgl2", { antialias: false });
 
         const rendererParameters = {
             antialias: true,
@@ -89665,6 +89666,10 @@ class GraphicsEngine {
         // TODO designate opaque output buffer
         const frameBuffer = buffers.getById(StandardFrameBuffers.ColorAndDepth);
 
+        if (frameBuffer === undefined) {
+            throw new Error(`No color-depth frame buffer`);
+        }
+
         renderTextureToScreenQuad(frameBuffer.renderTarget.texture, renderer);
 
         this.on.postOpaquePass.send0();
@@ -91074,7 +91079,21 @@ class StaticKnowledgeDatabase {
      * @private
      */
     __specs = [];
-    
+
+    /**
+     *
+     * @type {boolean}
+     */
+    #validation_enabled = false;
+
+    /**
+     *
+     * @param {boolean} v
+     */
+    set validation_enabled(v) {
+        this.#validation_enabled = v;
+    }
+
 
     /**
      * Reset database, drop all table data
@@ -91317,7 +91336,7 @@ class StaticKnowledgeDatabase {
         return Promise.all(promises).then(() => {
             let p = this.link(am, executor);
 
-            if (!ENV_PRODUCTION) {
+            if (this.#validation_enabled) {
                 p = p.then(() => this.validate(executor));
             }
 
@@ -103164,14 +103183,16 @@ class Engine {
      *
      * @param {EnginePlatform} platform
      * @param {EntityManager} [entityManager]
-     * @param enableGraphics
-     * @param enableAudio
+     * @param {boolean} [enableGraphics]
+     * @param {boolean} [enableAudio]
+     * @param {boolean} [validation]
      * @constructor
      */
     constructor(platform, {
         entityManager,
         enableGraphics = true,
-        enableAudio = true
+        enableAudio = true,
+        validation = true
     } = {}) {
 
         /**
@@ -103185,6 +103206,7 @@ class Engine {
          * @type {StaticKnowledgeDatabase}
          */
         this.staticKnowledge = new StaticKnowledgeDatabase();
+        this.staticKnowledge.validation_enabled = validation;
 
         /**
          *
@@ -103346,7 +103368,7 @@ class Engine {
             try {
                 graphicsEngine.start();
             } catch (e) {
-                logger.info("Failed to start GraphicEngine: ", e);
+                logger.error(`Failed to start GraphicEngine: ${e}`);
             }
 
         } else {
@@ -103578,7 +103600,7 @@ class Engine {
             requestAnimationFrame(this.#animation_frame);
 
             //start simulation
-            this.ticker.start({maxTimeout: 200});
+            this.ticker.start({ maxTimeout: 200 });
             //self.uiController.init(self);
 
             //load options

package/package.json

@@ -5,7 +5,7 @@
   "description": "Fully featured ECS game engine written in JavaScript",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.85.0",
+  "version": "2.85.2",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {

package/src/core/cache/LoadingCache.js

@@ -148,16 +148,17 @@ export class LoadingCache {
 
         this.#internal.put(key, record);
 
-        promise.then((value) => {
-            // re-score value based on actual data
-            record.weight = this.#value_weigher(value);
-            this.#internal.updateElementWeight(key);
-        });
-
-        promise.catch(() => {
-            // mark as failure
-            record.failed = true;
-        });
+        promise.then(
+            (value) => {
+                // re-score value based on actual data
+                record.weight = this.#value_weigher(value);
+                this.#internal.updateElementWeight(key);
+            },
+            () => {
+                // mark as failure
+                record.failed = true;
+            }
+        );
 
         return record;
     }

package/src/core/cache/LoadingCache.spec.js

@@ -1,26 +1,27 @@
-import { delay } from "../process/delay.js";
 import { LoadingCache } from "./LoadingCache.js";
 
-test("successful load", async () => {
+jest.useFakeTimers();
+
+test("successful load", () => {
     const cache = new LoadingCache({
         async load(key) {
             return 17;
         }
     });
 
-    expect(await cache.get(1)).toEqual(17);
+    expect( cache.get(1)).resolves.toEqual(17);
 });
 
-test("when loader throws an exception, we should get a failed promise", async () => {
+test("when loader throws an exception, we should get a failed promise",  () => {
     const cache = new LoadingCache({
         load(key) {
-            throw 1;
+            throw "Designed Thrown Thing";
         }
     });
 
     const promise = cache.get("a");
 
-    await expect(promise).rejects.toEqual(1);
+    expect(promise).rejects.toEqual("Designed Thrown Thing");
 });
 
 test("record reuse", async () => {
@@ -30,8 +31,8 @@ test("record reuse", async () => {
         load
     });
 
-    expect(await cache.get(1)).toEqual(17);
-    expect(await cache.get(1)).toEqual(17);
+    await expect(cache.get(1)).resolves.toEqual(17);
+    await expect(cache.get(1)).resolves.toEqual(17);
 
     expect(load).toHaveBeenCalledTimes(1);
 });
@@ -44,47 +45,23 @@ test("timeout reload reuse", async () => {
 
     const cache = new LoadingCache({
         load,
-        timeToLive: 0.0000001
+        timeToLive: 0.00000001
     });
 
     const request_1 = await cache.get(1);
     expect(request_1).toEqual(11);
 
-    await delay(2);
+    jest.advanceTimersByTime(1);
 
     const request_2 = await cache.get(1);
     expect(request_2).toEqual(5);
 
-    await delay(2);
+    jest.advanceTimersByTime(1);
 
     const request_3 = await cache.get(1);
     expect(request_3).toEqual(3);
 });
 
-test("insert element directly", async () => {
-
-    const cache = new LoadingCache({
-        load: async () => 3
-    });
-
-    cache.put("x", 1);
-
-    expect(await cache.get("x")).toEqual(1);
-});
-
-test("clear", async () => {
-
-    const cache = new LoadingCache({
-        load: async () => 3
-    });
-
-    cache.put("x", 1);
-
-    cache.clear();
-
-    expect(await cache.get("x")).toEqual(3);
-});
-
 test("eviction", async () => {
 
     /**
@@ -116,4 +93,28 @@ test("eviction", async () => {
     expect(cache.contains(3)).toBe(true);
     expect(cache.contains(4)).toBe(true);
 
-});
+});
+
+test("insert element directly", async () => {
+
+    const cache = new LoadingCache({
+        load: async () => 3
+    });
+
+    cache.put("x", 1);
+
+    expect(await cache.get("x")).toEqual(1);
+});
+
+test("clear", async () => {
+
+    const cache = new LoadingCache({
+        load: async () => 3
+    });
+
+    cache.put("x", 1);
+
+    cache.clear();
+
+    expect(await cache.get("x")).toEqual(3);
+});

package/src/engine/Engine.d.ts

@@ -1,20 +1,21 @@
-import {EnginePlatform} from "./platform/EnginePlatform";
-import SceneManager from "./scene/SceneManager";
+import ConcurrentExecutor from "../core/process/executor/ConcurrentExecutor";
+import View from "../view/View";
+import {AssetManager} from "./asset/AssetManager";
+import {EntityManager} from "./ecs/EntityManager";
 import {GraphicsEngine} from "./graphics/GraphicsEngine";
-import SoundEngine from "./sound/SoundEngine";
 import KeyboardDevice from "./input/devices/KeyboardDevice";
 import {PointerDevice} from "./input/devices/PointerDevice";
-import {AssetManager} from "./asset/AssetManager";
-import {EntityManager} from "./ecs/EntityManager";
-import View from "../view/View";
-import Ticker from "./simulation/Ticker";
+import {EnginePlatform} from "./platform/EnginePlatform";
 import {EnginePluginManager} from "./plugin/EnginePluginManager";
-import ConcurrentExecutor from "../core/process/executor/ConcurrentExecutor";
+import SceneManager from "./scene/SceneManager";
+import Ticker from "./simulation/Ticker";
+import SoundEngine from "./sound/SoundEngine";
 
 export interface IEngineInitializationOptions {
     entityManager?: EntityManager,
     enableAudio?: boolean
     enableGraphics?: boolean
+    validation?:boolean
 }
 
 export default class Engine {

package/src/engine/Engine.js

@@ -2,30 +2,30 @@
  *
  */
 
-import {PerspectiveCamera as ThreePerspectiveCamera} from 'three';
-import {assert} from "../core/assert.js";
+import { PerspectiveCamera as ThreePerspectiveCamera } from 'three';
+import { assert } from "../core/assert.js";
 import Vector1 from "../core/geom/Vector1.js";
-import {Localization} from "../core/localization/Localization.js";
-import {ModuleRegistry} from "../core/model/ModuleRegistry.js";
+import { Localization } from "../core/localization/Localization.js";
+import { ModuleRegistry } from "../core/model/ModuleRegistry.js";
 import ObservedBoolean from "../core/model/ObservedBoolean.js";
 import ConcurrentExecutor from '../core/process/executor/ConcurrentExecutor.js';
 import EmptyView from "../view/elements/EmptyView.js";
-import {ViewStack} from "../view/elements/navigation/ViewStack.js";
+import { ViewStack } from "../view/elements/navigation/ViewStack.js";
 
-import {AssetManager} from './asset/AssetManager.js';
+import { AssetManager } from './asset/AssetManager.js';
 import Preloader from "./asset/preloader/Preloader.js";
-import {MetricCollection} from "./development/performance/MetricCollection.js";
-import {MetricStatistics} from "./development/performance/MetricStatistics.js";
-import {PeriodicConsolePrinter} from "./development/performance/monitor/PeriodicConsolePrinter.js";
-import {EntityManager} from "./ecs/EntityManager.js";
-import {BinarySerializationRegistry} from "./ecs/storage/binary/BinarySerializationRegistry.js";
-import {GraphicsEngine} from './graphics/GraphicsEngine.js';
+import { MetricCollection } from "./development/performance/MetricCollection.js";
+import { MetricStatistics } from "./development/performance/MetricStatistics.js";
+import { PeriodicConsolePrinter } from "./development/performance/monitor/PeriodicConsolePrinter.js";
+import { EntityManager } from "./ecs/EntityManager.js";
+import { BinarySerializationRegistry } from "./ecs/storage/binary/BinarySerializationRegistry.js";
+import { GraphicsEngine } from './graphics/GraphicsEngine.js';
 import KeyboardDevice from "./input/devices/KeyboardDevice.js";
-import {PointerDevice} from "./input/devices/PointerDevice.js";
-import {StaticKnowledgeDatabase} from "./knowledge/database/StaticKnowledgeDatabase.js";
-import {logger} from "./logging/GlobalLogger.js";
-import {OptionGroup} from "./options/OptionGroup.js";
-import {EnginePluginManager} from "./plugin/EnginePluginManager.js";
+import { PointerDevice } from "./input/devices/PointerDevice.js";
+import { StaticKnowledgeDatabase } from "./knowledge/database/StaticKnowledgeDatabase.js";
+import { logger } from "./logging/GlobalLogger.js";
+import { OptionGroup } from "./options/OptionGroup.js";
+import { EnginePluginManager } from "./plugin/EnginePluginManager.js";
 import SceneManager from "./scene/SceneManager.js";
 import Ticker from "./simulation/Ticker.js";
 import SoundEngine from './sound/SoundEngine.js';
@@ -52,14 +52,16 @@ class Engine {
      *
      * @param {EnginePlatform} platform
      * @param {EntityManager} [entityManager]
-     * @param enableGraphics
-     * @param enableAudio
+     * @param {boolean} [enableGraphics]
+     * @param {boolean} [enableAudio]
+     * @param {boolean} [validation]
      * @constructor
      */
     constructor(platform, {
         entityManager,
         enableGraphics = true,
-        enableAudio = true
+        enableAudio = true,
+        validation = true
     } = {}) {
         assert.defined(platform, 'platform');
 
@@ -74,6 +76,7 @@ class Engine {
          * @type {StaticKnowledgeDatabase}
          */
         this.staticKnowledge = new StaticKnowledgeDatabase();
+        this.staticKnowledge.validation_enabled = validation;
 
         /**
          *
@@ -235,7 +238,7 @@ class Engine {
             try {
                 graphicsEngine.start();
             } catch (e) {
-                logger.info("Failed to start GraphicEngine: ", e);
+                logger.error(`Failed to start GraphicEngine: ${e}`);
             }
 
         } else {
@@ -468,7 +471,7 @@ class Engine {
             requestAnimationFrame(this.#animation_frame);
 
             //start simulation
-            this.ticker.start({maxTimeout: 200});
+            this.ticker.start({ maxTimeout: 200 });
             //self.uiController.init(self);
 
             //load options

package/src/engine/graphics/GraphicsEngine.js

@@ -232,6 +232,7 @@ export class GraphicsEngine {
             return intersectObject;
         })();
     }
+
     /**
      *
      * @returns {MaterialManager}
@@ -315,7 +316,7 @@ export class GraphicsEngine {
 
     start() {
         const canvas = document.createElement("canvas");
-        const context = canvas.getContext("webgl2", {antialias: false});
+        const context = canvas.getContext("webgl2", { antialias: false });
 
         const rendererParameters = {
             antialias: true,
@@ -519,6 +520,10 @@ export class GraphicsEngine {
         // TODO designate opaque output buffer
         const frameBuffer = buffers.getById(StandardFrameBuffers.ColorAndDepth);
 
+        if (frameBuffer === undefined) {
+            throw new Error(`No color-depth frame buffer`);
+        }
+
         renderTextureToScreenQuad(frameBuffer.renderTarget.texture, renderer);
 
         this.on.postOpaquePass.send0();

package/src/engine/knowledge/database/StaticKnowledgeDatabase.js

@@ -1,10 +1,10 @@
+import { IllegalStateException } from "../../../core/fsm/exceptions/IllegalStateException.js";
+import { objectKeyByValue } from "../../../core/model/object/objectKeyByValue.js";
 import ObservedEnum from "../../../core/model/ObservedEnum.js";
-import { GameAssetType } from "../../asset/GameAssetType.js";
-import TaskGroup from "../../../core/process/task/TaskGroup.js";
 import Task from "../../../core/process/task/Task.js";
+import TaskGroup from "../../../core/process/task/TaskGroup.js";
+import { GameAssetType } from "../../asset/GameAssetType.js";
 import { StaticKnowledgeDataTableDescriptor } from "./StaticKnowledgeDataTableDescriptor.js";
-import { IllegalStateException } from "../../../core/fsm/exceptions/IllegalStateException.js";
-import { objectKeyByValue } from "../../../core/model/object/objectKeyByValue.js";
 
 /**
  * @readonly
@@ -32,7 +32,21 @@ export class StaticKnowledgeDatabase {
      * @private
      */
     __specs = [];
-    
+
+    /**
+     *
+     * @type {boolean}
+     */
+    #validation_enabled = false;
+
+    /**
+     *
+     * @param {boolean} v
+     */
+    set validation_enabled(v) {
+        this.#validation_enabled = v;
+    }
+
 
     /**
      * Reset database, drop all table data
@@ -279,7 +293,7 @@ export class StaticKnowledgeDatabase {
         return Promise.all(promises).then(() => {
             let p = this.link(am, executor);
 
-            if (!ENV_PRODUCTION) {
+            if (this.#validation_enabled) {
                 p = p.then(() => this.validate(executor));
             }