@tsparticles/fireworks 4.1.3 → 4.2.0

package/browser/FireworkOptions.js

@@ -1,4 +1,4 @@
-import { isArray, isNull, setRangeValue, } from "@tsparticles/engine";
+import { isArray, isNull, loadProperty, loadRangeProperty, } from "@tsparticles/engine";
 export class FireworkOptions {
     background;
     brightness;
@@ -72,9 +72,6 @@ export class FireworkOptions {
         if (isNull(data)) {
             return;
         }
-        if (data.background !== undefined) {
-            this.background = data.background;
-        }
         if (data.colors !== undefined) {
             if (isArray(data.colors)) {
                 this.colors = [...data.colors];
@@ -83,29 +80,14 @@ export class FireworkOptions {
                 this.colors = data.colors;
             }
         }
-        if (data.brightness !== undefined) {
-            this.brightness = setRangeValue(data.brightness);
-        }
-        if (data.gravity !== undefined) {
-            this.gravity = setRangeValue(data.gravity);
-        }
-        if (data.minHeight !== undefined) {
-            this.minHeight = setRangeValue(data.minHeight);
-        }
-        if (data.rate !== undefined) {
-            this.rate = setRangeValue(data.rate);
-        }
-        if (data.saturation !== undefined) {
-            this.saturation = setRangeValue(data.saturation);
-        }
-        if (data.sounds !== undefined) {
-            this.sounds = data.sounds;
-        }
-        if (data.speed !== undefined) {
-            this.speed = setRangeValue(data.speed);
-        }
-        if (data.splitCount !== undefined) {
-            this.splitCount = setRangeValue(data.splitCount);
-        }
+        loadProperty(this, "background", data.background);
+        loadRangeProperty(this, "brightness", data.brightness);
+        loadRangeProperty(this, "gravity", data.gravity);
+        loadRangeProperty(this, "minHeight", data.minHeight);
+        loadRangeProperty(this, "rate", data.rate);
+        loadRangeProperty(this, "saturation", data.saturation);
+        loadProperty(this, "sounds", data.sounds);
+        loadRangeProperty(this, "speed", data.speed);
+        loadRangeProperty(this, "splitCount", data.splitCount);
     }
 }

package/browser/FireworksInstance.js

@@ -1,7 +1,17 @@
+import { deleteFireworksInstance } from "./utils.js";
 export class FireworksInstance {
     #container;
-    constructor(container) {
+    #id;
+    constructor(container, id) {
         this.#container = container;
+        this.#id = id;
+    }
+    get destroyed() {
+        return this.#container.destroyed;
+    }
+    destroy() {
+        this.#container.destroy();
+        deleteFireworksInstance(this.#id);
     }
     pause() {
         this.#container.pause();

package/browser/fireworks.js

@@ -12,7 +12,7 @@ import { loadRotateUpdater } from "@tsparticles/updater-rotate";
 import { loadSoundsPlugin } from "@tsparticles/plugin-sounds";
 let initPromise = null;
 async function doInitPlugins(engine) {
-    engine.checkVersion("4.1.3");
+    engine.checkVersion("4.2.0");
     await engine.pluginManager.register(async (e) => {
         const loadEmittersForFireworks = async (e) => {
             await loadEmittersPluginSimple(e);
@@ -59,5 +59,5 @@ fireworks.create = async (canvas, options) => {
 fireworks.init = async () => {
     await initPlugins(tsParticles);
 };
-fireworks.version = "4.1.3";
+fireworks.version = "4.2.0";
 globalThis.fireworks = fireworks;

package/browser/fireworks.lazy.js

@@ -2,7 +2,7 @@ import { isString, tsParticles } from "@tsparticles/engine/lazy";
 import { getFireworksInstance } from "./utils.js";
 let initPromise = null;
 async function doInitPlugins(engine) {
-    engine.checkVersion("4.1.3");
+    engine.checkVersion("4.2.0");
     await engine.pluginManager.register(async (e) => {
         const [{ loadBasic }, { loadLineShape }, { loadBlendPlugin }, { loadEmittersPluginSimple }, { loadEmittersShapeSquare }, { loadSoundsPlugin }, { loadRotateUpdater }, { loadDestroyUpdater }, { loadLifeUpdater }, { loadPaintUpdater },] = await Promise.all([
             import("@tsparticles/basic/lazy"),
@@ -60,5 +60,5 @@ fireworks.create = async (canvas, options) => {
 fireworks.init = async () => {
     await initPlugins(tsParticles);
 };
-fireworks.version = "4.1.3";
+fireworks.version = "4.2.0";
 globalThis.fireworks = fireworks;

package/browser/utils.js

@@ -1,6 +1,9 @@
 import { DestroyType, EventType, MoveDirection, OutMode, StartValueType, getRangeMax, getRangeMin, isNumber, setRangeValue, } from "@tsparticles/engine";
 import { FireworkOptions } from "./FireworkOptions.js";
 const instances = new Map();
+export function deleteFireworksInstance(id) {
+    instances.delete(id);
+}
 export const explodeSoundCheck = (args) => {
     const data = args.data;
     return data?.particle?.options.move.gravity.enable ?? false;
@@ -176,7 +179,10 @@ export async function getFireworksInstance(engine, id, sourceOptions, canvas) {
         return existing;
     }
     if (existing) {
-        return existing;
+        if (!existing.destroyed) {
+            return existing;
+        }
+        instances.delete(id);
     }
     const create = async () => {
         const options = new FireworkOptions();
@@ -186,7 +192,7 @@ export async function getFireworksInstance(engine, id, sourceOptions, canvas) {
             instances.delete(id);
             return;
         }
-        const { FireworksInstance } = await import("./FireworksInstance.js"), instance = new FireworksInstance(container);
+        const { FireworksInstance } = await import("./FireworksInstance.js"), instance = new FireworksInstance(container, id);
         instances.set(id, instance);
         return instance;
     }, createPromise = create();

package/cjs/FireworkOptions.js

@@ -1,4 +1,4 @@
-import { isArray, isNull, setRangeValue, } from "@tsparticles/engine";
+import { isArray, isNull, loadProperty, loadRangeProperty, } from "@tsparticles/engine";
 export class FireworkOptions {
     background;
     brightness;
@@ -72,9 +72,6 @@ export class FireworkOptions {
         if (isNull(data)) {
             return;
         }
-        if (data.background !== undefined) {
-            this.background = data.background;
-        }
         if (data.colors !== undefined) {
             if (isArray(data.colors)) {
                 this.colors = [...data.colors];
@@ -83,29 +80,14 @@ export class FireworkOptions {
                 this.colors = data.colors;
             }
         }
-        if (data.brightness !== undefined) {
-            this.brightness = setRangeValue(data.brightness);
-        }
-        if (data.gravity !== undefined) {
-            this.gravity = setRangeValue(data.gravity);
-        }
-        if (data.minHeight !== undefined) {
-            this.minHeight = setRangeValue(data.minHeight);
-        }
-        if (data.rate !== undefined) {
-            this.rate = setRangeValue(data.rate);
-        }
-        if (data.saturation !== undefined) {
-            this.saturation = setRangeValue(data.saturation);
-        }
-        if (data.sounds !== undefined) {
-            this.sounds = data.sounds;
-        }
-        if (data.speed !== undefined) {
-            this.speed = setRangeValue(data.speed);
-        }
-        if (data.splitCount !== undefined) {
-            this.splitCount = setRangeValue(data.splitCount);
-        }
+        loadProperty(this, "background", data.background);
+        loadRangeProperty(this, "brightness", data.brightness);
+        loadRangeProperty(this, "gravity", data.gravity);
+        loadRangeProperty(this, "minHeight", data.minHeight);
+        loadRangeProperty(this, "rate", data.rate);
+        loadRangeProperty(this, "saturation", data.saturation);
+        loadProperty(this, "sounds", data.sounds);
+        loadRangeProperty(this, "speed", data.speed);
+        loadRangeProperty(this, "splitCount", data.splitCount);
     }
 }

package/cjs/FireworksInstance.js

@@ -1,7 +1,17 @@
+import { deleteFireworksInstance } from "./utils.js";
 export class FireworksInstance {
     #container;
-    constructor(container) {
+    #id;
+    constructor(container, id) {
         this.#container = container;
+        this.#id = id;
+    }
+    get destroyed() {
+        return this.#container.destroyed;
+    }
+    destroy() {
+        this.#container.destroy();
+        deleteFireworksInstance(this.#id);
     }
     pause() {
         this.#container.pause();

package/cjs/fireworks.js

@@ -12,7 +12,7 @@ import { loadRotateUpdater } from "@tsparticles/updater-rotate";
 import { loadSoundsPlugin } from "@tsparticles/plugin-sounds";
 let initPromise = null;
 async function doInitPlugins(engine) {
-    engine.checkVersion("4.1.3");
+    engine.checkVersion("4.2.0");
     await engine.pluginManager.register(async (e) => {
         const loadEmittersForFireworks = async (e) => {
             await loadEmittersPluginSimple(e);
@@ -59,5 +59,5 @@ fireworks.create = async (canvas, options) => {
 fireworks.init = async () => {
     await initPlugins(tsParticles);
 };
-fireworks.version = "4.1.3";
+fireworks.version = "4.2.0";
 globalThis.fireworks = fireworks;

package/cjs/fireworks.lazy.js

@@ -2,7 +2,7 @@ import { isString, tsParticles } from "@tsparticles/engine/lazy";
 import { getFireworksInstance } from "./utils.js";
 let initPromise = null;
 async function doInitPlugins(engine) {
-    engine.checkVersion("4.1.3");
+    engine.checkVersion("4.2.0");
     await engine.pluginManager.register(async (e) => {
         const [{ loadBasic }, { loadLineShape }, { loadBlendPlugin }, { loadEmittersPluginSimple }, { loadEmittersShapeSquare }, { loadSoundsPlugin }, { loadRotateUpdater }, { loadDestroyUpdater }, { loadLifeUpdater }, { loadPaintUpdater },] = await Promise.all([
             import("@tsparticles/basic/lazy"),
@@ -60,5 +60,5 @@ fireworks.create = async (canvas, options) => {
 fireworks.init = async () => {
     await initPlugins(tsParticles);
 };
-fireworks.version = "4.1.3";
+fireworks.version = "4.2.0";
 globalThis.fireworks = fireworks;

package/cjs/utils.js

@@ -1,6 +1,9 @@
 import { DestroyType, EventType, MoveDirection, OutMode, StartValueType, getRangeMax, getRangeMin, isNumber, setRangeValue, } from "@tsparticles/engine";
 import { FireworkOptions } from "./FireworkOptions.js";
 const instances = new Map();
+export function deleteFireworksInstance(id) {
+    instances.delete(id);
+}
 export const explodeSoundCheck = (args) => {
     const data = args.data;
     return data?.particle?.options.move.gravity.enable ?? false;
@@ -176,7 +179,10 @@ export async function getFireworksInstance(engine, id, sourceOptions, canvas) {
         return existing;
     }
     if (existing) {
-        return existing;
+        if (!existing.destroyed) {
+            return existing;
+        }
+        instances.delete(id);
     }
     const create = async () => {
         const options = new FireworkOptions();
@@ -186,7 +192,7 @@ export async function getFireworksInstance(engine, id, sourceOptions, canvas) {
             instances.delete(id);
             return;
         }
-        const { FireworksInstance } = await import("./FireworksInstance.js"), instance = new FireworksInstance(container);
+        const { FireworksInstance } = await import("./FireworksInstance.js"), instance = new FireworksInstance(container, id);
         instances.set(id, instance);
         return instance;
     }, createPromise = create();

package/esm/FireworkOptions.js

@@ -1,4 +1,4 @@
-import { isArray, isNull, setRangeValue, } from "@tsparticles/engine";
+import { isArray, isNull, loadProperty, loadRangeProperty, } from "@tsparticles/engine";
 export class FireworkOptions {
     background;
     brightness;
@@ -72,9 +72,6 @@ export class FireworkOptions {
         if (isNull(data)) {
             return;
         }
-        if (data.background !== undefined) {
-            this.background = data.background;
-        }
         if (data.colors !== undefined) {
             if (isArray(data.colors)) {
                 this.colors = [...data.colors];
@@ -83,29 +80,14 @@ export class FireworkOptions {
                 this.colors = data.colors;
             }
         }
-        if (data.brightness !== undefined) {
-            this.brightness = setRangeValue(data.brightness);
-        }
-        if (data.gravity !== undefined) {
-            this.gravity = setRangeValue(data.gravity);
-        }
-        if (data.minHeight !== undefined) {
-            this.minHeight = setRangeValue(data.minHeight);
-        }
-        if (data.rate !== undefined) {
-            this.rate = setRangeValue(data.rate);
-        }
-        if (data.saturation !== undefined) {
-            this.saturation = setRangeValue(data.saturation);
-        }
-        if (data.sounds !== undefined) {
-            this.sounds = data.sounds;
-        }
-        if (data.speed !== undefined) {
-            this.speed = setRangeValue(data.speed);
-        }
-        if (data.splitCount !== undefined) {
-            this.splitCount = setRangeValue(data.splitCount);
-        }
+        loadProperty(this, "background", data.background);
+        loadRangeProperty(this, "brightness", data.brightness);
+        loadRangeProperty(this, "gravity", data.gravity);
+        loadRangeProperty(this, "minHeight", data.minHeight);
+        loadRangeProperty(this, "rate", data.rate);
+        loadRangeProperty(this, "saturation", data.saturation);
+        loadProperty(this, "sounds", data.sounds);
+        loadRangeProperty(this, "speed", data.speed);
+        loadRangeProperty(this, "splitCount", data.splitCount);
     }
 }

package/esm/FireworksInstance.js

@@ -1,7 +1,17 @@
+import { deleteFireworksInstance } from "./utils.js";
 export class FireworksInstance {
     #container;
-    constructor(container) {
+    #id;
+    constructor(container, id) {
         this.#container = container;
+        this.#id = id;
+    }
+    get destroyed() {
+        return this.#container.destroyed;
+    }
+    destroy() {
+        this.#container.destroy();
+        deleteFireworksInstance(this.#id);
     }
     pause() {
         this.#container.pause();

package/esm/fireworks.js

@@ -12,7 +12,7 @@ import { loadRotateUpdater } from "@tsparticles/updater-rotate";
 import { loadSoundsPlugin } from "@tsparticles/plugin-sounds";
 let initPromise = null;
 async function doInitPlugins(engine) {
-    engine.checkVersion("4.1.3");
+    engine.checkVersion("4.2.0");
     await engine.pluginManager.register(async (e) => {
         const loadEmittersForFireworks = async (e) => {
             await loadEmittersPluginSimple(e);
@@ -59,5 +59,5 @@ fireworks.create = async (canvas, options) => {
 fireworks.init = async () => {
     await initPlugins(tsParticles);
 };
-fireworks.version = "4.1.3";
+fireworks.version = "4.2.0";
 globalThis.fireworks = fireworks;

package/esm/fireworks.lazy.js

@@ -2,7 +2,7 @@ import { isString, tsParticles } from "@tsparticles/engine/lazy";
 import { getFireworksInstance } from "./utils.js";
 let initPromise = null;
 async function doInitPlugins(engine) {
-    engine.checkVersion("4.1.3");
+    engine.checkVersion("4.2.0");
     await engine.pluginManager.register(async (e) => {
         const [{ loadBasic }, { loadLineShape }, { loadBlendPlugin }, { loadEmittersPluginSimple }, { loadEmittersShapeSquare }, { loadSoundsPlugin }, { loadRotateUpdater }, { loadDestroyUpdater }, { loadLifeUpdater }, { loadPaintUpdater },] = await Promise.all([
             import("@tsparticles/basic/lazy"),
@@ -60,5 +60,5 @@ fireworks.create = async (canvas, options) => {
 fireworks.init = async () => {
     await initPlugins(tsParticles);
 };
-fireworks.version = "4.1.3";
+fireworks.version = "4.2.0";
 globalThis.fireworks = fireworks;

package/esm/utils.js

@@ -1,6 +1,9 @@
 import { DestroyType, EventType, MoveDirection, OutMode, StartValueType, getRangeMax, getRangeMin, isNumber, setRangeValue, } from "@tsparticles/engine";
 import { FireworkOptions } from "./FireworkOptions.js";
 const instances = new Map();
+export function deleteFireworksInstance(id) {
+    instances.delete(id);
+}
 export const explodeSoundCheck = (args) => {
     const data = args.data;
     return data?.particle?.options.move.gravity.enable ?? false;
@@ -176,7 +179,10 @@ export async function getFireworksInstance(engine, id, sourceOptions, canvas) {
         return existing;
     }
     if (existing) {
-        return existing;
+        if (!existing.destroyed) {
+            return existing;
+        }
+        instances.delete(id);
     }
     const create = async () => {
         const options = new FireworkOptions();
@@ -186,7 +192,7 @@ export async function getFireworksInstance(engine, id, sourceOptions, canvas) {
             instances.delete(id);
             return;
         }
-        const { FireworksInstance } = await import("./FireworksInstance.js"), instance = new FireworksInstance(container);
+        const { FireworksInstance } = await import("./FireworksInstance.js"), instance = new FireworksInstance(container, id);
         instances.set(id, instance);
         return instance;
     }, createPromise = create();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tsparticles/fireworks",
-  "version": "4.1.3",
-  "description": "Easily create highly customizable particle animations and use them as animated backgrounds for your website. Ready to use components available also for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.",
+  "version": "4.2.0",
+  "description": "tsParticles fireworks bundle — easily create spectacular fireworks and fountain particle effects with built-in presets. Ready to use components available for React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Inferno.",
   "homepage": "https://particles.js.org",
   "repository": {
     "type": "git",
@@ -105,17 +105,17 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@tsparticles/basic": "4.1.3",
-    "@tsparticles/engine": "4.1.3",
-    "@tsparticles/plugin-blend": "4.1.3",
-    "@tsparticles/plugin-emitters": "4.1.3",
-    "@tsparticles/plugin-emitters-shape-square": "4.1.3",
-    "@tsparticles/plugin-sounds": "4.1.3",
-    "@tsparticles/shape-line": "4.1.3",
-    "@tsparticles/updater-destroy": "4.1.3",
-    "@tsparticles/updater-life": "4.1.3",
-    "@tsparticles/updater-paint": "4.1.3",
-    "@tsparticles/updater-rotate": "4.1.3"
+    "@tsparticles/basic": "4.2.0",
+    "@tsparticles/engine": "4.2.0",
+    "@tsparticles/plugin-blend": "4.2.0",
+    "@tsparticles/plugin-emitters": "4.2.0",
+    "@tsparticles/plugin-emitters-shape-square": "4.2.0",
+    "@tsparticles/plugin-sounds": "4.2.0",
+    "@tsparticles/shape-line": "4.2.0",
+    "@tsparticles/updater-destroy": "4.2.0",
+    "@tsparticles/updater-life": "4.2.0",
+    "@tsparticles/updater-paint": "4.2.0",
+    "@tsparticles/updater-rotate": "4.2.0"
   },
   "publishConfig": {
     "access": "public"