@woosh/meep-engine 3.58.0 → 3.60.0

package/editor/view/particles/effect/ParticleNodeParametersView.js

@@ -17,16 +17,17 @@ import { ParticleGradientEditorView } from "./ParticleGradientEditorView.js";
  *
  * This is what the node-graph base's `parameterViewFactory` seam exists for. A particle node's
  * parameters are name-keyed and hold vectors, ISA enum members, swizzle patterns and references to
- * the effect's own attributes — none of which the generic number/string/boolean mechanism can
- * describe. The schema in `particle_node_parameters.js` says what each one is; this turns that into
- * a control, and commits through the callback the base supplies, so every edit lands on the
+ * the effect's own particle, emitter and global fields — none of which the generic
+ * number/string/boolean mechanism can describe. The schema in `particle_node_parameters.js` says
+ * what each one is; this turns that into a control, and commits through the callback the base
+ * supplies, so every edit lands on the
  * editor's action timeline exactly as a built-in control's would.
  *
  * Two things flow the other way, and both matter:
  *
  * - a parameter changed on the node — an undo, most of all — is written back into the control,
- * - the effect's attribute list changing rebuilds the attribute pickers, so a node's choices are
- *   the attributes the effect has now rather than the ones it had when the node was drawn.
+ * - the effect's field declarations changing rebuilds the field pickers, so a node's choices are
+ *   the fields the effect has now rather than the ones it had when the node was drawn.
  *
  * A swizzle is spelled the way the assembly spells it (`xyzw`), so the two layers of the editor
  * name the same thing the same way.
@@ -45,7 +46,8 @@ export class ParticleNodeParametersView extends View {
     /**
      * @param {object} options
      * @param {import("../../../particles/effect/ParticleEffectDocument.js").ParticleEffectDocument} options.effect
-     *        the effect document being edited; read for the attribute list, and watched for changes to it
+     *        the effect document being edited; read for its field declarations, and watched for
+     *        changes to them
      * @param {NodeInstance} options.node
      * @param {function(string, *)} options.commit called with a parameter name and its new value
      */
@@ -123,18 +125,46 @@ export class ParticleNodeParametersView extends View {
                 );
                 break;
 
-            case PARTICLE_PARAMETER_KIND.ATTRIBUTE:
+            case PARTICLE_PARAMETER_KIND.PARTICLE_FIELD:
                 control = this.#buildSelectControl(
                     parameter,
-                    () => effect.attributes.map(attribute => ({
-                        label: `${attribute.name} (${attribute.components})`,
-                        value: attribute.name,
+                    () => effect.particle_fields.map(particle_field => ({
+                        label: `${particle_field.name} (${particle_field.components})`,
+                        value: particle_field.name,
+                    })),
+                    value,
+                    write
+                );
+
+                // the effect's declarations are the choices, so they are re-read when it changes
+                row.bindSignal(effect.on.changed, () => control.refresh());
+                break;
+
+            case PARTICLE_PARAMETER_KIND.GLOBAL_FIELD:
+                control = this.#buildSelectControl(
+                    parameter,
+                    () => effect.global_fields.map(field => ({
+                        label: `${field.name} (${field.components})`,
+                        value: field.name,
+                    })),
+                    value,
+                    write
+                );
+
+                row.bindSignal(effect.on.changed, () => control.refresh());
+                break;
+
+            case PARTICLE_PARAMETER_KIND.EMITTER_FIELD:
+                control = this.#buildSelectControl(
+                    parameter,
+                    () => effect.emitter_fields.map(field => ({
+                        label: `${field.name} (${field.components})`,
+                        value: field.name,
                     })),
                     value,
                     write
                 );
 
-                // the effect's attributes are the choices, so they are re-read when they change
                 row.bindSignal(effect.on.changed, () => control.refresh());
                 break;
 
@@ -427,7 +457,7 @@ export class ParticleNodeParametersView extends View {
             }
 
             if (index === -1) {
-                // A value with no option — an attribute that has been deleted, or a file from a
+                // A value with no option — a particle field that has been deleted, or a file from a
                 // build with more enum members. Shown as itself rather than silently snapped to
                 // something else, because snapping would edit the author's effect behind their back.
                 const orphan = document.createElement('option');
@@ -475,10 +505,10 @@ export class ParticleNodeParametersView extends View {
         return {
             view: new EmptyView({ el: select }),
             write: push,
-            refresh
-        };
-    }
-}
+            refresh
+        };
+    }
+}
 
 /**
  * A control that is a view of its own, in the shape the rest of this file uses.

package/editor/view/particles/effect/ParticlePreviewView.js

@@ -151,7 +151,7 @@ export class ParticlePreviewView extends View {
 
         this.#effect_version = this.effect.version;
 
-        const { program, layout } = this.effect.compile();
+        const { program, layout, emitter_fields, global_layout, global_fields } = this.effect.compile();
 
         if (program === null) {
             this.#stale = true;
@@ -160,7 +160,7 @@ export class ParticlePreviewView extends View {
 
         this.#stale = false;
 
-        this.simulation.setEffect({ program, layout, emitter: this.effect.emitter });
+        this.simulation.setEffect({ program, layout, emitter: this.effect.emitter, emitter_fields, global_layout, global_fields });
     }
 
     /**

package/editor/view/particles/effect/particle-editor.css

@@ -213,9 +213,9 @@
 /*
  The ramp controls — a gradient's strip and a curve's plot.
 
- Both controls use the width of the node. The canvases scale with the row rather than holding
- their drawn size: the graph is zoomable, and a control that stayed 240 pixels while everything
- around it grew would be the one thing on the node that could not be read.
+ Both controls use the width of the node. The canvases scale with the row rather than holding
+ their drawn size: the graph is zoomable, and a control that stayed 240 pixels while everything
+ around it grew would be the one thing on the node that could not be read.
 */
 
 .ui-particle-node-parameters .parameter-row.kind-gradient,
@@ -225,13 +225,13 @@
     gap: 3px;
 }
 
-.ui-particle-gradient,
-.ui-particle-curve {
-    display: flex;
-    flex-direction: column;
-    gap: 5px;
-    width: 240px;
-    max-width: 100%;
+.ui-particle-gradient,
+.ui-particle-curve {
+    display: flex;
+    flex-direction: column;
+    gap: 5px;
+    width: 240px;
+    max-width: 100%;
 }
 
 .ui-particle-gradient > .strip,
@@ -239,10 +239,10 @@
     display: block;
     width: 100%;
     height: auto;
-    /* An inset border keeps the canvas's drawing and pointer coordinate spaces identical. */
-    border: 0;
-    padding: 0;
-    box-shadow: inset 0 0 0 1px var(--meep-graph-node-border, #363c46);
+    /* An inset border keeps the canvas's drawing and pointer coordinate spaces identical. */
+    border: 0;
+    padding: 0;
+    box-shadow: inset 0 0 0 1px var(--meep-graph-node-border, #363c46);
     border-radius: 3px;
     background: var(--meep-graph-input-bg, #171b21);
     /* the strip and the plot are both dragged in, and a drag that selects text is a drag that fights */
@@ -252,56 +252,56 @@
 
 .ui-particle-gradient > .stop-fields,
 .ui-particle-curve > .key-fields {
-    display: grid;
-    gap: 5px;
-    align-items: end;
-}
-
-.ui-particle-gradient > .stop-fields {
-    grid-template-columns: minmax(0, 0.8fr) minmax(0, 1fr) minmax(0, 1.4fr) auto;
-}
-
-.ui-particle-gradient > .stop-fields:has(.field-alpha[hidden]) {
-    grid-template-columns: minmax(0, 1fr) minmax(0, 1.4fr) auto;
-}
-
-.ui-particle-curve > .key-fields {
-    grid-template-columns: repeat(2, minmax(0, 1fr));
-}
-
-.ramp-field {
-    display: flex;
-    flex-direction: column;
-    gap: 2px;
-    min-width: 0;
-    color: var(--meep-fg-muted, #9da0a3);
-    font-size: 10px;
-}
-
-.ramp-field[hidden] {
-    display: none;
-}
-
-.ramp-field > input,
-.ramp-field > select {
-    width: 100%;
-    min-width: 0;
-}
-
-.ui-particle-gradient .swatch {
-    height: 23px;
-    padding: 0;
-}
-
-.ui-particle-gradient > .strip:focus-visible,
-.ui-particle-curve > .plot:focus-visible {
-    outline: 1px solid var(--meep-accent, #2d7dd2);
+    display: grid;
+    gap: 5px;
+    align-items: end;
+}
+
+.ui-particle-gradient > .stop-fields {
+    grid-template-columns: minmax(0, 0.8fr) minmax(0, 1fr) minmax(0, 1.4fr) auto;
+}
+
+.ui-particle-gradient > .stop-fields:has(.field-alpha[hidden]) {
+    grid-template-columns: minmax(0, 1fr) minmax(0, 1.4fr) auto;
+}
+
+.ui-particle-curve > .key-fields {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+}
+
+.ramp-field {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+    min-width: 0;
+    color: var(--meep-fg-muted, #9da0a3);
+    font-size: 10px;
+}
+
+.ramp-field[hidden] {
+    display: none;
+}
+
+.ramp-field > input,
+.ramp-field > select {
+    width: 100%;
+    min-width: 0;
+}
+
+.ui-particle-gradient .swatch {
+    height: 23px;
+    padding: 0;
+}
+
+.ui-particle-gradient > .strip:focus-visible,
+.ui-particle-curve > .plot:focus-visible {
+    outline: 1px solid var(--meep-accent, #2d7dd2);
 }
 
 .ui-particle-gradient .remove,
 .ui-particle-curve .remove {
-    flex: 0 0 auto;
-    justify-self: end;
+    flex: 0 0 auto;
+    justify-self: end;
     width: 1.8em;
     padding: 2px 0;
     border: 1px solid var(--meep-graph-node-border, #363c46);
@@ -481,7 +481,7 @@
 }
 
 /*
- A render channel bound to an attribute narrower than the pass reads. Not an error — the offsets are
+ A render channel bound to a particle field narrower than the pass reads. Not an error — the offsets are
  the record's, and an author who knows what is packed after it may mean it — so it is marked rather
  than refused, with the reason on the row's tooltip.
 */
@@ -493,35 +493,37 @@
     content: " ⚠";
 }
 
-.ui-particle-emitter-inspector .attribute {
+.ui-particle-emitter-inspector .particle-field {
     display: flex;
     align-items: center;
     gap: 8px;
     padding: 2px 10px;
 }
 
-.ui-particle-emitter-inspector .attribute > .name {
+.ui-particle-emitter-inspector .particle-field > .name {
     flex: 1 1 auto;
     font-family: ui-monospace, SFMono-Regular, Consolas, monospace;
     font-size: 11.5px;
 }
 
-.ui-particle-emitter-inspector .attribute > .where {
+.ui-particle-emitter-inspector .particle-field > .where {
     color: var(--meep-fg-muted, #6d7278);
     font-family: ui-monospace, SFMono-Regular, Consolas, monospace;
     font-size: 10.5px;
 }
 
-.ui-particle-emitter-inspector .attribute > .remove {
+.ui-particle-emitter-inspector .particle-field > .remove {
     color: var(--meep-fg-muted, #6d7278);
     cursor: pointer;
 }
 
-.ui-particle-emitter-inspector .attribute > .remove:hover {
+.ui-particle-emitter-inspector .particle-field > .remove:hover {
     color: var(--meep-error, #ff7a7a);
 }
 
-.ui-particle-emitter-inspector .add-attribute {
+.ui-particle-emitter-inspector .add-particle-field,
+.ui-particle-emitter-inspector .add-emitter-field,
+.ui-particle-emitter-inspector .add-global-field {
     display: flex;
     flex-wrap: wrap;
     align-items: center;
@@ -529,10 +531,17 @@
     padding: 6px 10px 0;
 }
 
-.ui-particle-emitter-inspector .add-attribute input[type="text"] {
+.ui-particle-emitter-inspector .add-particle-field input[type="text"],
+.ui-particle-emitter-inspector .add-emitter-field input[type="text"],
+.ui-particle-emitter-inspector .add-global-field input[type="text"] {
     flex: 1 1 6em;
 }
 
+/* an emitter or global field's value, one input per component */
+.ui-particle-emitter-inspector .particle-field > input.lane {
+    width: 3.6em;
+}
+
 .ui-particle-emitter-inspector .problem {
     flex-basis: 100%;
     padding: 2px 0;

package/package.json

@@ -6,7 +6,7 @@
   "description": "Advanced 3D game engine",
   "type": "module",
   "author": "Alexander Goldring",
-  "version": "3.58.0",
+  "version": "3.60.0",
   "exports": {
     "./build/*": "./build/*",
     "./src/*": "./src/*",

package/src/engine/Engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Engine.d.ts","sourceRoot":"","sources":["../../../src/engine/Engine.js"],"names":[],"mappings":";6BAqCa,OAAO,8BAA8B,EAAE,cAAc;AAwClE;IA4FI;;;;;;;;;OASG;IACH,sBARW,cAAc;QAEU,aAAa,GAArC,aAAa;QACK,cAAc,GAAhC,OAAO;QACW,WAAW,GAA7B,OAAO;QACW,KAAK,GAAvB,OAAO;OAiPjB;IAtSD;;;OAGG;IACH,UAFU,cAAc,GAAC,IAAI,CAEb;IAEhB;;;OAGG;IACH,OAFU,WAAW,GAAC,IAAI,CAEb;IAEb,qBAA4B;IAE5B;;;;;;;;;OASG;IACH,0BAFU,uBAAuB,CAEe;IAEhD;;;OAGG;IACH,kBAFU,mBAAmB,CAEO;IAEpC;;;;OAIG;IACH,iBAFU,MAAM,CAEM;IAEtB;;;;OAIG;IACH,mBAFU,kBAAkB,CAEa;IAoBrC;;;OAGG;IACH,UAFU,cAAc,CAEA;IAKxB;;;OAGG;IACH,aAFU,gBAAgB,CAEe;IAGzC,yCAAkE;IAK9D,6BAAkC;IAMtC;;;OAGG;IACH,cAFU,aAAa,MAAM,CAAC,CAK5B;IAEF,8CAiCE;IAgCF;;;OAGG;IACH,SAFU,WAAW,CAEoB;IAEzC;;;OAGG;IACH,oCAA0C;IAE1C;;;OAGG;IACH,sCAFU,2BAA2B,CAE+B;IAEpE,yBAAoC;IAGpC;;OAEG;IACH,aAAkB;IAElB;;;OAGG;IACH,SAFU,OAAO,CAEwB;IAGzC,2BAAsC;IAuCtC;;;OAGG;IACH,KAFU,SAAS,CAEO;IAE1B;;;OAGG;IACH,uBAFU,YAAY,CAEqD;IAI3E;;;;;MAKC;IA8BD;;;OAGG;IACH,kBAFU,OAAO,CAEW;IA6IhC,wBAgCC;IApBG,oBAAwB;IAsB5B,2BA8CC;IAED,oBAiBC;IAED;;;OAGG;IACH,+CAUC;IAED,eAkDC;IAED;;;OAGG;IACH,sBA0GC;IAoBD;;OAEG;IACH,sBA+DC;IAED,aAEC;IAED;;OAEG;IACH,4BAOC;IAIL;;;OAGG;IACH,mBAFU,OAAO,CAEQ;;CAPxB;+BAn5B8B,+BAA+B;wBAWtC,wBAAwB;0BArBtB,0CAA0C;wCAeN,iDAAiD;oCAG3E,iCAAiC;mBAElD,wBAAwB;+BAtBZ,gDAAgD;iCAO9C,+CAA+C;8BAGlD,wBAAwB;6BALzB,yBAAyB;uCAIf,6DAA6D;4BAUxE,0BAA0B;+BArBvB,iCAAiC;4CAapB,qDAAqD;AAgBjG;;GAEG;AAGH;IACI,gDAA2D;IAC3D,0BAAkC;IAClC,iCAAyC;CAC5C;6BAvC4B,sCAAsC;sBA4B7C,mBAAmB;yBAJhB,yBAAyB;8BALpB,kCAAkC;2BADrC,mCAAmC;8BAFhC,kCAAkC;8BAClC,kCAAkC;sBAb1C,+BAA+B;+BAKtB,qCAAqC;4BAPxC,kCAAkC;oBAH1C,yBAAyB"}
+{"version":3,"file":"Engine.d.ts","sourceRoot":"","sources":["../../../src/engine/Engine.js"],"names":[],"mappings":";6BAsCa,OAAO,8BAA8B,EAAE,cAAc;AAwClE;IA2FI;;;;;;;;;OASG;IACH,sBARW,cAAc;QAEU,aAAa,GAArC,aAAa;QACK,cAAc,GAAhC,OAAO;QACW,WAAW,GAA7B,OAAO;QACW,KAAK,GAAvB,OAAO;OAiPjB;IAtSD;;;OAGG;IACH,UAFU,cAAc,GAAC,IAAI,CAEb;IAEhB;;;OAGG;IACH,OAFU,WAAW,GAAC,IAAI,CAEb;IAEb,qBAA4B;IAE5B;;;;;;;;;OASG;IACH,0BAFU,uBAAuB,CAEe;IAEhD;;;OAGG;IACH,kBAFU,mBAAmB,CAEO;IAEpC;;;;OAIG;IACH,iBAFU,MAAM,CAEM;IAEtB;;;;OAIG;IACH,mBAFU,kBAAkB,CAEa;IAoBrC;;;OAGG;IACH,UAFU,cAAc,CAEA;IAKxB;;;OAGG;IACH,aAFU,gBAAgB,CAEe;IAGzC,yCAAkE;IAK9D,6BAAkC;IAMtC;;;OAGG;IACH,cAFU,aAAa,MAAM,CAAC,CAK5B;IAEF,8CAiCE;IAgCF;;;OAGG;IACH,SAFU,WAAW,CAEoB;IAEzC;;;OAGG;IACH,oCAA0C;IAE1C;;;OAGG;IACH,sCAFU,2BAA2B,CAE+B;IAEpE,yBAAoC;IAGpC;;OAEG;IACH,aAAkB;IAElB;;;OAGG;IACH,SAFU,OAAO,CAEwB;IAGzC,2BAAsC;IAuCtC;;;OAGG;IACH,KAFU,SAAS,CAEO;IAE1B;;;OAGG;IACH,uBAFU,YAAY,CAEqD;IAI3E;;;;;MAKC;IA8BD;;;OAGG;IACH,kBAFU,OAAO,CAEW;IA6IhC,wBAgCC;IApBG,oBAAwB;IAsB5B,2BA8CC;IAED,oBAiBC;IAED;;;OAGG;IACH,+CAUC;IAED,eAkDC;IAED;;;OAGG;IACH,sBA0GC;IAoBD;;OAEG;IACH,sBA+DC;IAED,aAEC;IAED;;OAEG;IACH,4BAOC;IAIL;;;OAGG;IACH,mBAFU,OAAO,CAEQ;;CAPxB;+BAl5B8B,+BAA+B;wBAWtC,wBAAwB;0BArBtB,0CAA0C;wCAeN,iDAAiD;oCAG3E,iCAAiC;mBAElD,wBAAwB;+BAtBZ,gDAAgD;iCAO9C,+CAA+C;8BAGlD,wBAAwB;6BALzB,yBAAyB;uCAIf,6DAA6D;4BAUxE,0BAA0B;+BArBvB,iCAAiC;4CAapB,qDAAqD;AAgBjG;;GAEG;AAGH;IACI,gDAA2D;IAC3D,0BAAkC;IAClC,iCAAyC;CAC5C;6BAvC4B,sCAAsC;sBA4B7C,mBAAmB;yBAJhB,yBAAyB;8BANpB,kCAAkC;2BADrC,mCAAmC;8BADhC,kCAAkC;8BAGlC,kCAAkC;sBAf1C,+BAA+B;+BAKtB,qCAAqC;4BAPxC,kCAAkC;oBAH1C,yBAAyB"}

package/src/engine/Engine.js

@@ -3,6 +3,7 @@
  */
 
 import { assert } from "../core/assert.js";
+import Signal from "../core/events/signal/Signal.js";
 import Vector1 from "../core/geom/Vector1.js";
 import { Localization } from "../core/localization/Localization.js";
 import { ModuleRegistry } from "../core/model/ModuleRegistry.js";
@@ -21,9 +22,9 @@ import { EntityManager } from "./ecs/EntityManager.js";
 import { BinarySerializationRegistry } from "./ecs/storage/binary/BinarySerializationRegistry.js";
 import { GraphicsEngine } from './graphics3/GraphicsEngine.js';
 import { GamepadDevice } from "./input/devices/GamepadDevice.js";
-import { XRInputDevice } from "./input/devices/XRInputDevice.js";
 import KeyboardDevice from "./input/devices/KeyboardDevice.js";
 import { PointerDevice } from "./input/devices/PointerDevice.js";
+import { XRInputDevice } from "./input/devices/XRInputDevice.js";
 import { StaticKnowledgeDatabase, StaticKnowledgeState } from "./knowledge/database/StaticKnowledgeDatabase.js";
 import { logger } from "./logging/GlobalLogger.js";
 import { OptionGroup } from "./options/OptionGroup.js";
@@ -86,7 +87,6 @@ class Engine {
      */
     #last_render_simulation_time = 0;
 
-
     /**
      * Handle of the pending "pause the simulation, this outage is taking a while" timer, `-1` when none
      * @type {number}

package/src/engine/ecs/EntityManager.d.ts

@@ -62,13 +62,38 @@ export class EntityManager {
      * @readonly
      */
     readonly on: {
-        systemStarted: Signal;
-        systemStopped: Signal;
         /**
+         * @readonly
          * @type {Signal<System>}
          */
-        systemAdded: any;
-        systemRemoved: Signal;
+        readonly systemStarted: any;
+        /**
+         * @readonly
+         * @type {Signal<System>}
+         */
+        readonly systemStopped: any;
+        /**
+         * @readonly
+         * @type {Signal<System>}
+         */
+        readonly systemAdded: any;
+        /**
+         * @readonly
+         * @type {Signal<System>}
+         */
+        readonly systemRemoved: any;
+        /**
+         * Dispatched at the start of {@link update}
+         * @readonly
+         * @type {Signal<number>}
+         */
+        readonly beforeUpdate: any;
+        /**
+         * Dispatched at the end of {@link update}
+         * @readonly
+         * @type {Signal<number>}
+         */
+        readonly afterUpdate: any;
     };
     /**
      *
@@ -291,7 +316,6 @@ export class EntityManager {
 }
 export type Class<T = any> = import("../../core/primitives/Class.js").Class<T>;
 import { System } from "./System.js";
-import Signal from "../../core/events/signal/Signal.js";
 import { EntityComponentDataset } from "./EntityComponentDataset.js";
 import { SystemState } from "./System.js";
 //# sourceMappingURL=EntityManager.d.ts.map

package/src/engine/ecs/EntityManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityManager.js"],"names":[],"mappings":"iCAsBU,MAAM;;;;;;;;;AAoBhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IAEI;;;;OAIG;IACH,kBAFU,aAAQ,CAEL;IAEb;;;;;;OAMG;IACH,uCAA2B;IAE3B;;;;;OAKG;IACH,iCAA4B;IAE5B;;OAEG;IACH;;;QAGI;;WAEG;;;MAGL;IAEF;;;OAGG;IACH,OAFU,kBAAkB,CAEO;IAEnC;;;;;;;;;OASG;IACH,qBAFU,MAAM,CAEY;IAE5B;;;;;;;;OAQG;IACH,wCAFU,MAAM,CAE4B;IAE5C;;;;;;;;OAQG;IACH,eAFU,MAAM,CAEE;IAElB;;;;;OAKG;IACH,+BAA2B;IAE3B;;;;;;;;;;;;;;OAcG;IACH,oBAFU,MAAM,CAEO;IAEvB;;;;OAIG;IACH,SAFU,sBAAsB,CAEjB;IA8Bf;;;;;OAKG;IACH,uCAAsC;IAEtC;;;;;;;;;;;OAWG;IACH,6BAkGC;IAED;;;;OAIG;IACH,4BAHW;QAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;KAAC,QAavD;IAED;;;OAGG;IACH,8BAHW;QAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;KAAC,GAC3C,OAAO,CAYnB;IAoBD;;;OAGG;IACH,uBAFa,KAAK,EAAE,CAuBnB;IAED;;;;;OAKG;IACH,uBAJW,sBAAsB,QA4ChC;IAGD;;;OAGG;IACH,sBA2BC;IAED;;;;OAIG;IACH,qCAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,6CAgBC;IAED;;;;;OAKG;IACH,wCAHW,MAAM,cAkBhB;IAGD;;;OAGG;IACH,2BAFW,MAAM,QA6HhB;IAED;;;;;;;;;OASG;IACH,qBAFa,MAAM,CAKlB;IAED;;;;;OAKG;IACH,6CA6DC;IAED;;;;OAIG;IACH,mCAFa,QAAQ,OAAO,CAAC,CA2C5B;IAED;;;;;OAKG;IACH,mBAsDC;IAED;;;;;OAKG;IACH,oBA4FC;IAED;;;;;OAKG;IACH,kEA4EC;IAED;;;;OAIG;IACH,2BAHW,KAAK,GACH,oBAAgB,CA0B5B;IAED;;;;OAIG;IACH,kCAJW,KAAK,SACL,WAAW,GACT,oBAAgB,CA0B5B;IAED;;;;;OAKG;IACH,mEAmEC;IAGL;;OAEG;IACH,yBAhxBe,sBAAsB,UAgxBA;IACrC;;OAEG;IACH,0BAAqC;IAErC;;OAEG;IACH,+BA/oBe,MAAM,UA+oBW;;CAd/B;6BAppCY,OAAO,gCAAgC,EAAE,KAAK,CAAC,CAAC,CAAC;uBAP1B,aAAa;mBAR9B,oCAAoC;uCAMhB,6BAA6B;4BAEhC,aAAa"}
+{"version":3,"file":"EntityManager.d.ts","sourceRoot":"","sources":["../../../../src/engine/ecs/EntityManager.js"],"names":[],"mappings":"iCAsBU,MAAM;;;;;;;;;AAoBhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IAEI;;;;OAIG;IACH,kBAFU,aAAQ,CAEL;IAEb;;;;;;OAMG;IACH,uCAA2B;IAE3B;;;;;OAKG;IACH,iCAA4B;IAE5B;;OAEG;IACH;QACI;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;;WAIG;;QAGH;;;;WAIG;;MAEL;IAEF;;;OAGG;IACH,OAFU,kBAAkB,CAEO;IAEnC;;;;;;;;;OASG;IACH,qBAFU,MAAM,CAEY;IAE5B;;;;;;;;OAQG;IACH,wCAFU,MAAM,CAE4B;IAE5C;;;;;;;;OAQG;IACH,eAFU,MAAM,CAEE;IAElB;;;;;OAKG;IACH,+BAA2B;IAE3B;;;;;;;;;;;;;;OAcG;IACH,oBAFU,MAAM,CAEO;IAEvB;;;;OAIG;IACH,SAFU,sBAAsB,CAEjB;IA8Bf;;;;;OAKG;IACH,uCAAsC;IAEtC;;;;;;;;;;;OAWG;IACH,6BAkGC;IAED;;;;OAIG;IACH,4BAHW;QAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;KAAC,QAavD;IAED;;;OAGG;IACH,8BAHW;QAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAA;KAAC,GAC3C,OAAO,CAYnB;IAoBD;;;OAGG;IACH,uBAFa,KAAK,EAAE,CAuBnB;IAED;;;;;OAKG;IACH,uBAJW,sBAAsB,QA4ChC;IAGD;;;OAGG;IACH,sBA2BC;IAED;;;;OAIG;IACH,qCAFa,OAAO,CAInB;IAED;;;;OAIG;IACH,6CAgBC;IAED;;;;;OAKG;IACH,wCAHW,MAAM,cAkBhB;IAGD;;;OAGG;IACH,2BAFW,MAAM,QAmIhB;IAED;;;;;;;;;OASG;IACH,qBAFa,MAAM,CAKlB;IAED;;;;;OAKG;IACH,6CA6DC;IAED;;;;OAIG;IACH,mCAFa,QAAQ,OAAO,CAAC,CA2C5B;IAED;;;;;OAKG;IACH,mBAsDC;IAED;;;;;OAKG;IACH,oBA4FC;IAED;;;;;OAKG;IACH,kEA4EC;IAED;;;;OAIG;IACH,2BAHW,KAAK,GACH,oBAAgB,CA0B5B;IAED;;;;OAIG;IACH,kCAJW,KAAK,SACL,WAAW,GACT,oBAAgB,CA0B5B;IAED;;;;;OAKG;IACH,mEAmEC;IAGL;;OAEG;IACH,yBAtxBe,sBAAsB,UAsxBA;IACrC;;OAEG;IACH,0BAAqC;IAErC;;OAEG;IACH,+BArpBe,MAAM,UAqpBW;;CAd/B;6BAxrCY,OAAO,gCAAgC,EAAE,KAAK,CAAC,CAAC,CAAC;uBAP1B,aAAa;uCAFV,6BAA6B;4BAEhC,aAAa"}

package/src/engine/ecs/EntityManager.js

@@ -99,13 +99,43 @@ export class EntityManager {
      * @readonly
      */
     on = {
+        /**
+         * @readonly
+         * @type {Signal<System>}
+         */
         systemStarted: new Signal(),
+
+        /**
+         * @readonly
+         * @type {Signal<System>}
+         */
         systemStopped: new Signal(),
+
         /**
+         * @readonly
          * @type {Signal<System>}
          */
         systemAdded: new Signal(),
+
+        /**
+         * @readonly
+         * @type {Signal<System>}
+         */
         systemRemoved: new Signal(),
+
+        /**
+         * Dispatched at the start of {@link update}
+         * @readonly
+         * @type {Signal<number>}
+         */
+        beforeUpdate: new Signal(),
+
+        /**
+         * Dispatched at the end of {@link update}
+         * @readonly
+         * @type {Signal<number>}
+         */
+        afterUpdate: new Signal(),
     };
 
     /**
@@ -554,8 +584,11 @@ export class EntityManager {
         assert.greaterThanOrEqual(time_delta_seconds, 0, 'time_delta_seconds must be >= 0');
         assert.isFinite(time_delta_seconds, 'timeDelta');
 
+        this.on.beforeUpdate.send1(time_delta_seconds);
+
         if (this.dataset === null) {
             // dataset is not attached
+            this.on.afterUpdate.send1(time_delta_seconds);
             return;
         }
 
@@ -671,6 +704,9 @@ export class EntityManager {
                 }
             }
         }
+
+
+        this.on.afterUpdate.send1(time_delta_seconds);
     }
 
     /**
@@ -898,7 +934,7 @@ export class EntityManager {
         function systemReady() {
             system.state.set(SystemState.RUNNING);
 
-            self.on.systemStarted.dispatch(system);
+            self.on.systemStarted.send1(system);
 
             const i = self.systems.indexOf(system);
 

package/src/engine/ecs/storage/populateEngineSerializationRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"populateEngineSerializationRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/storage/populateEngineSerializationRegistry.js"],"names":[],"mappings":"AAuMA;;;;;;;;GAQG;AACH,iGAyHC"}
+{"version":3,"file":"populateEngineSerializationRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/engine/ecs/storage/populateEngineSerializationRegistry.js"],"names":[],"mappings":"AA0MA;;;;;;;;GAQG;AACH,iGA0HC"}

package/src/engine/ecs/storage/populateEngineSerializationRegistry.js

@@ -55,6 +55,9 @@ import {
 import {
     ParticleEffectSerializationUpgrader_1_2
 } from "../../graphics/ecs/particles/ParticleEffectSerializationUpgrader_1_2.js";
+import {
+    ParticleEffectSerializationUpgrader_2_3
+} from "../../graphics/ecs/particles/ParticleEffectSerializationUpgrader_2_3.js";
 import { TransformSerializationAdapter } from "../transform/TransformSerializationAdapter.js";
 import { TransformSerializationUpgrader_0_1 } from "../transform/TransformSerializationUpgrader_0_1.js";
 import {
@@ -299,6 +302,7 @@ export function populateEngineSerializationRegistry(registry) {
     registry.registerUpgrader(Path.typeName, new PathSerializationUpgrader_2_3());
 
     registry.registerUpgrader(ParticleEffect.typeName, new ParticleEffectSerializationUpgrader_1_2());
+    registry.registerUpgrader(ParticleEffect.typeName, new ParticleEffectSerializationUpgrader_2_3());
 
     registry.registerUpgrader(PathFollower.typeName, new PathFollowerSerializationUpgrader_0_1());
     registry.registerUpgrader(PathFollower.typeName, new PathFollowerSerializationUpgrader_1_2());