@woosh/meep-engine 2.52.0 → 2.54.0

package/editor/actions/concrete/WriteGridValueAction.js

@@ -1,4 +1,4 @@
-import GridObstacle from "../../../src/engine/grid/components/GridObstacle.js";
+import GridObstacle from "../../../src/engine/grid/obstacle/GridObstacle.js";
 import { Action } from "../../../src/core/process/undo/Action.js";
 
 class WriteGridValueAction extends Action {

package/editor/ecs/component/prototypeObjectEditor.js

@@ -47,7 +47,7 @@ import { ParticleEmitterEditor } from "./editors/ecs/ParticleEmitterEditor.js";
 import Vector4 from "../../../src/core/geom/Vector4.js";
 import { Vector4Editor } from "./editors/geom/Vector4Editor.js";
 import { Trail2DEditor } from "./editors/ecs/Trail2DEditor.js";
-import GridObstacle from "../../../src/engine/grid/components/GridObstacle.js";
+import GridObstacle from "../../../src/engine/grid/obstacle/GridObstacle.js";
 import { Vector2Editor } from "./editors/geom/Vector2Editor.js";
 import Vector2 from "../../../src/core/geom/Vector2.js";
 import { randomIntegerBetween } from "../../../src/core/math/random/randomIntegerBetween.js";

package/editor/process/ObstacleGridDisplayProcess.js

@@ -1,6 +1,6 @@
 import { EditorProcess } from "./EditorProcess.js";
-import GridObstacle from "../../src/engine/grid/components/GridObstacle.js";
-import GridPosition from "../../src/engine/grid/components/GridPosition.js";
+import GridObstacle from "../../src/engine/grid/obstacle/GridObstacle.js";
+import GridPosition from "../../src/engine/grid/position/GridPosition.js";
 import { Sampler2D } from "../../src/engine/graphics/texture/sampler/Sampler2D.js";
 import { obtainTerrain } from "../../src/engine/ecs/terrain/util/obtainTerrain.js";
 

package/editor/process/symbolic/makeGridPositionSymbolDisplay.js

@@ -11,7 +11,7 @@ import { Transform } from "../../../src/engine/ecs/transform/Transform.js";
 import EditorEntity from "../../ecs/EditorEntity.js";
 import { EventType } from "../../../src/engine/ecs/EntityManager.js";
 import { make3DSymbolicDisplay } from "./make3DSymbolicDisplay.js";
-import GridPosition from "../../../src/engine/grid/components/GridPosition.js";
+import GridPosition from "../../../src/engine/grid/position/GridPosition.js";
 import { ProcessState } from "../../../src/core/process/ProcessState.js";
 import { obtainTerrain } from "../../../src/engine/ecs/terrain/util/obtainTerrain.js";
 

package/editor/tools/GridPaintTool.js

@@ -1,6 +1,6 @@
 import Tool from "./engine/Tool.js";
-import GridPosition from "../../src/engine/grid/components/GridPosition.js";
-import GridObstacle from "../../src/engine/grid/components/GridObstacle.js";
+import GridPosition from "../../src/engine/grid/position/GridPosition.js";
+import GridObstacle from "../../src/engine/grid/obstacle/GridObstacle.js";
 import Vector4 from "../../src/core/geom/Vector4.js";
 import ObservedValue from "../../src/core/model/ObservedValue.js";
 import Vector1 from "../../src/core/geom/Vector1.js";

package/package.json

@@ -5,7 +5,7 @@
   "description": "Fully featured ECS game engine written in JavaScript",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "2.52.0",
+  "version": "2.54.0",
   "main": "build/meep.module.js",
   "module": "build/meep.module.js",
   "exports": {
@@ -52,8 +52,9 @@
     "@rollup/plugin-terser": "0.4.0",
     "@rollup/plugin-strip": "3.0.2",
     "@types/three": "^0.135.0",
-    "babel-jest": "26.6.3",
-    "jest": "26.6.3",
+    "babel-jest": "29.5.0",
+    "jest": "29.5.0",
+    "jest-environment-jsdom": "29.5.0",
     "rollup": "3.16.0"
   },
   "keywords": [

package/samples/generation/SampleGenerator0.js

@@ -2,7 +2,7 @@ import { GridTaskGroup } from "../../src/generation/GridTaskGroup.js";
 import { GridCellPlacementRule } from "../../src/generation/placement/GridCellPlacementRule.js";
 import { CellMatcherGridPattern } from "../../src/generation/rules/cell/CellMatcherGridPattern.js";
 import { CellMatcherLayerBitMaskTest } from "../../src/generation/rules/CellMatcherLayerBitMaskTest.js";
-import { GridTags } from "../../src/generation/GridTags.js";
+import { GridTags } from "./grid/GridTags.js";
 import { CellMatcherNot } from "../../src/generation/rules/logic/CellMatcherNot.js";
 import { GridCellActionPlaceMarker } from "../../src/generation/markers/GridCellActionPlaceMarker.js";
 import { GridTaskCellularAutomata } from "../../src/generation/grid/generation/discrete/GridTaskCellularAutomata.js";

package/samples/generation/generators/interactive/mir_generator_place_buff_objects.js

@@ -5,7 +5,7 @@ import {
     CellMatcherContainsMarkerWithinRadius
 } from "../../../../src/generation/rules/cell/CellMatcherContainsMarkerWithinRadius.js";
 import { GridCellActionPlaceTags } from "../../../../src/generation/placement/action/GridCellActionPlaceTags.js";
-import { GridTags } from "../../../../src/generation/GridTags.js";
+import { GridTags } from "../../grid/GridTags.js";
 import { bitwiseAnd } from "../../../../src/core/binary/operations/bitwiseAnd.js";
 import { GridCellActionPlaceMarker } from "../../../../src/generation/markers/GridCellActionPlaceMarker.js";
 import { GridCellPlacementRule } from "../../../../src/generation/placement/GridCellPlacementRule.js";

package/samples/generation/generators/mir_generator_place_bases.js

@@ -3,7 +3,7 @@ import { GridCellPlacementRule } from "../../../src/generation/placement/GridCel
 import { CellMatcherGridPattern } from "../../../src/generation/rules/cell/CellMatcherGridPattern.js";
 import { GridActionRuleSet } from "../../../src/generation/markers/GridActionRuleSet.js";
 import { GridCellActionPlaceTags } from "../../../src/generation/placement/action/GridCellActionPlaceTags.js";
-import { GridTags } from "../../../src/generation/GridTags.js";
+import { GridTags } from "../grid/GridTags.js";
 import { GridCellActionPlaceMarker } from "../../../src/generation/markers/GridCellActionPlaceMarker.js";
 import { CellMatcherNot } from "../../../src/generation/rules/logic/CellMatcherNot.js";
 import {

package/samples/generation/generators/mir_generator_place_road_decorators.js

@@ -3,7 +3,7 @@ import { GridActionRuleSet } from "../../../src/generation/markers/GridActionRul
 import { GridCellPlacementRule } from "../../../src/generation/placement/GridCellPlacementRule.js";
 import { CellMatcherGridPattern } from "../../../src/generation/rules/cell/CellMatcherGridPattern.js";
 import { CellMatcherLayerBitMaskTest } from "../../../src/generation/rules/CellMatcherLayerBitMaskTest.js";
-import { GridTags } from "../../../src/generation/GridTags.js";
+import { GridTags } from "../grid/GridTags.js";
 import { CellMatcherAnd } from "../../../src/generation/rules/logic/CellMatcherAnd.js";
 import { CellMatcherNot } from "../../../src/generation/rules/logic/CellMatcherNot.js";
 import { GridCellActionPlaceMarker } from "../../../src/generation/markers/GridCellActionPlaceMarker.js";

package/samples/generation/generators/mir_generator_place_starting_point.js

@@ -2,7 +2,7 @@ import { GridCellPlacementRule } from "../../../src/generation/placement/GridCel
 import { matcher_tag_traversable_unoccupied } from "../rules/matcher_tag_traversable_unoccupied.js";
 import { CellMatcherNot } from "../../../src/generation/rules/logic/CellMatcherNot.js";
 import { GridCellActionPlaceTags } from "../../../src/generation/placement/action/GridCellActionPlaceTags.js";
-import { GridTags } from "../../../src/generation/GridTags.js";
+import { GridTags } from "../grid/GridTags.js";
 import { GridCellActionPlaceMarker } from "../../../src/generation/markers/GridCellActionPlaceMarker.js";
 import { GridTaskExecuteRuleTimes } from "../../../src/generation/grid/generation/GridTaskExecuteRuleTimes.js";
 import { CellMatcherLayerBitMaskTest } from "../../../src/generation/rules/CellMatcherLayerBitMaskTest.js";

package/samples/generation/main.js

@@ -7,9 +7,9 @@ import { TopDownCameraLander } from "../../src/engine/graphics/ecs/camera/topdow
 import Terrain from "../../src/engine/ecs/terrain/ecs/Terrain.js";
 import { TerrainFlags } from "../../src/engine/ecs/terrain/ecs/TerrainFlags.js";
 import Water from "../../src/engine/graphics/ecs/water/Water.js";
-import GridObstacle from "../../src/engine/grid/components/GridObstacle.js";
+import GridObstacle from "../../src/engine/grid/obstacle/GridObstacle.js";
 import EntityBuilder from "../../src/engine/ecs/EntityBuilder.js";
-import GridPosition from "../../src/engine/grid/components/GridPosition.js";
+import GridPosition from "../../src/engine/grid/position/GridPosition.js";
 import { Transform } from "../../src/engine/ecs/transform/Transform.js";
 import { GridData } from "../../src/generation/grid/GridData.js";
 import { computeStringHash } from "../../src/core/primitives/strings/computeStringHash.js";

package/samples/generation/rules/matcher_play_area.js

@@ -1,5 +1,5 @@
 import { CellMatcherLayerBitMaskTest } from "../../../src/generation/rules/CellMatcherLayerBitMaskTest.js";
-import { GridTags } from "../../../src/generation/GridTags.js";
+import { GridTags } from "../grid/GridTags.js";
 import { MirGridLayers } from "../grid/MirGridLayers.js";
 
 export const matcher_play_area = CellMatcherLayerBitMaskTest.from(GridTags.PlayArea, MirGridLayers.Tags);

package/samples/generation/rules/matcher_tag_occupied.js

@@ -1,5 +1,5 @@
 import { CellMatcherLayerBitMaskTest } from "../../../src/generation/rules/CellMatcherLayerBitMaskTest.js";
-import { GridTags } from "../../../src/generation/GridTags.js";
+import { GridTags } from "../grid/GridTags.js";
 import { MirGridLayers } from "../grid/MirGridLayers.js";
 
 export const matcher_tag_occupied = CellMatcherLayerBitMaskTest.from(GridTags.Occupied, MirGridLayers.Tags);

package/samples/generation/rules/matcher_tag_traversable.js

@@ -1,5 +1,5 @@
 import { CellMatcherLayerBitMaskTest } from "../../../src/generation/rules/CellMatcherLayerBitMaskTest.js";
-import { GridTags } from "../../../src/generation/GridTags.js";
+import { GridTags } from "../grid/GridTags.js";
 import { MirGridLayers } from "../grid/MirGridLayers.js";
 
 export const matcher_tag_traversable = CellMatcherLayerBitMaskTest.from(GridTags.Traversable, MirGridLayers.Tags);

package/samples/generation/themes/SampleTheme0.js

@@ -6,13 +6,13 @@ import { MarkerNodeMatcherByType } from "../../../src/generation/markers/matcher
 import {
     MarkerNodeActionEntityPlacement
 } from "../../../src/generation/markers/actions/MarkerNodeActionEntityPlacement.js";
-import { EntityBlueprint } from "../../../src/engine/ecs/EntityBlueprintjs";
-import Mesh from "../../../src/engine/graphics/ecs/mesh/Meshjs";
-import { Transform } from "../../../src/engine/ecs/transform/Transformjs";
-import GridPosition from "../../../src/engine/grid/components/GridPosition.js";
+import { EntityBlueprint } from "../../../src/engine/ecs/EntityBlueprint.js";
+import Mesh from "../../../src/engine/graphics/ecs/mesh/Mesh.js";
+import { Transform } from "../../../src/engine/ecs/transform/Transform.js";
+import GridPosition from "../../../src/engine/grid/position/GridPosition.js";
 import { matcher_tag_not_traversable } from "../rules/matcher_tag_not_traversable.js";
 import { CellMatcherLayerBitMaskTest } from "../../../src/generation/rules/CellMatcherLayerBitMaskTest.js";
-import { GridTags } from "../../../src/generation/GridTags.js";
+import { GridTags } from "../grid/GridTags.js";
 import { CellFilterCellMatcher } from "../../../src/generation/filtering/CellFilterCellMatcher.js";
 import { CellFilterSimplexNoise } from "../../../src/generation/filtering/numeric/complex/CellFilterSimplexNoise.js";
 import { CellFilterFXAA } from "../../../src/generation/filtering/numeric/complex/CellFilterFXAA.js";

package/src/core/collection/table/RowFirstTableSpec.js

@@ -88,7 +88,7 @@ function genRowReader(types, endianType = EndianType.BigEndian) {
  *
  * @param {BinaryDataType[]} types
  * @param {EndianType} [endianType]
- * @returns {(data_view:DataView, byte_offset:number, record:number[])=>void}
+ * @returns {function(data_view:DataView, byte_offset:number, record:number[]):void}
  */
 function genRowWriter(types, endianType = EndianType.BigEndian) {
     let offset = 0;
@@ -122,7 +122,7 @@ function genRowWriter(types, endianType = EndianType.BigEndian) {
  * @param {BinaryDataType} type
  * @param {number} offset
  * @param {EndianType} [endianType]
- * @returns {Function}
+ * @returns {function(data_view:DataView, byte_offset:number, value:number):void}
  */
 function genCellWriter(type, offset, endianType = EndianType.BigEndian) {
     const writeMethod = DataType2DataViewWriters[type];
@@ -140,7 +140,7 @@ function genCellWriter(type, offset, endianType = EndianType.BigEndian) {
  * @param {BinaryDataType} type
  * @param {number} offset
  * @param {EndianType} [endianType]
- * @returns {Function}
+ * @returns {function(data_view:DataView, byte_offset:number):number}
  */
 function genCellReader(type, offset, endianType = EndianType.BigEndian) {
     const readMethod = DataType2DataViewReaders[type];
@@ -153,6 +153,10 @@ function genCellReader(type, offset, endianType = EndianType.BigEndian) {
     });
 }
 
+/**
+ * This is a schema class for binary data tables of class {@link RowFirstTable}
+ * @class
+ */
 export class RowFirstTableSpec {
     /**
      *
@@ -179,7 +183,7 @@ export class RowFirstTableSpec {
 
         /**
          * @readonly
-         * @type {number[]}
+         * @type {Uint32Array}
          */
         this.columnOffsets = new Uint32Array(numTypes);
 

package/src/core/geom/3d/matrix/MATRIX_4_IDENTITY.spec.js

@@ -0,0 +1,10 @@
+import { MATRIX_4_IDENTITY } from "./MATRIX_4_IDENTITY.js";
+
+test("sanity", () => {
+    expect(Array.from(MATRIX_4_IDENTITY)).toEqual([
+        1, 0, 0, 0,
+        0, 1, 0, 0,
+        0, 0, 1, 0,
+        0, 0, 0, 1
+    ]);
+});

package/src/engine/Engine.spec.js

@@ -1,3 +1,7 @@
+/**
+ * @jest-environment jsdom
+ */
+
 import Engine from "./Engine.js";
 import { InMemoryEnginePlatform } from "./platform/InMemoryEnginePlatform.js";
 

package/src/engine/EngineConfiguration.js

@@ -2,31 +2,30 @@ import { assert } from "../core/assert.js";
 import { computeSystemName } from "./ecs/System.js";
 
 export class EngineConfiguration {
-    constructor() {
-        /**
-         * @private
-         * @type {System[]}
-         */
-        this.systems = [];
-
-        /**
-         * @private
-         * @type {Class<EnginePlugin>[]}
-         */
-        this.plugins = [];
-
-        /**
-         * @private
-         * @type {StaticKnowledgeDataTableDescriptor[]}
-         */
-        this.knowledge = [];
-
-        /**
-         *
-         * @type {Map<string,AssetLoader<any>>}
-         */
-        this.loaders = new Map();
-    }
+
+    /**
+     * @private
+     * @type {System[]}
+     */
+    systems = [];
+
+    /**
+     * @private
+     * @type {Class<EnginePlugin>[]}
+     */
+    plugins = [];
+
+    /**
+     * @private
+     * @type {StaticKnowledgeDataTableDescriptor[]}
+     */
+    knowledge = [];
+
+    /**
+     *
+     * @type {Map<string,AssetLoader<any>>}
+     */
+    loaders = new Map();
 
     /**
      *

package/src/engine/ecs/EntityBlueprint.js

@@ -3,7 +3,7 @@ import EntityBuilder from "./EntityBuilder.js";
 /**
  *
  * @param {Object} template
- * @param {Object} seed
+ * @param {Object} [seed]
  */
 function populateJsonTemplate(template, seed) {
     if (seed === undefined) {
@@ -41,9 +41,7 @@ function populateJsonTemplate(template, seed) {
                 for (const propertyName in template) {
                     const templateValue = template[propertyName];
 
-                    const seededValue = populateJsonTemplate(templateValue, seed);
-
-                    result[propertyName] = seededValue;
+                    result[propertyName] = populateJsonTemplate(templateValue, seed);
                 }
 
                 return result;

package/src/engine/ecs/EntityComponentDataset.js

@@ -185,7 +185,7 @@ export class EntityComponentDataset {
 
         /**
          *
-         * @type {Array<SignalHandler>[]}
+         * @type {SignalHandler[][]}
          * @private
          */
         this.__entityAnyEventListeners = [];

package/src/engine/ecs/EntityComponentDataset.spec.js

@@ -442,6 +442,30 @@ test('getComponent with 1 entity and 1 component', () => {
     expect(visitor_1).not.toHaveBeenCalled();
 });
 
+test("getComponent on unregistered component class", () => {
+
+    const ecd = new EntityComponentDataset();
+
+    const entity = ecd.createEntity();
+
+    expect(ecd.getComponent(entity, DummyComponentA)).toBe(undefined);
+});
+
+test("getComponentSafe", () => {
+
+    const ecd = new EntityComponentDataset();
+    ecd.registerComponentType(DummyComponentA);
+
+    const entity = ecd.createEntity();
+
+    expect(() => ecd.getComponentSafe(entity, DummyComponentA)).toThrow();
+
+    const component = new DummyComponentA();
+
+    ecd.addComponentToEntity(entity, component);
+
+    expect(ecd.getComponentSafe(entity, DummyComponentA)).toBe(component);
+});
 
 test('isComponentTypeRegistered', () => {
     const ecd = new EntityComponentDataset();
@@ -594,6 +618,59 @@ test('entityHasComponents', () => {
     expect(ecd.entityHasComponents(a)).toBe(true);
 });
 
+test("getAnyComponent", () => {
+
+    const ecd = new EntityComponentDataset();
+
+    ecd.registerManyComponentTypes([
+        DummyComponentA,
+        DummyComponentB
+    ]);
+
+    const a = ecd.createEntity();
+
+    expect(ecd.getAnyComponent(DummyComponentA)).toEqual({
+        entity: -1,
+        component: null
+    });
+
+    const component_a = new DummyComponentA();
+    ecd.addComponentToEntity(a, component_a);
+    ecd.addComponentToEntity(a, new DummyComponentB());
+
+    expect(ecd.getAnyComponent(DummyComponentA)).toEqual({
+        entity: a,
+        component: component_a
+    });
+
+});
+
+test("hasComponent", () => {
+
+
+    const ecd = new EntityComponentDataset();
+
+    ecd.registerManyComponentTypes([
+        DummyComponentA,
+        DummyComponentB
+    ]);
+
+    const a = ecd.createEntity();
+
+    expect(ecd.hasComponent(a, DummyComponentA)).toBe(false);
+    expect(ecd.hasComponent(a, DummyComponentB)).toBe(false);
+
+    ecd.addComponentToEntity(a, new DummyComponentA());
+
+    expect(ecd.hasComponent(a, DummyComponentA)).toBe(true);
+    expect(ecd.hasComponent(a, DummyComponentB)).toBe(false);
+
+    ecd.addComponentToEntity(a, new DummyComponentB());
+
+    expect(ecd.hasComponent(a, DummyComponentA)).toBe(true);
+    expect(ecd.hasComponent(a, DummyComponentB)).toBe(true);
+});
+
 describe('event management', () => {
 
     test("shouldn't be able to add event listener to non-existent entity", () => {

package/src/engine/ecs/EntityObserver.spec.js

@@ -1,6 +1,6 @@
 import { EntityObserver } from "./EntityObserver.js";
 import { Transform } from "./transform/Transform.js";
-import GridPosition from "../grid/components/GridPosition.js";
+import GridPosition from "../grid/position/GridPosition.js";
 import EntityBuilder from "./EntityBuilder.js";
 import { EntityComponentDataset } from "./EntityComponentDataset.js";
 import { noop } from "../../core/function/Functions.js";

package/src/engine/ecs/dynamic_actions/actions/definition/{WhiteToBlackboardActionDescription.js → WriteToBlackboardActionDescription.js}

@@ -4,7 +4,7 @@ import { Blackboard } from "../../../../intelligence/blackboard/Blackboard.js";
 import { compileReactiveExpression } from "../../../../../core/lang/reactive/compileReactiveExpression.js";
 import { assert } from "../../../../../core/assert.js";
 
-export class WhiteToBlackboardActionDescription extends AbstractActionDescription {
+export class WriteToBlackboardActionDescription extends AbstractActionDescription {
     constructor() {
         super();
 
@@ -55,4 +55,4 @@ export class WhiteToBlackboardActionDescription extends AbstractActionDescriptio
 }
 
 
-WhiteToBlackboardActionDescription.prototype.type = "Write";
+WriteToBlackboardActionDescription.prototype.type = "Write";

package/src/engine/ecs/dynamic_actions/actions/definition/deserializeActionFromJSON.js

@@ -5,7 +5,7 @@ import { ActionSequenceDescription } from "./ActionSequenceDescription.js";
 import { DelayActionDescription } from "./DelayActionDescription.js";
 import { NoopActionDescription } from "./NoopActionDescription.js";
 import { WeightedRandomActionDescription } from "./WeightedRandomActionDescription.js";
-import { WhiteToBlackboardActionDescription } from "./WhiteToBlackboardActionDescription.js";
+import { WriteToBlackboardActionDescription } from "./WriteToBlackboardActionDescription.js";
 
 const type_map = {
     Sequence({ elements }) {
@@ -59,7 +59,7 @@ registerType(SpeakLineActionDescription);
 registerType(SendRequestActionDescription);
 registerType(DelayActionDescription);
 registerType(NoopActionDescription);
-registerType(WhiteToBlackboardActionDescription);
+registerType(WriteToBlackboardActionDescription);
 
 /**
  *

package/src/engine/ecs/guid/GUIDSerializationAdapter.spec.js

@@ -0,0 +1,21 @@
+import { GUID } from "./GUID.js";
+import { GUIDSerializationAdapter } from "./GUIDSerializationAdapter.js";
+import { BinaryBuffer } from "../../../core/binary/BinaryBuffer.js";
+
+test("to/from consistency", () => {
+
+    const source = GUID.parse("a88bb73a-c89f-11ed-afa1-0242ac120002");
+
+    const adapter = new GUIDSerializationAdapter();
+
+    const buffer = new BinaryBuffer();
+
+    adapter.serialize(buffer, source);
+    buffer.position = 0; // rewind
+
+    const destination = new GUID();
+
+    adapter.deserialize(buffer, destination);
+
+    expect(destination.equals(source)).toBe(true);
+});

package/src/engine/ecs/parent/EntityNode.js

@@ -98,7 +98,7 @@ export class EntityNode {
 
     /**
      *
-     * @param {(node:EntityNode)=>*} visitor
+     * @param {function(node:EntityNode):*} visitor
      * @param {*} [thisArg]
      */
     traverse(visitor, thisArg) {

package/src/engine/ecs/parent/EntityNode.spec.js

@@ -0,0 +1,104 @@
+import { EntityNode } from "./EntityNode.js";
+import { EntityComponentDataset } from "../EntityComponentDataset.js";
+
+test("constructor does not throw", () => {
+    new EntityNode()
+});
+
+test("setFlag", () => {
+    const ut = new EntityNode();
+
+    ut.setFlag(0b101);
+
+    expect(ut.flags).toBe(5);
+
+    ut.setFlag(0b010);
+
+    expect(ut.flags).toBe(7);
+
+    ut.setFlag(0b1);
+
+    expect(ut.flags).toBe(7);
+});
+
+test("clearFlag", () => {
+    const ut = new EntityNode();
+    ut.flags = 0b101;
+
+    ut.clearFlag(0b1);
+
+    expect(ut.flags).toBe(4);
+
+    ut.clearFlag(0b10);
+
+    expect(ut.flags).toBe(4);
+
+    ut.clearFlag(0b100);
+
+    expect(ut.flags).toBe(0);
+});
+
+test("getFlag", () => {
+
+    const ut = new EntityNode();
+
+    ut.flags = 0b101;
+
+    expect(ut.getFlag(0b1)).toBe(true);
+    expect(ut.getFlag(0b10)).toBe(false);
+    expect(ut.getFlag(0b100)).toBe(true);
+    expect(ut.getFlag(0b1000)).toBe(false);
+    expect(ut.getFlag(0b101)).toBe(true);
+    expect(ut.getFlag(0b011)).toBe(false);
+});
+
+test("writeFlag", () => {
+    const ut = new EntityNode();
+
+    ut.writeFlag(0b101, true);
+    expect(ut.flags).toBe(5);
+
+    ut.writeFlag(0b100, false);
+
+    expect(ut.flags).toBe(1);
+});
+
+test("traverse without children", () => {
+    const node = new EntityNode();
+
+    const visited = [];
+
+    node.traverse(Array.prototype.push, visited);
+
+    expect(visited.length).toBe(1);
+    expect(visited).toContain(node);
+});
+
+test("build empty", () => {
+    const node = new EntityNode();
+
+    const dataset = new EntityComponentDataset();
+
+    node.build(dataset);
+
+    expect(node.isBuilt).toBe(true);
+    expect(node.entity.isBuilt).toBe(true);
+    expect(dataset.entityExists(node.entity.entity)).toBe(true);
+});
+
+test("destroy empty", () => {
+    const node = new EntityNode();
+
+    const dataset = new EntityComponentDataset();
+
+    node.build(dataset);
+
+    const entity = node.entity.entity;
+
+    node.destroy();
+
+    expect(node.isBuilt).toBe(false);
+    expect(node.entity.isBuilt).toBe(false);
+    expect(dataset.entityExists(entity)).toBe(false);
+
+});

package/src/engine/ecs/speaker/Voice.js

@@ -55,4 +55,8 @@ export class Voice {
  */
 Voice.serializable = false;
 
+/**
+ * @readonly
+ * @type {string}
+ */
 Voice.typeName = 'Voice';