@woosh/meep-engine 3.17.1 → 3.18.0

package/editor/actions/concrete/ComponentAddAction.d.ts

@@ -8,6 +8,7 @@ declare class ComponentAddAction extends Action<any> {
     dataset: EntityComponentDataset;
     entity: any;
     component: any;
+    collectWrites(editor: any, writes: any): void;
     apply(editor: any): Promise<void>;
     revert(editor: any): Promise<void>;
 }

package/editor/actions/concrete/ComponentAddAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentAddAction.d.ts","sourceRoot":"","sources":["../../../../editor/actions/concrete/ComponentAddAction.js"],"names":[],"mappings":";AAEA;IAOI,yCAIC;IAVD;;;OAGG;IACH,gCAAe;IAIX,YAAoB;IACpB,eAA0B;IAG9B,kCAqBC;IAED,mCAGC;CACJ;uBA1CsB,0CAA0C"}
+{"version":3,"file":"ComponentAddAction.d.ts","sourceRoot":"","sources":["../../../../editor/actions/concrete/ComponentAddAction.js"],"names":[],"mappings":";AAEA;IAOI,yCAIC;IAVD;;;OAGG;IACH,gCAAe;IAIX,YAAoB;IACpB,eAA0B;IAG9B,8CAEC;IAED,kCAqBC;IAED,mCAGC;CACJ;uBA9CsB,0CAA0C"}

package/editor/actions/concrete/ComponentAddAction.js

@@ -13,6 +13,10 @@ class ComponentAddAction extends Action {
         this.component = component;
     }
 
+    collectWrites(editor, writes) {
+        writes.component(this.entity, this.component.constructor);
+    }
+
     async apply(editor) {
         /**
          * @type {EntityManager}

package/editor/actions/concrete/ComponentRemoveAction.d.ts

@@ -4,6 +4,7 @@ declare class ComponentRemoveAction extends Action<any> {
     component: any;
     entity: any;
     componentType: any;
+    collectWrites(editor: any, writes: any): void;
     apply(editor: any): Promise<void>;
     revert(editor: any): Promise<void>;
 }

package/editor/actions/concrete/ComponentRemoveAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComponentRemoveAction.d.ts","sourceRoot":"","sources":["../../../../editor/actions/concrete/ComponentRemoveAction.js"],"names":[],"mappings":";AAEA;IAGI,6CAKC;IAPD,eAAiB;IAKb,YAAoB;IACpB,mBAAkC;IAGtC,kCAUC;IAED,mCAIC;CACJ;uBA7BsB,0CAA0C"}
+{"version":3,"file":"ComponentRemoveAction.d.ts","sourceRoot":"","sources":["../../../../editor/actions/concrete/ComponentRemoveAction.js"],"names":[],"mappings":";AAEA;IAGI,6CAKC;IAPD,eAAiB;IAKb,YAAoB;IACpB,mBAAkC;IAGtC,8CAEC;IAED,kCAUC;IAED,mCAIC;CACJ;uBAjCsB,0CAA0C"}

package/editor/actions/concrete/ComponentRemoveAction.js

@@ -10,6 +10,10 @@ class ComponentRemoveAction extends Action {
         this.componentType = componentType;
     }
 
+    collectWrites(editor, writes) {
+        writes.component(this.entity, this.componentType);
+    }
+
     async apply(editor) {
         /**
          * @type {EntityComponentDataset}

package/editor/actions/concrete/EntityCreateAction.d.ts

@@ -11,6 +11,7 @@ declare class EntityCreateAction extends Action<any> {
      * @type {EntityComponentDataset}
      */
     ecd: EntityComponentDataset;
+    collectWrites(editor: any, writes: any): void;
     apply(editor: any): Promise<void>;
     revert(editor: any): Promise<void>;
 }

package/editor/actions/concrete/EntityCreateAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityCreateAction.d.ts","sourceRoot":"","sources":["../../../../editor/actions/concrete/EntityCreateAction.js"],"names":[],"mappings":";AAEA;;IACI;;;OAGG;IACH,QAFU,MAAM,GAAC,IAAI,CAEP;IAEd;;;OAGG;IACH,4BAAW;IAEX,kCAkBC;IAED,mCAEC;CACJ;uBAtCsB,0CAA0C"}
+{"version":3,"file":"EntityCreateAction.d.ts","sourceRoot":"","sources":["../../../../editor/actions/concrete/EntityCreateAction.js"],"names":[],"mappings":";AAEA;;IACI;;;OAGG;IACH,QAFU,MAAM,GAAC,IAAI,CAEP;IAEd;;;OAGG;IACH,4BAAW;IAEX,8CAKC;IAED,kCAkBC;IAED,mCAEC;CACJ;uBA7CsB,0CAA0C"}

package/editor/actions/concrete/EntityCreateAction.js

@@ -13,6 +13,13 @@ class EntityCreateAction extends Action {
      */
     ecd = null;
 
+    collectWrites(editor, writes) {
+        // the id is assigned before apply by hosts that lease ids; a null entity is a local create
+        if (this.entity !== null) {
+            writes.entity(this.entity);
+        }
+    }
+
     async apply(editor) {
         if (this.ecd === null) {
             /**

package/editor/actions/concrete/EntityRemoveAction.d.ts

@@ -6,6 +6,7 @@ declare class EntityRemoveAction extends Action<Editor> {
     constructor(entity: any);
     components: any[];
     entity: any;
+    collectWrites(editor: any, writes: any): void;
 }
 import { Action } from "../../../src/core/process/undo/Action.js";
 //# sourceMappingURL=EntityRemoveAction.d.ts.map

package/editor/actions/concrete/EntityRemoveAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EntityRemoveAction.d.ts","sourceRoot":"","sources":["../../../../editor/actions/concrete/EntityRemoveAction.js"],"names":[],"mappings":";AAEA;;GAEG;AACH;IAGI,yBAGC;IALD,kBAAgB;IAIZ,YAAoB;CAmC3B;uBA7CsB,0CAA0C"}
+{"version":3,"file":"EntityRemoveAction.d.ts","sourceRoot":"","sources":["../../../../editor/actions/concrete/EntityRemoveAction.js"],"names":[],"mappings":";AAEA;;GAEG;AACH;IAGI,yBAGC;IALD,kBAAgB;IAIZ,YAAoB;IAGxB,8CAEC;CAkCJ;uBAjDsB,0CAA0C"}

package/editor/actions/concrete/EntityRemoveAction.js

@@ -11,6 +11,10 @@ class EntityRemoveAction extends Action {
         this.entity = entity;
     }
 
+    collectWrites(editor, writes) {
+        writes.entity(this.entity);
+    }
+
     /**
      *
      * @param {Editor} editor

package/editor/actions/concrete/PatchTerrainHeightAction.d.ts

@@ -26,7 +26,17 @@ export class PatchTerrainHeightAction extends ModifyPatchSampler2DAction {
      * @type {Terrain}
      */
     terrain: Terrain;
+    /**
+     * The heightmap rectangle this action writes (E4): a host recording through a ledger turns it
+     * into blob patches keyed by the terrain's entity.
+     * @param {Editor} editor
+     * @param {{blob: function(number, Function, string, number, number, number, number): void}} writes
+     */
+    collectWrites(editor: Editor, writes: {
+        blob: (arg0: number, arg1: Function, arg2: string, arg3: number, arg4: number, arg5: number, arg6: number) => void;
+    }): void;
     updateTerrain(): Promise<void>;
 }
 import { ModifyPatchSampler2DAction } from "./ModifyPatchSampler2DAction.js";
+import Terrain from "../../../src/engine/ecs/terrain/ecs/Terrain.js";
 //# sourceMappingURL=PatchTerrainHeightAction.d.ts.map

package/editor/actions/concrete/PatchTerrainHeightAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PatchTerrainHeightAction.d.ts","sourceRoot":"","sources":["../../../../editor/actions/concrete/PatchTerrainHeightAction.js"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,8CARW,MAAM,EAAE,KACR,MAAM,KACN,MAAM,eACN,MAAM,gBACN,MAAM,aACN,MAAM,cACN,MAAM,QAOhB;AAID;IACI;;;;;;;OAOG;IACH,iCALW,MAAM,KACN,MAAM,SACN,MAAM,UACN,MAAM,EAUhB;IALG;;;OAGG;IACH,iBAAsB;IAG1B,+BA6BC;CAaJ;2CApF0C,iCAAiC"}
+{"version":3,"file":"PatchTerrainHeightAction.d.ts","sourceRoot":"","sources":["../../../../editor/actions/concrete/PatchTerrainHeightAction.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,8CARW,MAAM,EAAE,KACR,MAAM,KACN,MAAM,eACN,MAAM,gBACN,MAAM,aACN,MAAM,cACN,MAAM,QAOhB;AAID;IACI;;;;;;;OAOG;IACH,qBANW,OAAO,KACP,MAAM,KACN,MAAM,SACN,MAAM,UACN,MAAM,EAUhB;IALG;;;OAGG;IACH,SAFU,OAAO,CAEK;IAG1B;;;;;OAKG;IACH,sCAFW;QAAC,IAAI,SAAW,MAAM,wBAAY,MAAM,QAAE,MAAM,QAAE,MAAM,QAAE,MAAM,QAAE,MAAM,KAAG,IAAI,CAAA;KAAC,QAe1F;IAED,+BA6BC;CAaJ;2CAzG0C,iCAAiC;oBADxD,gDAAgD"}

package/editor/actions/concrete/PatchTerrainHeightAction.js

@@ -1,85 +1,107 @@
-import { ModifyPatchSampler2DAction } from "./ModifyPatchSampler2DAction.js";
-
-/**
- * UV rectangle covered by a texel-space patch of a sampler. Standalone so the
- * region math is testable without live terrain tile machinery.
- *
- * @param {number[]} result [u0, v0, u1, v1]
- * @param {number} x patch origin in texels
- * @param {number} y
- * @param {number} patch_width in texels
- * @param {number} patch_height
- * @param {number} map_width sampler dimensions in texels
- * @param {number} map_height
- */
-export function compute_patch_uv_rect(result, x, y, patch_width, patch_height, map_width, map_height) {
-    result[0] = x / map_width;
-    result[1] = y / map_height;
-    result[2] = (x + patch_width) / map_width;
-    result[3] = (y + patch_height) / map_height;
-}
-
-const scratch_uv_rect = [0, 0, 0, 0];
-
-export class PatchTerrainHeightAction extends ModifyPatchSampler2DAction {
-    /**
-     *
-     * @param {Terrain} terrain
-     * @param {number} x
-     * @param {number} y
-     * @param {number} width
-     * @param {number} height
-     */
-    constructor(terrain, x, y, width, height) {
-        super(terrain.samplerHeight, [x, y, x + width, y + height]);
-
-        /**
-         *
-         * @type {Terrain}
-         */
-        this.terrain = terrain;
-    }
-
-    async updateTerrain() {
-        /**
-         *
-         * @type {Terrain}
-         */
-        const terrain = this.terrain;
-
-        terrain.updateWorkerHeights();
-
-        /**
-         *
-         * @type {Sampler2D}
-         */
-        const heightMap = terrain.samplerHeight;
-
-        /**
-         *
-         * @type {TerrainTileManager}
-         */
-        const tiles = terrain.__tiles;
-
-        compute_patch_uv_rect(
-            scratch_uv_rect,
-            this.x, this.y,
-            this.patch.width, this.patch.height,
-            heightMap.width, heightMap.height
-        );
-
-        tiles.rebuildTilesByUV(scratch_uv_rect[0], scratch_uv_rect[1], scratch_uv_rect[2], scratch_uv_rect[3]);
-    }
-
-    async apply(context) {
-        await super.apply(context);
-
-        await this.updateTerrain();
-    }
-
-    async revert(context) {
-        await super.revert(context);
-
-        await this.updateTerrain();
-    }
-}
+import Terrain from "../../../src/engine/ecs/terrain/ecs/Terrain.js";
+import { ModifyPatchSampler2DAction } from "./ModifyPatchSampler2DAction.js";
+
+/**
+ * UV rectangle covered by a texel-space patch of a sampler. Standalone so the
+ * region math is testable without live terrain tile machinery.
+ *
+ * @param {number[]} result [u0, v0, u1, v1]
+ * @param {number} x patch origin in texels
+ * @param {number} y
+ * @param {number} patch_width in texels
+ * @param {number} patch_height
+ * @param {number} map_width sampler dimensions in texels
+ * @param {number} map_height
+ */
+export function compute_patch_uv_rect(result, x, y, patch_width, patch_height, map_width, map_height) {
+    result[0] = x / map_width;
+    result[1] = y / map_height;
+    result[2] = (x + patch_width) / map_width;
+    result[3] = (y + patch_height) / map_height;
+}
+
+const scratch_uv_rect = [0, 0, 0, 0];
+
+export class PatchTerrainHeightAction extends ModifyPatchSampler2DAction {
+    /**
+     *
+     * @param {Terrain} terrain
+     * @param {number} x
+     * @param {number} y
+     * @param {number} width
+     * @param {number} height
+     */
+    constructor(terrain, x, y, width, height) {
+        super(terrain.samplerHeight, [x, y, x + width, y + height]);
+
+        /**
+         *
+         * @type {Terrain}
+         */
+        this.terrain = terrain;
+    }
+
+    /**
+     * The heightmap rectangle this action writes (E4): a host recording through a ledger turns it
+     * into blob patches keyed by the terrain's entity.
+     * @param {Editor} editor
+     * @param {{blob: function(number, Function, string, number, number, number, number): void}} writes
+     */
+    collectWrites(editor, writes) {
+        const dataset = editor.engine.entityManager.dataset;
+        let entity = -1;
+
+        dataset.traverseComponents(Terrain, (terrain, e) => {
+            if (terrain === this.terrain) {
+                entity = e;
+            }
+        });
+
+        if (entity !== -1) {
+            writes.blob(entity, Terrain, "samplerHeight", this.x, this.y, this.patch.width, this.patch.height);
+        }
+    }
+
+    async updateTerrain() {
+        /**
+         *
+         * @type {Terrain}
+         */
+        const terrain = this.terrain;
+
+        terrain.updateWorkerHeights();
+
+        /**
+         *
+         * @type {Sampler2D}
+         */
+        const heightMap = terrain.samplerHeight;
+
+        /**
+         *
+         * @type {TerrainTileManager}
+         */
+        const tiles = terrain.__tiles;
+
+        compute_patch_uv_rect(
+            scratch_uv_rect,
+            this.x, this.y,
+            this.patch.width, this.patch.height,
+            heightMap.width, heightMap.height
+        );
+
+        tiles.rebuildTilesByUV(scratch_uv_rect[0], scratch_uv_rect[1], scratch_uv_rect[2], scratch_uv_rect[3]);
+    }
+
+    async apply(context) {
+        await super.apply(context);
+
+        await this.updateTerrain();
+    }
+
+    async revert(context) {
+        await super.revert(context);
+
+        await this.updateTerrain();
+    }
+}

package/editor/actions/concrete/TransformModifyAction.d.ts

@@ -10,6 +10,7 @@ declare class TransformModifyAction extends Action<any> {
     oldState: any;
     modified: Transform64;
     entity: any;
+    collectWrites(editor: any, writes: any): void;
     revert(editor: any): Promise<void>;
 }
 import { Action } from "../../../src/core/process/undo/Action.js";

package/editor/actions/concrete/TransformModifyAction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TransformModifyAction.d.ts","sourceRoot":"","sources":["../../../../editor/actions/concrete/TransformModifyAction.js"],"names":[],"mappings":";AAGA;IAGI;;;;;OAKG;IACH,mCAHW,WAAW,EAQrB;IAbD,cAAgB;IAWZ,sBAAwB;IACxB,YAAoB;IAsBxB,mCAIC;CACJ;uBA1CsB,0CAA0C;4BADrC,kDAAkD"}
+{"version":3,"file":"TransformModifyAction.d.ts","sourceRoot":"","sources":["../../../../editor/actions/concrete/TransformModifyAction.js"],"names":[],"mappings":";AAGA;IAGI;;;;;OAKG;IACH,mCAHW,WAAW,EAQrB;IAbD,cAAgB;IAWZ,sBAAwB;IACxB,YAAoB;IAOxB,8CAEC;IAiBD,mCAIC;CACJ;uBA9CsB,0CAA0C;4BADrC,kDAAkD"}

package/editor/actions/concrete/TransformModifyAction.js

@@ -21,6 +21,10 @@ class TransformModifyAction extends Action {
         return 280;
     }
 
+    collectWrites(editor, writes) {
+        writes.component(this.entity, Transform64);
+    }
+
     /**
      *
      * @param {Editor} editor

package/editor/particles/effect/ParticleEffectDocument.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParticleEffectDocument.d.ts","sourceRoot":"","sources":["../../../../editor/particles/effect/ParticleEffectDocument.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"ParticleEffectDocument.d.ts","sourceRoot":"","sources":["../../../../editor/particles/effect/ParticleEffectDocument.js"],"names":[],"mappings":"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"}

package/editor/particles/effect/ParticleEffectDocument.js

@@ -167,14 +167,14 @@ export class ParticleEffectDocument {
      */
     emitter = {
         spawn_rate: 120,
+        /** seconds of emission run forward before the effect is first shown; 0 is off */
+        prewarm: 0,
         blend: EMITTER_BLEND.ADDITIVE,
         projection: EMITTER_PROJECTION.BILLBOARD,
         lighting: false,
         soft_depth: false,
         sort: false,
         cull: false,
-        bounds_center: [0, 1, 0],
-        bounds_radius: 3,
         /** image to draw with, by URL; null draws against the default atlas, a white texel */
         texture: null,
         flipbook: [1, 1],
@@ -885,6 +885,7 @@ export class ParticleEffectDocument {
             program,
             name: this.name,
             spawn_rate: this.emitter.spawn_rate,
+            prewarm: this.emitter.prewarm,
             flags: {
                 blend: this.emitter.blend,
                 projection: this.emitter.projection,
@@ -893,10 +894,6 @@ export class ParticleEffectDocument {
                 sort: this.emitter.sort,
                 cull: this.emitter.cull,
             },
-            bounds: {
-                center: this.emitter.bounds_center,
-                radius: this.emitter.bounds_radius,
-            },
             texture: this.emitter.texture,
             flipbook: this.emitter.flipbook,
             render,
@@ -990,6 +987,13 @@ export class ParticleEffectDocument {
         });
 
         this.emitter = { ...this.emitter, ...structuredClone(json.emitter ?? {}) };
+
+        // An effect saved while emitters still carried an authored bounding sphere. There is nothing
+        // to migrate — the box is measured from the particles now — and the merge above is a spread,
+        // so without this the dead keys would ride along in every later save.
+        delete this.emitter.bounds_center;
+        delete this.emitter.bounds_radius;
+
         this.source = json.source === PARTICLE_EFFECT_SOURCE.ASSEMBLY
             ? PARTICLE_EFFECT_SOURCE.ASSEMBLY
             : PARTICLE_EFFECT_SOURCE.GRAPH;

package/editor/particles/effect/ParticleReferenceSimulation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParticleReferenceSimulation.d.ts","sourceRoot":"","sources":["../../../../editor/particles/effect/ParticleReferenceSimulation.js"],"names":[],"mappings":"AA8BA;;;;;;GAMG;AACH,wCAFU,MAAM,CAE8B;AAE9C;IAgFI;;;OAGG;IACH;QAF4B,QAAQ,GAAzB,MAAM;OAiBhB;IAjGD;;;;OAIG;IACH,MAFU,WAAW,CAEhB;IAEL;;;OAGG;IACH,OAFU,MAAM,EAAE,CAEP;IAEX;;;OAGG;IACH,MAFU,MAAM,EAAE,CAER;IAEV;;;OAGG;IACH,KAFU,WAAW,CAEI;IAQzB;;;OAGG;IACH,mBAFU,MAAM,CAEM;IAEtB;;;OAGG;IACH,aAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,MAFU,MAAM,CAEP;IAoCL;;OAEG;IACH,UAFU,MAAM,CAEQ;IAa5B;;OAEG;IACH,cAWC;IAED;;;;;;;;;;;;OAYG;IACH;QAJ0G,OAAO,EAAtG,OAAO,8DAA8D,EAAE,eAAe;QACU,MAAM,EAAtG,OAAO,gEAAgE,EAAE,cAAc;QACxE,OAAO,EAAtB,MAAM;aAgBhB;IAED;;OAEG;IACH,oBAEC;IAED;;;;OAIG;IACH,SAFW,MAAM,QAYhB;IAmHD;;;;;;;;;OASG;IACH;WAFwB,MAAM;WAAK,MAAM;WAAK,MAAM;cAAQ,MAAM;WAAK,MAAM;WAAK,MAAM;WAAK,MAAM;WAAK,MAAM;kBAAY,MAAM;eAAS,MAAM;qBA6C9I;;CACJ"}
+{"version":3,"file":"ParticleReferenceSimulation.d.ts","sourceRoot":"","sources":["../../../../editor/particles/effect/ParticleReferenceSimulation.js"],"names":[],"mappings":"AAuCA;;;;;;GAMG;AACH,wCAFU,MAAM,CAE8B;AAE9C;IAgGI;;;OAGG;IACH;QAF4B,QAAQ,GAAzB,MAAM;OAiBhB;IAjHD;;;;OAIG;IACH,MAFU,WAAW,CAEhB;IAEL;;;OAGG;IACH,OAFU,MAAM,EAAE,CAEP;IAEX;;;OAGG;IACH,MAFU,MAAM,EAAE,CAER;IAEV;;;OAGG;IACH,KAFU,WAAW,CAEI;IAQzB;;;OAGG;IACH,mBAFU,MAAM,CAEM;IAEtB;;;OAGG;IACH,aAFU,MAAM,CAEA;IAEhB;;;OAGG;IACH,MAFU,MAAM,CAEP;IAoDL;;OAEG;IACH,UAFU,MAAM,CAEQ;IAa5B;;OAEG;IACH,cAYC;IAED;;;;;;;;;;;;OAYG;IACH;QAJ0G,OAAO,EAAtG,OAAO,8DAA8D,EAAE,eAAe;QACU,MAAM,EAAtG,OAAO,gEAAgE,EAAE,cAAc;QACxE,OAAO,EAAtB,MAAM;aAsBhB;IAED;;OAEG;IACH,oBAEC;IAED;;;;OAIG;IACH,SAFW,MAAM,QAmBhB;IA0KD;;;;;;;;;OASG;IACH;WAFwB,MAAM;WAAK,MAAM;WAAK,MAAM;cAAQ,MAAM;WAAK,MAAM;WAAK,MAAM;WAAK,MAAM;WAAK,MAAM;kBAAY,MAAM;eAAS,MAAM;qBA6C9I;;CACJ"}

package/editor/particles/effect/ParticleReferenceSimulation.js

@@ -1,6 +1,12 @@
+import { hash_mix2 } from "../../../src/core/math/hash/hash_mix2.js";
 import {
     PARTICLE_RECORD_WORD_COUNT,
+    PARTICLE_WARMUP_DT_JITTER,
 } from "../../../src/shade/renderer/particles/ParticleConstants.js";
+import {
+    warmup_remaining,
+    warmup_schedule,
+} from "../../../src/shade/renderer/particles/warmup/warmup_schedule.js";
 import { EMITTER_ATTRIBUTE_ABSENT } from "../../../src/shade/renderer/particles/data/PARTICLE_EMITTER_STRUCT.js";
 import { VM_BUILTIN } from "../../../src/shade/renderer/particles/isa/ParticleVMISA.js";
 import { execute_particle_vm } from "../../../src/shade/renderer/particles/vm/ParticleVMReference.js";
@@ -20,7 +26,10 @@ import { execute_particle_vm } from "../../../src/shade/renderer/particles/vm/Pa
  * keep in step.
  *
  * Spawning follows the emitter's rate the way the GPU tick pass does — an accumulator carried across
- * frames, so a rate that is not a whole number of particles per frame still averages out.
+ * frames, so a rate that is not a whole number of particles per frame still averages out — and an
+ * emitter's pre-warm the way the warm-up pipeline does (`warmup/`): the same loop, run forward over
+ * the same schedule before the first frame, so what an author sees when they type a duration into
+ * the inspector is the population the effect will arrive with in a scene.
  */
 
 /** Where the previewed emitter sits, and which way it points. Fixed: the preview has one emitter. */
@@ -94,6 +103,22 @@ export class ParticleReferenceSimulation {
      */
     #spawn_counter = 0;
 
+    /**
+     * Whether the next emission is the emitter's first since it started over, and so owes the
+     * emitter's pre-warm. The GPU's equivalent is the tick pass's generation comparison, which no
+     * preview has a use for: here "started over" is {@link reset}.
+     * @type {boolean}
+     */
+    #owes_prewarm = true;
+
+    /**
+     * The pre-warm the effect was last set with, so a change to it can restart the preview. Typing a
+     * duration into the inspector and watching nothing happen — because the effect is already
+     * running and pre-warm only applies to a start — would read as a broken control.
+     * @type {number}
+     */
+    #prewarm = 0;
+
     /**
      * @type {import("../../../src/shade/renderer/particles/isa/ParticleProgram.js").ParticleProgram|null}
      */
@@ -152,6 +177,7 @@ export class ParticleReferenceSimulation {
         this.pool.fill(0);
         this.spawn_accumulator = 0;
         this.emitter_age = 0;
+        this.#owes_prewarm = true;
     }
 
     /**
@@ -172,8 +198,14 @@ export class ParticleReferenceSimulation {
             .map(attribute => `${attribute.name}:${attribute.offset}:${attribute.components}`)
             .join(",");
 
-        if (signature !== this.#layout_signature) {
+        const prewarm = emitter.prewarm ?? 0;
+
+        // A pre-warm is a statement about how an effect STARTS, so the only way to show one is to
+        // start the effect. The layout signature is checked the same way and for the same reason:
+        // both are changes the particles in flight cannot survive meaning anything under.
+        if (signature !== this.#layout_signature || prewarm !== this.#prewarm) {
             this.#layout_signature = signature;
+            this.#prewarm = prewarm;
 
             this.reset();
         }
@@ -200,6 +232,13 @@ export class ParticleReferenceSimulation {
             return;
         }
 
+        // The first frame after a start pays the pre-warm first, so the population this frame
+        // adds to is the one the emitter would have had.
+        if (this.#owes_prewarm) {
+            this.#owes_prewarm = false;
+            this.#warmup();
+        }
+
         this.time += dt;
         this.emitter_age += dt;
 
@@ -207,6 +246,50 @@ export class ParticleReferenceSimulation {
         this.#update(dt);
     }
 
+    /**
+     * Run the emitter forward by its pre-warm before it is first shown: the ordinary loop — emit,
+     * then update — over the same schedule the GPU warm-up uses ({@link warmup_schedule}), with the
+     * clocks rewound so `TIME` and `EMITTER_AGE` read as they would have.
+     *
+     * It ends with the emitter's age at exactly its pre-warm and the frame's clock where it was, so
+     * the frame that follows adds its own `dt` to both, as the GPU's next tick does.
+     *
+     * The preview has one emitter, so the per-emitter beat the GPU queue carries (each emitter's
+     * tick at a slightly different clock, its accumulator started at a hashed fraction) has nothing
+     * to separate here and is not reproduced; the per-particle jitter is, because it is what keeps
+     * a warm-up of N ticks from arriving as N bands.
+     */
+    #warmup() {
+        const prewarm = this.#emitter.prewarm ?? 0;
+
+        if (prewarm <= 0) {
+            return;
+        }
+
+        const schedule = warmup_schedule(prewarm);
+        const now = this.time;
+
+        for (let tick = 0; tick < schedule.ticks; tick++) {
+            const remaining = warmup_remaining(schedule, tick);
+
+            // The loop's clock counts down to now; the emitter joins it once the time left is what
+            // it asked to have been running for. Only the rounding of the schedule's span up to a
+            // whole tick can leave it out of the first one.
+            if (remaining > prewarm) {
+                continue;
+            }
+
+            this.time = now - remaining;
+            this.emitter_age = prewarm - remaining + schedule.dt;
+
+            this.#emit(schedule.dt);
+            this.#update(schedule.dt, tick + 1);
+        }
+
+        this.time = now;
+        this.emitter_age = prewarm;
+    }
+
     /**
      * @param {number} dt
      */
@@ -258,8 +341,11 @@ export class ParticleReferenceSimulation {
 
     /**
      * @param {number} dt
+     * @param {number} [tick] a warm-up tick's number, when this is one: the tick is then jittered per
+     *   particle by {@link PARTICLE_WARMUP_DT_JITTER}, hashed from the slot and the tick, exactly as
+     *   the GPU's advance does. Zero — a frame — is not jittered.
      */
-    #update(dt) {
+    #update(dt, tick = 0) {
         const alive = this.alive;
 
         let write = 0;
@@ -267,12 +353,20 @@ export class ParticleReferenceSimulation {
         for (let read = 0; read < alive.length; read++) {
             const slot = alive[read];
 
+            let dt_particle = dt;
+
+            if (tick !== 0) {
+                const u = ((hash_mix2(slot, tick) >>> 8) / 16777216);
+
+                dt_particle = dt * (1 + PARTICLE_WARMUP_DT_JITTER * (u - 0.5));
+            }
+
             const result = execute_particle_vm({
                 words: this.#program.update,
                 constants: this.#program.constants,
                 register_count: this.#program.register_count,
                 record: this.#record(slot),
-                builtins: this.#builtins(dt, slot, 0),
+                builtins: this.#builtins(dt_particle, slot, 0),
                 rng_state: this.rng[slot],
             });
 

package/editor/particles/effect/make_starter_particle_effect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"make_starter_particle_effect.d.ts","sourceRoot":"","sources":["../../../../editor/particles/effect/make_starter_particle_effect.js"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,gDAFa,sBAAsB,CAkBlC;uCAtCsC,6BAA6B"}
+{"version":3,"file":"make_starter_particle_effect.d.ts","sourceRoot":"","sources":["../../../../editor/particles/effect/make_starter_particle_effect.js"],"names":[],"mappings":"AAeA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,gDAFa,sBAAsB,CAgBlC;uCApCsC,6BAA6B"}

package/editor/particles/effect/make_starter_particle_effect.js

@@ -44,8 +44,6 @@ export function make_starter_particle_effect() {
     document.emitter.spawn_rate = 220;
     document.emitter.blend = EMITTER_BLEND.ADDITIVE;
     document.emitter.projection = EMITTER_PROJECTION.BILLBOARD;
-    document.emitter.bounds_center = [0, 1.5, 0];
-    document.emitter.bounds_radius = 4;
     document.emitter.render = { position: "position", size: "size", color: "color", velocity: "velocity" };
 
     return document;