@tsparticles/updater-color 3.0.0-alpha.1 → 3.0.0-beta.0

package/README.md

@@ -2,9 +2,9 @@
 
 # tsParticles Color Updater
 
-[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/tsparticles-updater-color/badge)](https://www.jsdelivr.com/package/npm/tsparticles-updater-color)
-[![npmjs](https://badge.fury.io/js/tsparticles-updater-color.svg)](https://www.npmjs.com/package/tsparticles-updater-color)
-[![npmjs](https://img.shields.io/npm/dt/tsparticles-updater-color)](https://www.npmjs.com/package/tsparticles-updater-color) [![GitHub Sponsors](https://img.shields.io/github/sponsors/matteobruni)](https://github.com/sponsors/matteobruni)
+[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/@tsparticles/updater-color/badge)](https://www.jsdelivr.com/package/npm/@tsparticles/updater-color)
+[![npmjs](https://badge.fury.io/js/@tsparticles/updater-color.svg)](https://www.npmjs.com/package/@tsparticles/updater-color)
+[![npmjs](https://img.shields.io/npm/dt/@tsparticles/updater-color)](https://www.npmjs.com/package/@tsparticles/updater-color) [![GitHub Sponsors](https://img.shields.io/github/sponsors/matteobruni)](https://github.com/sponsors/matteobruni)
 
 [tsParticles](https://github.com/matteobruni/tsparticles) updater plugin for color animations.
 
@@ -26,7 +26,7 @@ Once the scripts are loaded you can set up `tsParticles` and the updater plugin
 
 ```javascript
 (async () => {
-  await loadColorUpdater();
+  await loadColorUpdater(tsParticles);
 
   await tsParticles.load({
     id: "tsparticles",
@@ -42,29 +42,33 @@ Once the scripts are loaded you can set up `tsParticles` and the updater plugin
 This package is compatible also with ES or CommonJS modules, firstly this needs to be installed, like this:
 
 ```shell
-$ npm install tsparticles-updater-color
+$ npm install @tsparticles/updater-color
 ```
 
 or
 
 ```shell
-$ yarn add tsparticles-updater-color
+$ yarn add @tsparticles/updater-color
 ```
 
 Then you need to import it in the app, like this:
 
 ```javascript
-const { tsParticles } = require("tsparticles-engine");
-const { loadColorUpdater } = require("tsparticles-updater-color");
+const { tsParticles } = require("@tsparticles/engine");
+const { loadColorUpdater } = require("@tsparticles/updater-color");
 
-loadColorUpdater(tsParticles);
+(async () => {
+  await loadColorUpdater(tsParticles);
+})();
 ```
 
 or
 
 ```javascript
-import { tsParticles } from "tsparticles-engine";
-import { loadColorUpdater } from "tsparticles-updater-color";
+import { tsParticles } from "@tsparticles/engine";
+import { loadColorUpdater } from "@tsparticles/updater-color";
 
-loadColorUpdater(tsParticles);
+(async () => {
+  await loadColorUpdater(tsParticles);
+})();
 ```

package/browser/ColorUpdater.js

@@ -1,61 +1,5 @@
-import { getHslAnimationFromHsl, randomInRange, rangeColorToHsl } from "@tsparticles/engine";
-function updateColorValue(delta, value, valueAnimation, max, decrease) {
-    var _a, _b;
-    const colorValue = value;
-    if (!colorValue ||
-        !valueAnimation.enable ||
-        (colorValue.loops !== undefined &&
-            colorValue.maxLoops !== undefined &&
-            colorValue.maxLoops > 0 &&
-            colorValue.loops >= colorValue.maxLoops)) {
-        return;
-    }
-    const offset = randomInRange(valueAnimation.offset), velocity = ((_a = value.velocity) !== null && _a !== void 0 ? _a : 0) * delta.factor + offset * 3.6, decay = (_b = value.decay) !== null && _b !== void 0 ? _b : 1;
-    if (!decrease || colorValue.status === "increasing") {
-        colorValue.value += velocity;
-        if (colorValue.value > max) {
-            if (!colorValue.loops) {
-                colorValue.loops = 0;
-            }
-            colorValue.loops++;
-            if (decrease) {
-                colorValue.status = "decreasing";
-                colorValue.value -= colorValue.value % max;
-            }
-        }
-    }
-    else {
-        colorValue.value -= velocity;
-        if (colorValue.value < 0) {
-            if (!colorValue.loops) {
-                colorValue.loops = 0;
-            }
-            colorValue.loops++;
-            colorValue.status = "increasing";
-            colorValue.value += colorValue.value;
-        }
-    }
-    if (colorValue.velocity && decay !== 1) {
-        colorValue.velocity *= decay;
-    }
-    if (colorValue.value > max) {
-        colorValue.value %= max;
-    }
-}
-function updateColor(particle, delta) {
-    var _a, _b, _c;
-    const animationOptions = particle.options.color.animation;
-    const h = (_a = particle.color) === null || _a === void 0 ? void 0 : _a.h, s = (_b = particle.color) === null || _b === void 0 ? void 0 : _b.s, l = (_c = particle.color) === null || _c === void 0 ? void 0 : _c.l;
-    if (h) {
-        updateColorValue(delta, h, animationOptions.h, 360, false);
-    }
-    if (s) {
-        updateColorValue(delta, s, animationOptions.s, 100, true);
-    }
-    if (l) {
-        updateColorValue(delta, l, animationOptions.l, 100, true);
-    }
-}
+import { getHslAnimationFromHsl, rangeColorToHsl, } from "@tsparticles/engine";
+import { updateColor } from "./Utils";
 export class ColorUpdater {
     constructor(container) {
         this.container = container;
@@ -67,13 +11,12 @@ export class ColorUpdater {
         }
     }
     isEnabled(particle) {
-        var _a, _b, _c;
-        const animationOptions = particle.options.color.animation;
+        const { h: hAnimation, s: sAnimation, l: lAnimation } = particle.options.color.animation, { color } = particle;
         return (!particle.destroyed &&
             !particle.spawning &&
-            ((((_a = particle.color) === null || _a === void 0 ? void 0 : _a.h.value) !== undefined && animationOptions.h.enable) ||
-                (((_b = particle.color) === null || _b === void 0 ? void 0 : _b.s.value) !== undefined && animationOptions.s.enable) ||
-                (((_c = particle.color) === null || _c === void 0 ? void 0 : _c.l.value) !== undefined && animationOptions.l.enable)));
+            ((color?.h.value !== undefined && hAnimation.enable) ||
+                (color?.s.value !== undefined && sAnimation.enable) ||
+                (color?.l.value !== undefined && lAnimation.enable)));
     }
     update(particle, delta) {
         updateColor(particle, delta);

package/browser/Utils.js

@@ -0,0 +1,64 @@
+import { randomInRange, } from "@tsparticles/engine";
+function updateColorValue(delta, colorValue, valueAnimation, max, decrease) {
+    if (!colorValue ||
+        !valueAnimation.enable ||
+        ((colorValue.maxLoops ?? 0) > 0 && (colorValue.loops ?? 0) > (colorValue.maxLoops ?? 0))) {
+        return;
+    }
+    if (!colorValue.time) {
+        colorValue.time = 0;
+    }
+    if ((colorValue.delayTime ?? 0) > 0 && colorValue.time < (colorValue.delayTime ?? 0)) {
+        colorValue.time += delta.value;
+    }
+    if ((colorValue.delayTime ?? 0) > 0 && colorValue.time < (colorValue.delayTime ?? 0)) {
+        return;
+    }
+    const offset = randomInRange(valueAnimation.offset), velocity = (colorValue.velocity ?? 0) * delta.factor + offset * 3.6, decay = colorValue.decay ?? 1;
+    if (!decrease || colorValue.status === "increasing") {
+        colorValue.value += velocity;
+        if (colorValue.value > max) {
+            if (!colorValue.loops) {
+                colorValue.loops = 0;
+            }
+            colorValue.loops++;
+            if (decrease) {
+                colorValue.status = "decreasing";
+                colorValue.value -= colorValue.value % max;
+            }
+        }
+    }
+    else {
+        colorValue.value -= velocity;
+        if (colorValue.value < 0) {
+            if (!colorValue.loops) {
+                colorValue.loops = 0;
+            }
+            colorValue.loops++;
+            colorValue.status = "increasing";
+            colorValue.value += colorValue.value;
+        }
+    }
+    if (colorValue.velocity && decay !== 1) {
+        colorValue.velocity *= decay;
+    }
+    if (colorValue.value > max) {
+        colorValue.value %= max;
+    }
+}
+export function updateColor(particle, delta) {
+    const { h: hAnimation, s: sAnimation, l: lAnimation } = particle.options.color.animation, { color } = particle;
+    if (!color) {
+        return;
+    }
+    const { h, s, l } = color;
+    if (h) {
+        updateColorValue(delta, h, hAnimation, 360, false);
+    }
+    if (s) {
+        updateColorValue(delta, s, sAnimation, 100, true);
+    }
+    if (l) {
+        updateColorValue(delta, l, lAnimation, 100, true);
+    }
+}

package/browser/index.js

@@ -1,4 +1,4 @@
 import { ColorUpdater } from "./ColorUpdater";
-export async function loadColorUpdater(engine) {
-    await engine.addParticleUpdater("color", (container) => new ColorUpdater(container));
+export async function loadColorUpdater(engine, refresh = true) {
+    await engine.addParticleUpdater("color", (container) => new ColorUpdater(container), refresh);
 }

package/cjs/ColorUpdater.js

@@ -2,63 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ColorUpdater = void 0;
 const engine_1 = require("@tsparticles/engine");
-function updateColorValue(delta, value, valueAnimation, max, decrease) {
-    var _a, _b;
-    const colorValue = value;
-    if (!colorValue ||
-        !valueAnimation.enable ||
-        (colorValue.loops !== undefined &&
-            colorValue.maxLoops !== undefined &&
-            colorValue.maxLoops > 0 &&
-            colorValue.loops >= colorValue.maxLoops)) {
-        return;
-    }
-    const offset = (0, engine_1.randomInRange)(valueAnimation.offset), velocity = ((_a = value.velocity) !== null && _a !== void 0 ? _a : 0) * delta.factor + offset * 3.6, decay = (_b = value.decay) !== null && _b !== void 0 ? _b : 1;
-    if (!decrease || colorValue.status === "increasing") {
-        colorValue.value += velocity;
-        if (colorValue.value > max) {
-            if (!colorValue.loops) {
-                colorValue.loops = 0;
-            }
-            colorValue.loops++;
-            if (decrease) {
-                colorValue.status = "decreasing";
-                colorValue.value -= colorValue.value % max;
-            }
-        }
-    }
-    else {
-        colorValue.value -= velocity;
-        if (colorValue.value < 0) {
-            if (!colorValue.loops) {
-                colorValue.loops = 0;
-            }
-            colorValue.loops++;
-            colorValue.status = "increasing";
-            colorValue.value += colorValue.value;
-        }
-    }
-    if (colorValue.velocity && decay !== 1) {
-        colorValue.velocity *= decay;
-    }
-    if (colorValue.value > max) {
-        colorValue.value %= max;
-    }
-}
-function updateColor(particle, delta) {
-    var _a, _b, _c;
-    const animationOptions = particle.options.color.animation;
-    const h = (_a = particle.color) === null || _a === void 0 ? void 0 : _a.h, s = (_b = particle.color) === null || _b === void 0 ? void 0 : _b.s, l = (_c = particle.color) === null || _c === void 0 ? void 0 : _c.l;
-    if (h) {
-        updateColorValue(delta, h, animationOptions.h, 360, false);
-    }
-    if (s) {
-        updateColorValue(delta, s, animationOptions.s, 100, true);
-    }
-    if (l) {
-        updateColorValue(delta, l, animationOptions.l, 100, true);
-    }
-}
+const Utils_1 = require("./Utils");
 class ColorUpdater {
     constructor(container) {
         this.container = container;
@@ -70,16 +14,15 @@ class ColorUpdater {
         }
     }
     isEnabled(particle) {
-        var _a, _b, _c;
-        const animationOptions = particle.options.color.animation;
+        const { h: hAnimation, s: sAnimation, l: lAnimation } = particle.options.color.animation, { color } = particle;
         return (!particle.destroyed &&
             !particle.spawning &&
-            ((((_a = particle.color) === null || _a === void 0 ? void 0 : _a.h.value) !== undefined && animationOptions.h.enable) ||
-                (((_b = particle.color) === null || _b === void 0 ? void 0 : _b.s.value) !== undefined && animationOptions.s.enable) ||
-                (((_c = particle.color) === null || _c === void 0 ? void 0 : _c.l.value) !== undefined && animationOptions.l.enable)));
+            ((color?.h.value !== undefined && hAnimation.enable) ||
+                (color?.s.value !== undefined && sAnimation.enable) ||
+                (color?.l.value !== undefined && lAnimation.enable)));
     }
     update(particle, delta) {
-        updateColor(particle, delta);
+        (0, Utils_1.updateColor)(particle, delta);
     }
 }
 exports.ColorUpdater = ColorUpdater;

package/cjs/Utils.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateColor = void 0;
+const engine_1 = require("@tsparticles/engine");
+function updateColorValue(delta, colorValue, valueAnimation, max, decrease) {
+    if (!colorValue ||
+        !valueAnimation.enable ||
+        ((colorValue.maxLoops ?? 0) > 0 && (colorValue.loops ?? 0) > (colorValue.maxLoops ?? 0))) {
+        return;
+    }
+    if (!colorValue.time) {
+        colorValue.time = 0;
+    }
+    if ((colorValue.delayTime ?? 0) > 0 && colorValue.time < (colorValue.delayTime ?? 0)) {
+        colorValue.time += delta.value;
+    }
+    if ((colorValue.delayTime ?? 0) > 0 && colorValue.time < (colorValue.delayTime ?? 0)) {
+        return;
+    }
+    const offset = (0, engine_1.randomInRange)(valueAnimation.offset), velocity = (colorValue.velocity ?? 0) * delta.factor + offset * 3.6, decay = colorValue.decay ?? 1;
+    if (!decrease || colorValue.status === "increasing") {
+        colorValue.value += velocity;
+        if (colorValue.value > max) {
+            if (!colorValue.loops) {
+                colorValue.loops = 0;
+            }
+            colorValue.loops++;
+            if (decrease) {
+                colorValue.status = "decreasing";
+                colorValue.value -= colorValue.value % max;
+            }
+        }
+    }
+    else {
+        colorValue.value -= velocity;
+        if (colorValue.value < 0) {
+            if (!colorValue.loops) {
+                colorValue.loops = 0;
+            }
+            colorValue.loops++;
+            colorValue.status = "increasing";
+            colorValue.value += colorValue.value;
+        }
+    }
+    if (colorValue.velocity && decay !== 1) {
+        colorValue.velocity *= decay;
+    }
+    if (colorValue.value > max) {
+        colorValue.value %= max;
+    }
+}
+function updateColor(particle, delta) {
+    const { h: hAnimation, s: sAnimation, l: lAnimation } = particle.options.color.animation, { color } = particle;
+    if (!color) {
+        return;
+    }
+    const { h, s, l } = color;
+    if (h) {
+        updateColorValue(delta, h, hAnimation, 360, false);
+    }
+    if (s) {
+        updateColorValue(delta, s, sAnimation, 100, true);
+    }
+    if (l) {
+        updateColorValue(delta, l, lAnimation, 100, true);
+    }
+}
+exports.updateColor = updateColor;

package/cjs/index.js

@@ -1,19 +1,8 @@
 "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.loadColorUpdater = void 0;
 const ColorUpdater_1 = require("./ColorUpdater");
-function loadColorUpdater(engine) {
-    return __awaiter(this, void 0, void 0, function* () {
-        yield engine.addParticleUpdater("color", (container) => new ColorUpdater_1.ColorUpdater(container));
-    });
+async function loadColorUpdater(engine, refresh = true) {
+    await engine.addParticleUpdater("color", (container) => new ColorUpdater_1.ColorUpdater(container), refresh);
 }
 exports.loadColorUpdater = loadColorUpdater;

package/esm/ColorUpdater.js

@@ -1,61 +1,5 @@
-import { getHslAnimationFromHsl, randomInRange, rangeColorToHsl } from "@tsparticles/engine";
-function updateColorValue(delta, value, valueAnimation, max, decrease) {
-    var _a, _b;
-    const colorValue = value;
-    if (!colorValue ||
-        !valueAnimation.enable ||
-        (colorValue.loops !== undefined &&
-            colorValue.maxLoops !== undefined &&
-            colorValue.maxLoops > 0 &&
-            colorValue.loops >= colorValue.maxLoops)) {
-        return;
-    }
-    const offset = randomInRange(valueAnimation.offset), velocity = ((_a = value.velocity) !== null && _a !== void 0 ? _a : 0) * delta.factor + offset * 3.6, decay = (_b = value.decay) !== null && _b !== void 0 ? _b : 1;
-    if (!decrease || colorValue.status === "increasing") {
-        colorValue.value += velocity;
-        if (colorValue.value > max) {
-            if (!colorValue.loops) {
-                colorValue.loops = 0;
-            }
-            colorValue.loops++;
-            if (decrease) {
-                colorValue.status = "decreasing";
-                colorValue.value -= colorValue.value % max;
-            }
-        }
-    }
-    else {
-        colorValue.value -= velocity;
-        if (colorValue.value < 0) {
-            if (!colorValue.loops) {
-                colorValue.loops = 0;
-            }
-            colorValue.loops++;
-            colorValue.status = "increasing";
-            colorValue.value += colorValue.value;
-        }
-    }
-    if (colorValue.velocity && decay !== 1) {
-        colorValue.velocity *= decay;
-    }
-    if (colorValue.value > max) {
-        colorValue.value %= max;
-    }
-}
-function updateColor(particle, delta) {
-    var _a, _b, _c;
-    const animationOptions = particle.options.color.animation;
-    const h = (_a = particle.color) === null || _a === void 0 ? void 0 : _a.h, s = (_b = particle.color) === null || _b === void 0 ? void 0 : _b.s, l = (_c = particle.color) === null || _c === void 0 ? void 0 : _c.l;
-    if (h) {
-        updateColorValue(delta, h, animationOptions.h, 360, false);
-    }
-    if (s) {
-        updateColorValue(delta, s, animationOptions.s, 100, true);
-    }
-    if (l) {
-        updateColorValue(delta, l, animationOptions.l, 100, true);
-    }
-}
+import { getHslAnimationFromHsl, rangeColorToHsl, } from "@tsparticles/engine";
+import { updateColor } from "./Utils";
 export class ColorUpdater {
     constructor(container) {
         this.container = container;
@@ -67,13 +11,12 @@ export class ColorUpdater {
         }
     }
     isEnabled(particle) {
-        var _a, _b, _c;
-        const animationOptions = particle.options.color.animation;
+        const { h: hAnimation, s: sAnimation, l: lAnimation } = particle.options.color.animation, { color } = particle;
         return (!particle.destroyed &&
             !particle.spawning &&
-            ((((_a = particle.color) === null || _a === void 0 ? void 0 : _a.h.value) !== undefined && animationOptions.h.enable) ||
-                (((_b = particle.color) === null || _b === void 0 ? void 0 : _b.s.value) !== undefined && animationOptions.s.enable) ||
-                (((_c = particle.color) === null || _c === void 0 ? void 0 : _c.l.value) !== undefined && animationOptions.l.enable)));
+            ((color?.h.value !== undefined && hAnimation.enable) ||
+                (color?.s.value !== undefined && sAnimation.enable) ||
+                (color?.l.value !== undefined && lAnimation.enable)));
     }
     update(particle, delta) {
         updateColor(particle, delta);

package/esm/Utils.js

@@ -0,0 +1,64 @@
+import { randomInRange, } from "@tsparticles/engine";
+function updateColorValue(delta, colorValue, valueAnimation, max, decrease) {
+    if (!colorValue ||
+        !valueAnimation.enable ||
+        ((colorValue.maxLoops ?? 0) > 0 && (colorValue.loops ?? 0) > (colorValue.maxLoops ?? 0))) {
+        return;
+    }
+    if (!colorValue.time) {
+        colorValue.time = 0;
+    }
+    if ((colorValue.delayTime ?? 0) > 0 && colorValue.time < (colorValue.delayTime ?? 0)) {
+        colorValue.time += delta.value;
+    }
+    if ((colorValue.delayTime ?? 0) > 0 && colorValue.time < (colorValue.delayTime ?? 0)) {
+        return;
+    }
+    const offset = randomInRange(valueAnimation.offset), velocity = (colorValue.velocity ?? 0) * delta.factor + offset * 3.6, decay = colorValue.decay ?? 1;
+    if (!decrease || colorValue.status === "increasing") {
+        colorValue.value += velocity;
+        if (colorValue.value > max) {
+            if (!colorValue.loops) {
+                colorValue.loops = 0;
+            }
+            colorValue.loops++;
+            if (decrease) {
+                colorValue.status = "decreasing";
+                colorValue.value -= colorValue.value % max;
+            }
+        }
+    }
+    else {
+        colorValue.value -= velocity;
+        if (colorValue.value < 0) {
+            if (!colorValue.loops) {
+                colorValue.loops = 0;
+            }
+            colorValue.loops++;
+            colorValue.status = "increasing";
+            colorValue.value += colorValue.value;
+        }
+    }
+    if (colorValue.velocity && decay !== 1) {
+        colorValue.velocity *= decay;
+    }
+    if (colorValue.value > max) {
+        colorValue.value %= max;
+    }
+}
+export function updateColor(particle, delta) {
+    const { h: hAnimation, s: sAnimation, l: lAnimation } = particle.options.color.animation, { color } = particle;
+    if (!color) {
+        return;
+    }
+    const { h, s, l } = color;
+    if (h) {
+        updateColorValue(delta, h, hAnimation, 360, false);
+    }
+    if (s) {
+        updateColorValue(delta, s, sAnimation, 100, true);
+    }
+    if (l) {
+        updateColorValue(delta, l, lAnimation, 100, true);
+    }
+}

package/esm/index.js

@@ -1,4 +1,4 @@
 import { ColorUpdater } from "./ColorUpdater";
-export async function loadColorUpdater(engine) {
-    await engine.addParticleUpdater("color", (container) => new ColorUpdater(container));
+export async function loadColorUpdater(engine, refresh = true) {
+    await engine.addParticleUpdater("color", (container) => new ColorUpdater(container), refresh);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/updater-color",
-  "version": "3.0.0-alpha.1",
+  "version": "3.0.0-beta.0",
   "description": "tsParticles particles color updater",
   "homepage": "https://particles.js.org",
   "repository": {
@@ -73,10 +73,11 @@
   "unpkg": "tsparticles.updater.color.min.js",
   "module": "esm/index.js",
   "types": "types/index.d.ts",
+  "sideEffects": false,
+  "dependencies": {
+    "@tsparticles/engine": "^3.0.0-beta.0"
+  },
   "publishConfig": {
     "access": "public"
-  },
-  "dependencies": {
-    "@tsparticles/engine": "^3.0.0-alpha.1"
   }
-}
+}