@woosh/meep-engine 3.33.0 → 3.34.0

package/editor/process/ParticleEmitterRebuildProcess.d.ts

@@ -1,66 +0,0 @@
-/**
- * Keeps live particle emitters in sync with editing: rebuilds an emitter when its layer
- * list changes or one of its parameter lookup tables is edited (curve/gradient editors
- * announce those through {@link onParameterLutEdited}). Rebuilds are debounced — drags
- * produce edit bursts.
- */
-export class ParticleEmitterRebuildProcess extends EditorProcess {
-    /**
-     * emitter layer-list subscriptions, torn down on shutdown
-     * @type {Map<number, {emitter: ParticleEmitter, handler: function}>}
-     */
-    __watched: Map<number, {
-        emitter: ParticleEmitter;
-        handler: Function;
-    }>;
-    /**
-     * entities with a rebuild pending
-     * @type {Set<number>}
-     */
-    __pending: Set<number>;
-    /**
-     * @type {number|null}
-     */
-    __timer: number | null;
-    /**
-     * @type {boolean}
-     */
-    __running: boolean;
-    /**
-     * Map an edited lookup table back to its owning emitter
-     * @param {ParameterLookupTable} lut
-     */
-    __handleLutEdited(lut: ParameterLookupTable): void;
-    /**
-     *
-     * @param {number} entity
-     */
-    __handleEntityCreated(entity: number): void;
-    /**
-     *
-     * @param {number} entity
-     */
-    __handleEntityRemoved(entity: number): void;
-    /**
-     *
-     * @param {number} entity
-     */
-    __scheduleRebuild(entity: number): void;
-    /**
-     *
-     * @param {ParticleEmitter} emitter
-     * @param {number} entity
-     */
-    __watch(emitter: ParticleEmitter, entity: number): void;
-    /**
-     *
-     * @param {number} entity
-     */
-    __unwatch(entity: number): void;
-}
-export namespace ParticleEmitterRebuildProcess {
-    let Id: string;
-}
-import { EditorProcess } from "./EditorProcess.js";
-import { ParticleEmitter } from "../../src/engine/graphics/particles/particular/engine/emitter/ParticleEmitter.js";
-//# sourceMappingURL=ParticleEmitterRebuildProcess.d.ts.map

package/editor/process/ParticleEmitterRebuildProcess.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ParticleEmitterRebuildProcess.d.ts","sourceRoot":"","sources":["../../../editor/process/ParticleEmitterRebuildProcess.js"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH;IAII;;;OAGG;IACH,WAFU,IAAI,MAAM,EAAE;QAAC,OAAO,EAAE,eAAe,CAAC;QAAC,OAAO,WAAU;KAAC,CAAC,CAE9C;IAEtB;;;OAGG;IACH,WAFU,IAAI,MAAM,CAAC,CAEC;IAEtB;;OAEG;IACH,SAFU,MAAM,GAAC,IAAI,CAEN;IAEf;;OAEG;IACH,WAFU,OAAO,CAEC;IAwGlB;;;OAGG;IACH,mDAuBC;IA9DD;;;OAGG;IACH,8BAFW,MAAM,QAsBhB;IAED;;;OAGG;IACH,8BAFW,MAAM,QAKhB;IA5FD;;;OAGG;IACH,0BAFW,MAAM,QAoBhB;IAED;;;;OAIG;IACH,iBAHW,eAAe,UACf,MAAM,QAahB;IAED;;;OAGG;IACH,kBAFW,MAAM,QAahB;CA4GJ;;;;8BAjN6B,oBAAoB;gCAHlB,kFAAkF"}

package/editor/process/ParticleEmitterRebuildProcess.js

@@ -1,217 +0,0 @@
-import { ParticleEmitter } from "../../src/engine/graphics/particles/particular/engine/emitter/ParticleEmitter.js";
-import { onParameterLutEdited } from "../particles/particleEditEvents.js";
-import { rebuildParticleEmitter } from "../particles/rebuildParticleEmitter.js";
-import { EditorProcess } from "./EditorProcess.js";
-
-const REBUILD_DELAY_MS = 250;
-
-/**
- * Keeps live particle emitters in sync with editing: rebuilds an emitter when its layer
- * list changes or one of its parameter lookup tables is edited (curve/gradient editors
- * announce those through {@link onParameterLutEdited}). Rebuilds are debounced — drags
- * produce edit bursts.
- */
-class ParticleEmitterRebuildProcess extends EditorProcess {
-
-    name = ParticleEmitterRebuildProcess.Id;
-
-    /**
-     * emitter layer-list subscriptions, torn down on shutdown
-     * @type {Map<number, {emitter: ParticleEmitter, handler: function}>}
-     */
-    __watched = new Map();
-
-    /**
-     * entities with a rebuild pending
-     * @type {Set<number>}
-     */
-    __pending = new Set();
-
-    /**
-     * @type {number|null}
-     */
-    __timer = null;
-
-    /**
-     * @type {boolean}
-     */
-    __running = false;
-
-    constructor() {
-        super();
-
-        this.__handleLutEdited = this.__handleLutEdited.bind(this);
-        this.__handleEntityCreated = this.__handleEntityCreated.bind(this);
-        this.__handleEntityRemoved = this.__handleEntityRemoved.bind(this);
-    }
-
-    /**
-     *
-     * @param {number} entity
-     */
-    __scheduleRebuild(entity) {
-        this.__pending.add(entity);
-
-        if (this.__timer !== null) {
-            return;
-        }
-
-        this.__timer = setTimeout(() => {
-            this.__timer = null;
-
-            const entityManager = this.editor.engine.entityManager;
-
-            for (const pending of this.__pending) {
-                rebuildParticleEmitter(entityManager, pending);
-            }
-
-            this.__pending.clear();
-        }, REBUILD_DELAY_MS);
-    }
-
-    /**
-     *
-     * @param {ParticleEmitter} emitter
-     * @param {number} entity
-     */
-    __watch(emitter, entity) {
-        if (this.__watched.has(entity)) {
-            return;
-        }
-
-        const handler = () => this.__scheduleRebuild(entity);
-
-        emitter.layers.on.added.add(handler);
-        emitter.layers.on.removed.add(handler);
-
-        this.__watched.set(entity, { emitter, handler });
-    }
-
-    /**
-     *
-     * @param {number} entity
-     */
-    __unwatch(entity) {
-        const record = this.__watched.get(entity);
-
-        if (record === undefined) {
-            return;
-        }
-
-        record.emitter.layers.on.added.remove(record.handler);
-        record.emitter.layers.on.removed.remove(record.handler);
-
-        this.__watched.delete(entity);
-    }
-
-    /**
-     *
-     * @param {number} entity
-     */
-    __handleEntityCreated(entity) {
-        // components attach in the microtasks that follow creation (the action queue is
-        // microtask-chained), so the check must land in the NEXT macrotask
-        setTimeout(() => {
-            if (!this.__running) {
-                return;
-            }
-
-            const ecd = this.editor.engine.entityManager.dataset;
-
-            if (!ecd.entityExists(entity)) {
-                return;
-            }
-
-            const emitter = ecd.getComponent(entity, ParticleEmitter);
-
-            if (emitter !== undefined) {
-                this.__watch(emitter, entity);
-            }
-        }, 0);
-    }
-
-    /**
-     *
-     * @param {number} entity
-     */
-    __handleEntityRemoved(entity) {
-        this.__unwatch(entity);
-        this.__pending.delete(entity);
-    }
-
-    /**
-     * Map an edited lookup table back to its owning emitter
-     * @param {ParameterLookupTable} lut
-     */
-    __handleLutEdited(lut) {
-        const ecd = this.editor.engine.entityManager.dataset;
-
-        if (!ecd.isComponentTypeRegistered(ParticleEmitter)) {
-            return;
-        }
-
-        ecd.traverseComponents(ParticleEmitter, (emitter, entity) => {
-            const layer_count = emitter.layers.length;
-
-            for (let i = 0; i < layer_count; i++) {
-                const layer = emitter.layers.get(i);
-
-                const track_count = layer.parameterTracks.tracks.length;
-
-                for (let j = 0; j < track_count; j++) {
-                    if (layer.parameterTracks.tracks.get(j).track === lut) {
-                        this.__scheduleRebuild(entity);
-                        return;
-                    }
-                }
-            }
-        });
-    }
-
-    startup() {
-        super.startup();
-
-        this.__running = true;
-
-        const ecd = this.editor.engine.entityManager.dataset;
-
-        if (ecd.isComponentTypeRegistered(ParticleEmitter)) {
-            ecd.traverseComponents(ParticleEmitter, (emitter, entity) => {
-                this.__watch(emitter, entity);
-            });
-        }
-
-        ecd.onEntityCreated.add(this.__handleEntityCreated);
-        ecd.onEntityRemoved.add(this.__handleEntityRemoved);
-
-        onParameterLutEdited.add(this.__handleLutEdited);
-    }
-
-    shutdown() {
-        super.shutdown();
-
-        this.__running = false;
-
-        const ecd = this.editor.engine.entityManager.dataset;
-
-        ecd.onEntityCreated.remove(this.__handleEntityCreated);
-        ecd.onEntityRemoved.remove(this.__handleEntityRemoved);
-
-        onParameterLutEdited.remove(this.__handleLutEdited);
-
-        for (const entity of Array.from(this.__watched.keys())) {
-            this.__unwatch(entity);
-        }
-
-        if (this.__timer !== null) {
-            clearTimeout(this.__timer);
-            this.__timer = null;
-        }
-
-        this.__pending.clear();
-    }
-}
-
-ParticleEmitterRebuildProcess.Id = 'particle-emitter-rebuild';
-
-export { ParticleEmitterRebuildProcess };

package/editor/process/symbolic/ParticleEmitterSymbolicDisplay.d.ts

@@ -1,18 +0,0 @@
-/**
- * Where a particle emitter's layers are and what volume each of them emits from.
- *
- * One marker per layer wherever the layer sits, and the emission volume around it: a sphere for a
- * spherical emission shape, a box for a box one, and for a point shape the marker alone, because a
- * point has no volume to draw.
- *
- * **The box is twelve segments rather than the recording's own wire cube.** A layer's box is in the
- * emitter's frame and turns with the entity; `draw_wire_cube` takes a centre and a size and is
- * therefore axis-aligned. See {@link gizmo_draw_wire_box_oriented}.
- *
- * @see SymbolicDisplay
- */
-export class ParticleEmitterSymbolicDisplay extends SymbolicDisplay {
-    #private;
-}
-import { SymbolicDisplay } from "./SymbolicDisplay.js";
-//# sourceMappingURL=ParticleEmitterSymbolicDisplay.d.ts.map

package/editor/process/symbolic/ParticleEmitterSymbolicDisplay.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ParticleEmitterSymbolicDisplay.d.ts","sourceRoot":"","sources":["../../../../editor/process/symbolic/ParticleEmitterSymbolicDisplay.js"],"names":[],"mappings":"AAsEA;;;;;;;;;;;;GAYG;AACH;;CAwDC;gCA9HuD,sBAAsB"}

package/editor/process/symbolic/ParticleEmitterSymbolicDisplay.js

@@ -1,140 +0,0 @@
-import { m4_compose } from "../../../src/core/geom/3d/mat4/m4_compose.js";
-import { m4_multiply } from "../../../src/core/geom/3d/mat4/m4_multiply.js";
-import Quaternion from "../../../src/core/geom/Quaternion.js";
-import Vector3 from "../../../src/core/geom/Vector3.js";
-import { Transform64 } from "../../../src/engine/ecs/transform/Transform64.js";
-import {
-    EmissionShapeType
-} from "../../../src/engine/graphics/particles/particular/engine/emitter/EmissionShapeType.js";
-import {
-    ParticleEmitter
-} from "../../../src/engine/graphics/particles/particular/engine/emitter/ParticleEmitter.js";
-import { Gizmo } from "../../../src/engine/graphics/render/gizmo/Gizmo.js";
-import { gizmo_draw_wire_box_oriented } from "./gizmo_draw_wire_box_oriented.js";
-import { entity_is_editor_owned, SymbolicDisplay } from "./SymbolicDisplay.js";
-
-/**
- * @type {number[]}
- */
-const CENTER_COLOR = [1, 0, 0, 1];
-
-/**
- * @type {number[]}
- */
-const SHAPE_COLOR = [1, 1, 1, 0.5];
-
-/**
- * How big a layer's centre marker is, in world units.
- *
- * @type {number}
- */
-const CENTER_SIZE = 0.03;
-
-/**
- * @type {Float32Array}
- */
-const emitter_matrix = new Float32Array(16);
-
-/**
- * @type {Float32Array}
- */
-const layer_matrix = new Float32Array(16);
-
-/**
- * @type {Float32Array}
- */
-const shape_matrix = new Float32Array(16);
-
-/**
- * @type {Float32Array}
- */
-const center = new Float32Array(3);
-
-/**
- * @type {Float32Array}
- */
-const size = new Float32Array(3);
-
-/**
- * A layer's own frame carries no rotation of its own — only an offset and a scale — and
- * {@link m4_compose} wants all three.
- *
- * @type {Quaternion}
- */
-const no_rotation = new Quaternion(0, 0, 0, 1);
-
-/**
- * @type {Vector3}
- */
-const unit_scale = new Vector3(1, 1, 1);
-
-/**
- * Where a particle emitter's layers are and what volume each of them emits from.
- *
- * One marker per layer wherever the layer sits, and the emission volume around it: a sphere for a
- * spherical emission shape, a box for a box one, and for a point shape the marker alone, because a
- * point has no volume to draw.
- *
- * **The box is twelve segments rather than the recording's own wire cube.** A layer's box is in the
- * emitter's frame and turns with the entity; `draw_wire_cube` takes a centre and a size and is
- * therefore axis-aligned. See {@link gizmo_draw_wire_box_oriented}.
- *
- * @see SymbolicDisplay
- */
-export class ParticleEmitterSymbolicDisplay extends SymbolicDisplay {
-    /**
-     * @param {EntityComponentDataset} dataset
-     */
-    record(dataset) {
-        dataset.traverseEntities([ParticleEmitter, Transform64], (emitter, transform, entity) => {
-            if (entity_is_editor_owned(dataset, entity)) {
-                return;
-            }
-
-            // the matrix sits at offset 0, so the first sixteen elements are it
-            for (let i = 0; i < 16; i++) {
-                emitter_matrix[i] = transform[i];
-            }
-
-            // a sphere in the recording has one radius, so a non-uniformly scaled emitter cannot
-            // have its emission sphere drawn exactly; x is the component the three version scaled
-            // the helper by too
-            const emitter_scale = Math.hypot(emitter_matrix[0], emitter_matrix[1], emitter_matrix[2]);
-
-            emitter.traverseLayers(layer => this.#draw_layer(layer, emitter_scale));
-        });
-    }
-
-    /**
-     * @param {ParticleLayer} layer
-     * @param {number} emitter_scale the emitter's own scale along x, from its transform
-     */
-    #draw_layer(layer, emitter_scale) {
-        m4_compose(layer_matrix, layer.position, no_rotation, unit_scale);
-        m4_multiply(shape_matrix, emitter_matrix, layer_matrix);
-
-        center[0] = shape_matrix[12];
-        center[1] = shape_matrix[13];
-        center[2] = shape_matrix[14];
-
-        Gizmo.color = CENTER_COLOR;
-
-        size[0] = CENTER_SIZE;
-        size[1] = CENTER_SIZE;
-        size[2] = CENTER_SIZE;
-
-        Gizmo.draw_solid_cube(center, size);
-
-        Gizmo.color = SHAPE_COLOR;
-
-        if (layer.emissionShape === EmissionShapeType.Sphere) {
-            // the emission sphere is a unit diameter scaled by the layer, and a radius is half of it
-            Gizmo.draw_wire_sphere(center, layer.scale.x * emitter_scale * 0.5);
-        } else if (layer.emissionShape === EmissionShapeType.Box) {
-            m4_compose(layer_matrix, layer.position, no_rotation, layer.scale);
-            m4_multiply(shape_matrix, emitter_matrix, layer_matrix);
-
-            gizmo_draw_wire_box_oriented(shape_matrix);
-        }
-    }
-}

package/src/engine/animation/removeEntityGenericEffect.d.ts

@@ -1,18 +0,0 @@
-/**
- *
- * @param {Object} options
- * @param {Engine} options.engine
- * @param {EntityComponentDataset} options.ecd
- * @param {number} options.entity
- * @param {string} [options.particles]
- * @param {string} [options.sound]
- * @returns {Promise<any>}
- */
-export function removeEntityGenericEffect({ engine, ecd, entity, particles, sound }: {
-    engine: Engine;
-    ecd: EntityComponentDataset;
-    entity: number;
-    particles?: string;
-    sound?: string;
-}): Promise<any>;
-//# sourceMappingURL=removeEntityGenericEffect.d.ts.map

package/src/engine/animation/removeEntityGenericEffect.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"removeEntityGenericEffect.d.ts","sourceRoot":"","sources":["../../../../src/engine/animation/removeEntityGenericEffect.js"],"names":[],"mappings":"AA2HA;;;;;;;;;GASG;AACH;IAP2B,MAAM;IACU,GAAG;IACnB,MAAM,EAAtB,MAAM;IACW,SAAS,GAA1B,MAAM;IACW,KAAK,GAAtB,MAAM;IACJ,QAAQ,GAAG,CAAC,CA4BxB"}

package/src/engine/animation/removeEntityGenericEffect.js

@@ -1,160 +0,0 @@
-import { removeEntityWithEffect } from "./AnimationUtils.js";
-import { ParticleEmitter } from "../graphics/particles/particular/engine/emitter/ParticleEmitter.js";
-
-const lib = {
-    'cloud-puff': {
-        "receiveLight": true,
-        "parameters": [
-            {
-                "name": "scale",
-                "itemSize": 1,
-                "defaultTrackValue": {
-                    "itemSize": 1,
-                    "data": [
-                        1
-                    ],
-                    "positions": [
-                        0
-                    ]
-                }
-            },
-            {
-                "name": "color",
-                "itemSize": 4,
-                "defaultTrackValue": {
-                    "itemSize": 4,
-                    "data": [
-                        1,
-                        1,
-                        1,
-                        1
-                    ],
-                    "positions": [
-                        0
-                    ]
-                }
-            }
-        ],
-        "blendingMode": 0,
-        "layers": [
-            {
-                "imageURL": "data/textures/particle/smokeparticle.png",
-                "particleLife": {
-                    "min": 1.2,
-                    "max": 1.5
-                },
-                "particleSize": {
-                    "min": 1,
-                    "max": 1.2
-                },
-                "particleRotation": {
-                    "min": 0,
-                    "max": 0
-                },
-                "particleRotationSpeed": {
-                    "min": 0,
-                    "max": 0
-                },
-                "emissionShape": 1,
-                "emissionFrom": 1,
-                "emissionRate": 0,
-                "emissionImmediate": 25,
-                "parameterTracks": [
-                    {
-                        "name": "color",
-                        "track": {
-                            "itemSize": 4,
-                            "data": [
-                                0.6,
-                                0.6,
-                                0.6,
-                                0,
-
-                                0.6,
-                                0.6,
-                                0.6,
-                                1,
-
-                                0.6,
-                                0.6,
-                                0.6,
-                                0.5,
-
-                                0.6,
-                                0.6,
-                                0.6,
-                                0
-                            ],
-                            "positions": [
-                                0,
-                                0.07,
-                                0.8097826086956522,
-                                1
-                            ]
-                        }
-                    }
-                ],
-                "position": {
-                    "x": 0,
-                    "y": 0.6,
-                    "z": 0
-                },
-                "scale": {
-                    "x": 0.9,
-                    "y": 0.5,
-                    "z": 0.65
-                },
-                "particleVelocityDirection": {
-                    "direction": {
-                        "x": 0,
-                        "y": 1,
-                        "z": 0
-                    },
-                    "angle": 1.5
-                },
-                "particleSpeed": {
-                    "min": 0.2,
-                    "max": 0.5
-                }
-            }
-        ]
-    }
-};
-
-/**
- *
- * @param {Object} options
- * @param {Engine} options.engine
- * @param {EntityComponentDataset} options.ecd
- * @param {number} options.entity
- * @param {string} [options.particles]
- * @param {string} [options.sound]
- * @returns {Promise<any>}
- */
-export function removeEntityGenericEffect(
-    {
-        engine,
-        ecd,
-        entity,
-        particles = 'cloud-puff',
-        sound = "data/sounds/effects/Magic_Game_Essentials/Magic_Vanish_3.wav"
-    }
-) {
-
-    const particle_json = lib[particles];
-
-    if (particle_json === undefined) {
-        throw new Error(`Unsupported particle ID '${particles}'`);
-    }
-
-    const emitter = ParticleEmitter.fromJSON(particle_json);
-
-    const result = removeEntityWithEffect({
-        entity,
-        ecd,
-        emitter,
-        soundEffect: sound
-    });
-
-    return result;
-}

package/src/engine/animation/removeEntityWithMeshParticlesEffect.d.ts

@@ -1,16 +0,0 @@
-/**
- *
- * @param {Object} options
- * @param {EntityManager} options.entityManager
- * @param {EntityComponentDataset} options.ecd
- * @param {number} options.entity
- * @param {string} options.particles
- * @returns {Promise<any>}
- */
-export function removeEntityWithMeshParticlesEffect({ entityManager, ecd, entity, particles }: {
-    entityManager: EntityManager;
-    ecd: EntityComponentDataset;
-    entity: number;
-    particles: string;
-}): Promise<any>;
-//# sourceMappingURL=removeEntityWithMeshParticlesEffect.d.ts.map

package/src/engine/animation/removeEntityWithMeshParticlesEffect.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"removeEntityWithMeshParticlesEffect.d.ts","sourceRoot":"","sources":["../../../../src/engine/animation/removeEntityWithMeshParticlesEffect.js"],"names":[],"mappings":"AA2IA;;;;;;;;GAQG;AACH;IANkC,aAAa;IACJ,GAAG;IACnB,MAAM,EAAtB,MAAM;IACU,SAAS,EAAzB,MAAM;IACJ,QAAQ,GAAG,CAAC,CA+CxB"}