@tsparticles/updater-life 3.0.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Matteo Bruni
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+[![banner](https://particles.js.org/images/banner2.png)](https://particles.js.org)
+
+# tsParticles Life Updater
+
+[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/tsparticles-updater-life/badge)](https://www.jsdelivr.com/package/npm/tsparticles-updater-life)
+[![npmjs](https://badge.fury.io/js/tsparticles-updater-life.svg)](https://www.npmjs.com/package/tsparticles-updater-life)
+[![npmjs](https://img.shields.io/npm/dt/tsparticles-updater-life)](https://www.npmjs.com/package/tsparticles-updater-life) [![GitHub Sponsors](https://img.shields.io/github/sponsors/matteobruni)](https://github.com/sponsors/matteobruni)
+
+[tsParticles](https://github.com/matteobruni/tsparticles) updater plugin for life animations.
+
+## How to use it
+
+### CDN / Vanilla JS / jQuery
+
+The CDN/Vanilla version JS has one required file in vanilla configuration:
+
+Including the `tsparticles.updater.life.min.js` file will export the function to load the updater plugin:
+
+```javascript
+loadLifeUpdater;
+```
+
+### Usage
+
+Once the scripts are loaded you can set up `tsParticles` and the updater plugin like this:
+
+```javascript
+(async () => {
+  await loadLifeUpdater();
+
+  await tsParticles.load({
+    id: "tsparticles",
+    options: {
+      /* options */
+    },
+  });
+})();
+```
+
+### ESM / CommonJS
+
+This package is compatible also with ES or CommonJS modules, firstly this needs to be installed, like this:
+
+```shell
+$ npm install tsparticles-updater-life
+```
+
+or
+
+```shell
+$ yarn add tsparticles-updater-life
+```
+
+Then you need to import it in the app, like this:
+
+```javascript
+const { tsParticles } = require("tsparticles-engine");
+const { loadLifeUpdater } = require("tsparticles-updater-life");
+
+loadLifeUpdater(tsParticles);
+```
+
+or
+
+```javascript
+import { tsParticles } from "tsparticles-engine";
+import { loadLifeUpdater } from "tsparticles-updater-life";
+
+loadLifeUpdater(tsParticles);
+```

package/browser/LifeUpdater.js

@@ -0,0 +1,102 @@
+import { getRandom, getRangeValue, randomInRange, setRangeValue } from "@tsparticles/engine";
+import { Life } from "./Options/Classes/Life";
+export class LifeUpdater {
+    constructor(container) {
+        this.container = container;
+    }
+    init(particle) {
+        const container = this.container, particlesOptions = particle.options, lifeOptions = particlesOptions.life;
+        if (!lifeOptions) {
+            return;
+        }
+        particle.life = {
+            delay: container.retina.reduceFactor
+                ? ((getRangeValue(lifeOptions.delay.value) * (lifeOptions.delay.sync ? 1 : getRandom())) /
+                    container.retina.reduceFactor) *
+                    1000
+                : 0,
+            delayTime: 0,
+            duration: container.retina.reduceFactor
+                ? ((getRangeValue(lifeOptions.duration.value) * (lifeOptions.duration.sync ? 1 : getRandom())) /
+                    container.retina.reduceFactor) *
+                    1000
+                : 0,
+            time: 0,
+            count: lifeOptions.count,
+        };
+        if (particle.life.duration <= 0) {
+            particle.life.duration = -1;
+        }
+        if (particle.life.count <= 0) {
+            particle.life.count = -1;
+        }
+        if (particle.life) {
+            particle.spawning = particle.life.delay > 0;
+        }
+    }
+    isEnabled(particle) {
+        return !particle.destroyed;
+    }
+    loadOptions(options, ...sources) {
+        if (!options.life) {
+            options.life = new Life();
+        }
+        for (const source of sources) {
+            options.life.load(source === null || source === void 0 ? void 0 : source.life);
+        }
+    }
+    update(particle, delta) {
+        if (!this.isEnabled(particle) || !particle.life) {
+            return;
+        }
+        const life = particle.life;
+        let justSpawned = false;
+        if (particle.spawning) {
+            life.delayTime += delta.value;
+            if (life.delayTime >= particle.life.delay) {
+                justSpawned = true;
+                particle.spawning = false;
+                life.delayTime = 0;
+                life.time = 0;
+            }
+            else {
+                return;
+            }
+        }
+        if (life.duration === -1) {
+            return;
+        }
+        if (particle.spawning) {
+            return;
+        }
+        if (justSpawned) {
+            life.time = 0;
+        }
+        else {
+            life.time += delta.value;
+        }
+        if (life.time < life.duration) {
+            return;
+        }
+        life.time = 0;
+        if (particle.life.count > 0) {
+            particle.life.count--;
+        }
+        if (particle.life.count === 0) {
+            particle.destroy();
+            return;
+        }
+        const canvasSize = this.container.canvas.size, widthRange = setRangeValue(0, canvasSize.width), heightRange = setRangeValue(0, canvasSize.width);
+        particle.position.x = randomInRange(widthRange);
+        particle.position.y = randomInRange(heightRange);
+        particle.spawning = true;
+        life.delayTime = 0;
+        life.time = 0;
+        particle.reset();
+        const lifeOptions = particle.options.life;
+        if (lifeOptions) {
+            life.delay = getRangeValue(lifeOptions.delay.value) * 1000;
+            life.duration = getRangeValue(lifeOptions.duration.value) * 1000;
+        }
+    }
+}

package/browser/Options/Classes/Life.js

@@ -0,0 +1,19 @@
+import { LifeDelay } from "./LifeDelay";
+import { LifeDuration } from "./LifeDuration";
+export class Life {
+    constructor() {
+        this.count = 0;
+        this.delay = new LifeDelay();
+        this.duration = new LifeDuration();
+    }
+    load(data) {
+        if (!data) {
+            return;
+        }
+        if (data.count !== undefined) {
+            this.count = data.count;
+        }
+        this.delay.load(data.delay);
+        this.duration.load(data.duration);
+    }
+}

package/browser/Options/Classes/LifeDelay.js

@@ -0,0 +1,16 @@
+import { ValueWithRandom } from "@tsparticles/engine";
+export class LifeDelay extends ValueWithRandom {
+    constructor() {
+        super();
+        this.sync = false;
+    }
+    load(data) {
+        if (!data) {
+            return;
+        }
+        super.load(data);
+        if (data.sync !== undefined) {
+            this.sync = data.sync;
+        }
+    }
+}

package/browser/Options/Classes/LifeDuration.js

@@ -0,0 +1,17 @@
+import { ValueWithRandom } from "@tsparticles/engine";
+export class LifeDuration extends ValueWithRandom {
+    constructor() {
+        super();
+        this.random.minimumValue = 0.0001;
+        this.sync = false;
+    }
+    load(data) {
+        if (!data) {
+            return;
+        }
+        super.load(data);
+        if (data.sync !== undefined) {
+            this.sync = data.sync;
+        }
+    }
+}

package/browser/Options/Interfaces/ILife.js

@@ -0,0 +1 @@
+export {};

package/browser/Options/Interfaces/ILifeDelay.js

@@ -0,0 +1 @@
+export {};

package/browser/Options/Interfaces/ILifeDuration.js

@@ -0,0 +1 @@
+export {};

package/browser/index.js

@@ -0,0 +1,4 @@
+import { LifeUpdater } from "./LifeUpdater";
+export async function loadLifeUpdater(engine) {
+    await engine.addParticleUpdater("life", (container) => new LifeUpdater(container));
+}

package/cjs/LifeUpdater.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LifeUpdater = void 0;
+const engine_1 = require("@tsparticles/engine");
+const Life_1 = require("./Options/Classes/Life");
+class LifeUpdater {
+    constructor(container) {
+        this.container = container;
+    }
+    init(particle) {
+        const container = this.container, particlesOptions = particle.options, lifeOptions = particlesOptions.life;
+        if (!lifeOptions) {
+            return;
+        }
+        particle.life = {
+            delay: container.retina.reduceFactor
+                ? (((0, engine_1.getRangeValue)(lifeOptions.delay.value) * (lifeOptions.delay.sync ? 1 : (0, engine_1.getRandom)())) /
+                    container.retina.reduceFactor) *
+                    1000
+                : 0,
+            delayTime: 0,
+            duration: container.retina.reduceFactor
+                ? (((0, engine_1.getRangeValue)(lifeOptions.duration.value) * (lifeOptions.duration.sync ? 1 : (0, engine_1.getRandom)())) /
+                    container.retina.reduceFactor) *
+                    1000
+                : 0,
+            time: 0,
+            count: lifeOptions.count,
+        };
+        if (particle.life.duration <= 0) {
+            particle.life.duration = -1;
+        }
+        if (particle.life.count <= 0) {
+            particle.life.count = -1;
+        }
+        if (particle.life) {
+            particle.spawning = particle.life.delay > 0;
+        }
+    }
+    isEnabled(particle) {
+        return !particle.destroyed;
+    }
+    loadOptions(options, ...sources) {
+        if (!options.life) {
+            options.life = new Life_1.Life();
+        }
+        for (const source of sources) {
+            options.life.load(source === null || source === void 0 ? void 0 : source.life);
+        }
+    }
+    update(particle, delta) {
+        if (!this.isEnabled(particle) || !particle.life) {
+            return;
+        }
+        const life = particle.life;
+        let justSpawned = false;
+        if (particle.spawning) {
+            life.delayTime += delta.value;
+            if (life.delayTime >= particle.life.delay) {
+                justSpawned = true;
+                particle.spawning = false;
+                life.delayTime = 0;
+                life.time = 0;
+            }
+            else {
+                return;
+            }
+        }
+        if (life.duration === -1) {
+            return;
+        }
+        if (particle.spawning) {
+            return;
+        }
+        if (justSpawned) {
+            life.time = 0;
+        }
+        else {
+            life.time += delta.value;
+        }
+        if (life.time < life.duration) {
+            return;
+        }
+        life.time = 0;
+        if (particle.life.count > 0) {
+            particle.life.count--;
+        }
+        if (particle.life.count === 0) {
+            particle.destroy();
+            return;
+        }
+        const canvasSize = this.container.canvas.size, widthRange = (0, engine_1.setRangeValue)(0, canvasSize.width), heightRange = (0, engine_1.setRangeValue)(0, canvasSize.width);
+        particle.position.x = (0, engine_1.randomInRange)(widthRange);
+        particle.position.y = (0, engine_1.randomInRange)(heightRange);
+        particle.spawning = true;
+        life.delayTime = 0;
+        life.time = 0;
+        particle.reset();
+        const lifeOptions = particle.options.life;
+        if (lifeOptions) {
+            life.delay = (0, engine_1.getRangeValue)(lifeOptions.delay.value) * 1000;
+            life.duration = (0, engine_1.getRangeValue)(lifeOptions.duration.value) * 1000;
+        }
+    }
+}
+exports.LifeUpdater = LifeUpdater;

package/cjs/Options/Classes/Life.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Life = void 0;
+const LifeDelay_1 = require("./LifeDelay");
+const LifeDuration_1 = require("./LifeDuration");
+class Life {
+    constructor() {
+        this.count = 0;
+        this.delay = new LifeDelay_1.LifeDelay();
+        this.duration = new LifeDuration_1.LifeDuration();
+    }
+    load(data) {
+        if (!data) {
+            return;
+        }
+        if (data.count !== undefined) {
+            this.count = data.count;
+        }
+        this.delay.load(data.delay);
+        this.duration.load(data.duration);
+    }
+}
+exports.Life = Life;

package/cjs/Options/Classes/LifeDelay.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LifeDelay = void 0;
+const engine_1 = require("@tsparticles/engine");
+class LifeDelay extends engine_1.ValueWithRandom {
+    constructor() {
+        super();
+        this.sync = false;
+    }
+    load(data) {
+        if (!data) {
+            return;
+        }
+        super.load(data);
+        if (data.sync !== undefined) {
+            this.sync = data.sync;
+        }
+    }
+}
+exports.LifeDelay = LifeDelay;

package/cjs/Options/Classes/LifeDuration.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LifeDuration = void 0;
+const engine_1 = require("@tsparticles/engine");
+class LifeDuration extends engine_1.ValueWithRandom {
+    constructor() {
+        super();
+        this.random.minimumValue = 0.0001;
+        this.sync = false;
+    }
+    load(data) {
+        if (!data) {
+            return;
+        }
+        super.load(data);
+        if (data.sync !== undefined) {
+            this.sync = data.sync;
+        }
+    }
+}
+exports.LifeDuration = LifeDuration;

package/cjs/Options/Interfaces/ILife.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/Options/Interfaces/ILifeDelay.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/Options/Interfaces/ILifeDuration.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadLifeUpdater = void 0;
+const LifeUpdater_1 = require("./LifeUpdater");
+function loadLifeUpdater(engine) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield engine.addParticleUpdater("life", (container) => new LifeUpdater_1.LifeUpdater(container));
+    });
+}
+exports.loadLifeUpdater = loadLifeUpdater;

package/esm/LifeUpdater.js

@@ -0,0 +1,102 @@
+import { getRandom, getRangeValue, randomInRange, setRangeValue } from "@tsparticles/engine";
+import { Life } from "./Options/Classes/Life";
+export class LifeUpdater {
+    constructor(container) {
+        this.container = container;
+    }
+    init(particle) {
+        const container = this.container, particlesOptions = particle.options, lifeOptions = particlesOptions.life;
+        if (!lifeOptions) {
+            return;
+        }
+        particle.life = {
+            delay: container.retina.reduceFactor
+                ? ((getRangeValue(lifeOptions.delay.value) * (lifeOptions.delay.sync ? 1 : getRandom())) /
+                    container.retina.reduceFactor) *
+                    1000
+                : 0,
+            delayTime: 0,
+            duration: container.retina.reduceFactor
+                ? ((getRangeValue(lifeOptions.duration.value) * (lifeOptions.duration.sync ? 1 : getRandom())) /
+                    container.retina.reduceFactor) *
+                    1000
+                : 0,
+            time: 0,
+            count: lifeOptions.count,
+        };
+        if (particle.life.duration <= 0) {
+            particle.life.duration = -1;
+        }
+        if (particle.life.count <= 0) {
+            particle.life.count = -1;
+        }
+        if (particle.life) {
+            particle.spawning = particle.life.delay > 0;
+        }
+    }
+    isEnabled(particle) {
+        return !particle.destroyed;
+    }
+    loadOptions(options, ...sources) {
+        if (!options.life) {
+            options.life = new Life();
+        }
+        for (const source of sources) {
+            options.life.load(source === null || source === void 0 ? void 0 : source.life);
+        }
+    }
+    update(particle, delta) {
+        if (!this.isEnabled(particle) || !particle.life) {
+            return;
+        }
+        const life = particle.life;
+        let justSpawned = false;
+        if (particle.spawning) {
+            life.delayTime += delta.value;
+            if (life.delayTime >= particle.life.delay) {
+                justSpawned = true;
+                particle.spawning = false;
+                life.delayTime = 0;
+                life.time = 0;
+            }
+            else {
+                return;
+            }
+        }
+        if (life.duration === -1) {
+            return;
+        }
+        if (particle.spawning) {
+            return;
+        }
+        if (justSpawned) {
+            life.time = 0;
+        }
+        else {
+            life.time += delta.value;
+        }
+        if (life.time < life.duration) {
+            return;
+        }
+        life.time = 0;
+        if (particle.life.count > 0) {
+            particle.life.count--;
+        }
+        if (particle.life.count === 0) {
+            particle.destroy();
+            return;
+        }
+        const canvasSize = this.container.canvas.size, widthRange = setRangeValue(0, canvasSize.width), heightRange = setRangeValue(0, canvasSize.width);
+        particle.position.x = randomInRange(widthRange);
+        particle.position.y = randomInRange(heightRange);
+        particle.spawning = true;
+        life.delayTime = 0;
+        life.time = 0;
+        particle.reset();
+        const lifeOptions = particle.options.life;
+        if (lifeOptions) {
+            life.delay = getRangeValue(lifeOptions.delay.value) * 1000;
+            life.duration = getRangeValue(lifeOptions.duration.value) * 1000;
+        }
+    }
+}

package/esm/Options/Classes/Life.js

@@ -0,0 +1,19 @@
+import { LifeDelay } from "./LifeDelay";
+import { LifeDuration } from "./LifeDuration";
+export class Life {
+    constructor() {
+        this.count = 0;
+        this.delay = new LifeDelay();
+        this.duration = new LifeDuration();
+    }
+    load(data) {
+        if (!data) {
+            return;
+        }
+        if (data.count !== undefined) {
+            this.count = data.count;
+        }
+        this.delay.load(data.delay);
+        this.duration.load(data.duration);
+    }
+}

package/esm/Options/Classes/LifeDelay.js

@@ -0,0 +1,16 @@
+import { ValueWithRandom } from "@tsparticles/engine";
+export class LifeDelay extends ValueWithRandom {
+    constructor() {
+        super();
+        this.sync = false;
+    }
+    load(data) {
+        if (!data) {
+            return;
+        }
+        super.load(data);
+        if (data.sync !== undefined) {
+            this.sync = data.sync;
+        }
+    }
+}

package/esm/Options/Classes/LifeDuration.js

@@ -0,0 +1,17 @@
+import { ValueWithRandom } from "@tsparticles/engine";
+export class LifeDuration extends ValueWithRandom {
+    constructor() {
+        super();
+        this.random.minimumValue = 0.0001;
+        this.sync = false;
+    }
+    load(data) {
+        if (!data) {
+            return;
+        }
+        super.load(data);
+        if (data.sync !== undefined) {
+            this.sync = data.sync;
+        }
+    }
+}

package/esm/Options/Interfaces/ILife.js

@@ -0,0 +1 @@
+export {};

package/esm/Options/Interfaces/ILifeDelay.js

@@ -0,0 +1 @@
+export {};

package/esm/Options/Interfaces/ILifeDuration.js

@@ -0,0 +1 @@
+export {};

package/esm/index.js

@@ -0,0 +1,4 @@
+import { LifeUpdater } from "./LifeUpdater";
+export async function loadLifeUpdater(engine) {
+    await engine.addParticleUpdater("life", (container) => new LifeUpdater(container));
+}