@tsparticles/plugin-trail 4.0.0-alpha.0

package/877.min.js

@@ -0,0 +1,2 @@
+/*! For license information please see 877.min.js.LICENSE.txt */
+(this.webpackChunk_tsparticles_plugin_trail=this.webpackChunk_tsparticles_plugin_trail||[]).push([[877],{877(i,t,e){e.d(t,{TrailPlugin:()=>o});var r=e(303);class l{load(i){(0,r.isNull)(i)||(void 0!==i.color&&(this.color=r.OptionsColor.create(this.color,i.color)),void 0!==i.image&&(this.image=i.image))}}class a{constructor(){this.enable=!1,this.length=10,this.fill=new l}load(i){(0,r.isNull)(i)||(void 0!==i.enable&&(this.enable=i.enable),void 0!==i.fill&&this.fill.load(i.fill),void 0!==i.length&&(this.length=i.length))}}class n{constructor(i,t){this._initTrail=async()=>{const i=this._container.actualOptions.trail;if(!i?.enable)return;const t=i.fill,e=r.inverseFactorNumerator/i.length;if(t.color){const i=(0,r.rangeColorToRgb)(this._engine,t.color);if(!i)return;this._trailFill={color:{...i},opacity:e}}else await new Promise(((i,l)=>{if(!t.image)return;const a=(0,r.safeDocument)().createElement("img");a.addEventListener("load",(()=>{this._trailFill={image:a,opacity:e},i()})),a.addEventListener("error",(i=>{(0,r.getLogger)().error(i),l(new Error("Error loading image"))})),a.src=t.image}))},this._container=i,this._engine=t}canvasClear(){const i=this._container,t=i.actualOptions.trail,e=this._trailFill;if(!t?.enable||!e||t.length<=0)return!1;let l=!1;const a=i.canvas;return e.color?(a.paintBase((0,r.getStyleFromRgb)(e.color,i.hdr,e.opacity)),l=!0):e.image&&(a.paintImage(e.image,e.opacity),l=!0),l}async init(){try{await this._initTrail()}catch(i){(0,r.getLogger)().error(i)}}}class o{constructor(i){this.id="trail",this._engine=i}getPlugin(i){return Promise.resolve(new n(i,this._engine))}loadOptions(i,t){if(!this.needsPlugin())return;let e=i.trail;e?.load||(i.trail=e=new a),e.load(t?.trail)}needsPlugin(){return!0}}}}]);

package/877.min.js.LICENSE.txt

@@ -0,0 +1 @@
+/*! tsParticles Trail Plugin v4.0.0-alpha.0 by Matteo Bruni */

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,74 @@
+[![banner](https://particles.js.org/images/banner2.png)](https://particles.js.org)
+
+# tsParticles Trail Plugin
+
+[![jsDelivr](https://data.jsdelivr.com/v1/package/npm/@tsparticles/plugin-trail/badge)](https://www.jsdelivr.com/package/npm/@tsparticles/plugin-trail)
+[![npmjs](https://badge.fury.io/js/@tsparticles/plugin-trail.svg)](https://www.npmjs.com/package/@tsparticles/plugin-trail)
+[![npmjs](https://img.shields.io/npm/dt/@tsparticles/plugin-trail)](https://www.npmjs.com/package/@tsparticles/plugin-trail) [![GitHub Sponsors](https://img.shields.io/github/sponsors/matteobruni)](https://github.com/sponsors/matteobruni)
+
+[tsParticles](https://github.com/tsparticles/tsparticles) plugin for handling trail feature.
+
+## How to use it
+
+### CDN / Vanilla JS / jQuery
+
+The CDN/Vanilla version JS has one required file in vanilla configuration:
+
+Including the `tsparticles.plugin.trail.min.js` file will export the function to load the plugin:
+
+```javascript
+loadTrailPlugin;
+```
+
+### Usage
+
+Once the scripts are loaded you can set up `tsParticles` and the plugin like this:
+
+```javascript
+(async () => {
+  await loadTrailPlugin(tsParticles);
+
+  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/plugin-trail
+```
+
+or
+
+```shell
+$ yarn add @tsparticles/plugin-trail
+```
+
+Then you need to import it in the app, like this:
+
+```javascript
+const { tsParticles } = require("@tsparticles/engine");
+const { loadTrailPlugin } = require("@tsparticles/plugin-trail");
+
+(async () => {
+  await loadTrailPlugin(tsParticles);
+})();
+```
+
+or
+
+```javascript
+import { tsParticles } from "@tsparticles/engine";
+import { loadTrailPlugin } from "@tsparticles/plugin-trail";
+
+(async () => {
+  await loadTrailPlugin(tsParticles);
+})();
+```

package/browser/Options/Classes/Trail.js

@@ -0,0 +1,23 @@
+import { isNull } from "@tsparticles/engine";
+import { TrailFill } from "./TrailFill.js";
+export class Trail {
+    constructor() {
+        this.enable = false;
+        this.length = 10;
+        this.fill = new TrailFill();
+    }
+    load(data) {
+        if (isNull(data)) {
+            return;
+        }
+        if (data.enable !== undefined) {
+            this.enable = data.enable;
+        }
+        if (data.fill !== undefined) {
+            this.fill.load(data.fill);
+        }
+        if (data.length !== undefined) {
+            this.length = data.length;
+        }
+    }
+}

package/browser/Options/Classes/TrailFill.js

@@ -0,0 +1,14 @@
+import { OptionsColor, isNull } from "@tsparticles/engine";
+export class TrailFill {
+    load(data) {
+        if (isNull(data)) {
+            return;
+        }
+        if (data.color !== undefined) {
+            this.color = OptionsColor.create(this.color, data.color);
+        }
+        if (data.image !== undefined) {
+            this.image = data.image;
+        }
+    }
+}

package/browser/Options/Interfaces/ITrail.js

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

package/browser/Options/Interfaces/ITrailFill.js

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

package/browser/TrailInstance.js

@@ -0,0 +1,72 @@
+import { getLogger, getStyleFromRgb, inverseFactorNumerator, rangeColorToRgb, safeDocument, } from "@tsparticles/engine";
+const minimumLength = 0;
+export class TrailInstance {
+    constructor(container, engine) {
+        this._initTrail = async () => {
+            const options = this._container.actualOptions, trail = options.trail;
+            if (!trail?.enable) {
+                return;
+            }
+            const trailFill = trail.fill, opacity = inverseFactorNumerator / trail.length;
+            if (trailFill.color) {
+                const fillColor = rangeColorToRgb(this._engine, trailFill.color);
+                if (!fillColor) {
+                    return;
+                }
+                this._trailFill = {
+                    color: {
+                        ...fillColor,
+                    },
+                    opacity,
+                };
+            }
+            else {
+                await new Promise((resolve, reject) => {
+                    if (!trailFill.image) {
+                        return;
+                    }
+                    const img = safeDocument().createElement("img");
+                    img.addEventListener("load", () => {
+                        this._trailFill = {
+                            image: img,
+                            opacity,
+                        };
+                        resolve();
+                    });
+                    img.addEventListener("error", evt => {
+                        getLogger().error(evt);
+                        reject(new Error("Error loading image"));
+                    });
+                    img.src = trailFill.image;
+                });
+            }
+        };
+        this._container = container;
+        this._engine = engine;
+    }
+    canvasClear() {
+        const container = this._container, trail = container.actualOptions.trail, trailFill = this._trailFill;
+        if (!trail?.enable || !trailFill || trail.length <= minimumLength) {
+            return false;
+        }
+        let handled = false;
+        const canvas = container.canvas;
+        if (trailFill.color) {
+            canvas.paintBase(getStyleFromRgb(trailFill.color, container.hdr, trailFill.opacity));
+            handled = true;
+        }
+        else if (trailFill.image) {
+            canvas.paintImage(trailFill.image, trailFill.opacity);
+            handled = true;
+        }
+        return handled;
+    }
+    async init() {
+        try {
+            await this._initTrail();
+        }
+        catch (e) {
+            getLogger().error(e);
+        }
+    }
+}

package/browser/TrailPlugin.js

@@ -0,0 +1,24 @@
+import { Trail } from "./Options/Classes/Trail.js";
+import { TrailInstance } from "./TrailInstance.js";
+export class TrailPlugin {
+    constructor(engine) {
+        this.id = "trail";
+        this._engine = engine;
+    }
+    getPlugin(container) {
+        return Promise.resolve(new TrailInstance(container, this._engine));
+    }
+    loadOptions(options, source) {
+        if (!this.needsPlugin()) {
+            return;
+        }
+        let trailOptions = options.trail;
+        if (!trailOptions?.load) {
+            options.trail = trailOptions = new Trail();
+        }
+        trailOptions.load(source?.trail);
+    }
+    needsPlugin() {
+        return true;
+    }
+}

package/browser/index.js

@@ -0,0 +1,7 @@
+export function loadTrailPlugin(engine) {
+    engine.checkVersion("4.0.0-alpha.0");
+    engine.register(async (e) => {
+        const { TrailPlugin } = await import("./TrailPlugin.js");
+        e.addPlugin(new TrailPlugin(engine));
+    });
+}

package/browser/package.json

@@ -0,0 +1 @@
+{ "type": "module" }

package/browser/types.js

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

package/cjs/Options/Classes/Trail.js

@@ -0,0 +1,23 @@
+import { isNull } from "@tsparticles/engine";
+import { TrailFill } from "./TrailFill.js";
+export class Trail {
+    constructor() {
+        this.enable = false;
+        this.length = 10;
+        this.fill = new TrailFill();
+    }
+    load(data) {
+        if (isNull(data)) {
+            return;
+        }
+        if (data.enable !== undefined) {
+            this.enable = data.enable;
+        }
+        if (data.fill !== undefined) {
+            this.fill.load(data.fill);
+        }
+        if (data.length !== undefined) {
+            this.length = data.length;
+        }
+    }
+}

package/cjs/Options/Classes/TrailFill.js

@@ -0,0 +1,14 @@
+import { OptionsColor, isNull } from "@tsparticles/engine";
+export class TrailFill {
+    load(data) {
+        if (isNull(data)) {
+            return;
+        }
+        if (data.color !== undefined) {
+            this.color = OptionsColor.create(this.color, data.color);
+        }
+        if (data.image !== undefined) {
+            this.image = data.image;
+        }
+    }
+}

package/cjs/Options/Interfaces/ITrail.js

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

package/cjs/Options/Interfaces/ITrailFill.js

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

package/cjs/TrailInstance.js

@@ -0,0 +1,72 @@
+import { getLogger, getStyleFromRgb, inverseFactorNumerator, rangeColorToRgb, safeDocument, } from "@tsparticles/engine";
+const minimumLength = 0;
+export class TrailInstance {
+    constructor(container, engine) {
+        this._initTrail = async () => {
+            const options = this._container.actualOptions, trail = options.trail;
+            if (!trail?.enable) {
+                return;
+            }
+            const trailFill = trail.fill, opacity = inverseFactorNumerator / trail.length;
+            if (trailFill.color) {
+                const fillColor = rangeColorToRgb(this._engine, trailFill.color);
+                if (!fillColor) {
+                    return;
+                }
+                this._trailFill = {
+                    color: {
+                        ...fillColor,
+                    },
+                    opacity,
+                };
+            }
+            else {
+                await new Promise((resolve, reject) => {
+                    if (!trailFill.image) {
+                        return;
+                    }
+                    const img = safeDocument().createElement("img");
+                    img.addEventListener("load", () => {
+                        this._trailFill = {
+                            image: img,
+                            opacity,
+                        };
+                        resolve();
+                    });
+                    img.addEventListener("error", evt => {
+                        getLogger().error(evt);
+                        reject(new Error("Error loading image"));
+                    });
+                    img.src = trailFill.image;
+                });
+            }
+        };
+        this._container = container;
+        this._engine = engine;
+    }
+    canvasClear() {
+        const container = this._container, trail = container.actualOptions.trail, trailFill = this._trailFill;
+        if (!trail?.enable || !trailFill || trail.length <= minimumLength) {
+            return false;
+        }
+        let handled = false;
+        const canvas = container.canvas;
+        if (trailFill.color) {
+            canvas.paintBase(getStyleFromRgb(trailFill.color, container.hdr, trailFill.opacity));
+            handled = true;
+        }
+        else if (trailFill.image) {
+            canvas.paintImage(trailFill.image, trailFill.opacity);
+            handled = true;
+        }
+        return handled;
+    }
+    async init() {
+        try {
+            await this._initTrail();
+        }
+        catch (e) {
+            getLogger().error(e);
+        }
+    }
+}

package/cjs/TrailPlugin.js

@@ -0,0 +1,24 @@
+import { Trail } from "./Options/Classes/Trail.js";
+import { TrailInstance } from "./TrailInstance.js";
+export class TrailPlugin {
+    constructor(engine) {
+        this.id = "trail";
+        this._engine = engine;
+    }
+    getPlugin(container) {
+        return Promise.resolve(new TrailInstance(container, this._engine));
+    }
+    loadOptions(options, source) {
+        if (!this.needsPlugin()) {
+            return;
+        }
+        let trailOptions = options.trail;
+        if (!trailOptions?.load) {
+            options.trail = trailOptions = new Trail();
+        }
+        trailOptions.load(source?.trail);
+    }
+    needsPlugin() {
+        return true;
+    }
+}

package/cjs/index.js

@@ -0,0 +1,7 @@
+export function loadTrailPlugin(engine) {
+    engine.checkVersion("4.0.0-alpha.0");
+    engine.register(async (e) => {
+        const { TrailPlugin } = await import("./TrailPlugin.js");
+        e.addPlugin(new TrailPlugin(engine));
+    });
+}

package/cjs/package.json

@@ -0,0 +1 @@
+{ "type": "commonjs" }

package/cjs/types.js

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

package/dist_browser_TrailPlugin_js.js

@@ -0,0 +1,60 @@
+/*!
+ * Author : Matteo Bruni
+ * MIT license: https://opensource.org/licenses/MIT
+ * Demo / Generator : https://particles.js.org/
+ * GitHub : https://www.github.com/matteobruni/tsparticles
+ * How to use? : Check the GitHub README
+ * v4.0.0-alpha.0
+ */
+"use strict";
+/*
+ * ATTENTION: The "eval" devtool has been used (maybe by default in mode: "development").
+ * This devtool is neither made for production nor for readable output files.
+ * It uses "eval()" calls to create a separate source file in the browser devtools.
+ * If you are trying to read the output file, select a different devtool (https://webpack.js.org/configuration/devtool/)
+ * or disable the default devtool with "devtool: false".
+ * If you are looking for production-ready output files, see mode: "production" (https://webpack.js.org/configuration/mode/).
+ */
+(this["webpackChunk_tsparticles_plugin_trail"] = this["webpackChunk_tsparticles_plugin_trail"] || []).push([["dist_browser_TrailPlugin_js"],{
+
+/***/ "./dist/browser/Options/Classes/Trail.js"
+/*!***********************************************!*\
+  !*** ./dist/browser/Options/Classes/Trail.js ***!
+  \***********************************************/
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   Trail: () => (/* binding */ Trail)\n/* harmony export */ });\n/* harmony import */ var _tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! @tsparticles/engine */ \"@tsparticles/engine\");\n/* harmony import */ var _TrailFill_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./TrailFill.js */ \"./dist/browser/Options/Classes/TrailFill.js\");\n\n\nclass Trail {\n  constructor() {\n    this.enable = false;\n    this.length = 10;\n    this.fill = new _TrailFill_js__WEBPACK_IMPORTED_MODULE_1__.TrailFill();\n  }\n  load(data) {\n    if ((0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.isNull)(data)) {\n      return;\n    }\n    if (data.enable !== undefined) {\n      this.enable = data.enable;\n    }\n    if (data.fill !== undefined) {\n      this.fill.load(data.fill);\n    }\n    if (data.length !== undefined) {\n      this.length = data.length;\n    }\n  }\n}\n\n//# sourceURL=webpack://@tsparticles/plugin-trail/./dist/browser/Options/Classes/Trail.js?\n}");
+
+/***/ },
+
+/***/ "./dist/browser/Options/Classes/TrailFill.js"
+/*!***************************************************!*\
+  !*** ./dist/browser/Options/Classes/TrailFill.js ***!
+  \***************************************************/
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   TrailFill: () => (/* binding */ TrailFill)\n/* harmony export */ });\n/* harmony import */ var _tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! @tsparticles/engine */ \"@tsparticles/engine\");\n\nclass TrailFill {\n  load(data) {\n    if ((0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.isNull)(data)) {\n      return;\n    }\n    if (data.color !== undefined) {\n      this.color = _tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.OptionsColor.create(this.color, data.color);\n    }\n    if (data.image !== undefined) {\n      this.image = data.image;\n    }\n  }\n}\n\n//# sourceURL=webpack://@tsparticles/plugin-trail/./dist/browser/Options/Classes/TrailFill.js?\n}");
+
+/***/ },
+
+/***/ "./dist/browser/TrailInstance.js"
+/*!***************************************!*\
+  !*** ./dist/browser/TrailInstance.js ***!
+  \***************************************/
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   TrailInstance: () => (/* binding */ TrailInstance)\n/* harmony export */ });\n/* harmony import */ var _tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! @tsparticles/engine */ \"@tsparticles/engine\");\n\nconst minimumLength = 0;\nclass TrailInstance {\n  constructor(container, engine) {\n    this._initTrail = async () => {\n      const options = this._container.actualOptions,\n        trail = options.trail;\n      if (!trail?.enable) {\n        return;\n      }\n      const trailFill = trail.fill,\n        opacity = _tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.inverseFactorNumerator / trail.length;\n      if (trailFill.color) {\n        const fillColor = (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.rangeColorToRgb)(this._engine, trailFill.color);\n        if (!fillColor) {\n          return;\n        }\n        this._trailFill = {\n          color: {\n            ...fillColor\n          },\n          opacity\n        };\n      } else {\n        await new Promise((resolve, reject) => {\n          if (!trailFill.image) {\n            return;\n          }\n          const img = (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.safeDocument)().createElement(\"img\");\n          img.addEventListener(\"load\", () => {\n            this._trailFill = {\n              image: img,\n              opacity\n            };\n            resolve();\n          });\n          img.addEventListener(\"error\", evt => {\n            (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.getLogger)().error(evt);\n            reject(new Error(\"Error loading image\"));\n          });\n          img.src = trailFill.image;\n        });\n      }\n    };\n    this._container = container;\n    this._engine = engine;\n  }\n  canvasClear() {\n    const container = this._container,\n      trail = container.actualOptions.trail,\n      trailFill = this._trailFill;\n    if (!trail?.enable || !trailFill || trail.length <= minimumLength) {\n      return false;\n    }\n    let handled = false;\n    const canvas = container.canvas;\n    if (trailFill.color) {\n      canvas.paintBase((0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.getStyleFromRgb)(trailFill.color, container.hdr, trailFill.opacity));\n      handled = true;\n    } else if (trailFill.image) {\n      canvas.paintImage(trailFill.image, trailFill.opacity);\n      handled = true;\n    }\n    return handled;\n  }\n  async init() {\n    try {\n      await this._initTrail();\n    } catch (e) {\n      (0,_tsparticles_engine__WEBPACK_IMPORTED_MODULE_0__.getLogger)().error(e);\n    }\n  }\n}\n\n//# sourceURL=webpack://@tsparticles/plugin-trail/./dist/browser/TrailInstance.js?\n}");
+
+/***/ },
+
+/***/ "./dist/browser/TrailPlugin.js"
+/*!*************************************!*\
+  !*** ./dist/browser/TrailPlugin.js ***!
+  \*************************************/
+(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
+
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   TrailPlugin: () => (/* binding */ TrailPlugin)\n/* harmony export */ });\n/* harmony import */ var _Options_Classes_Trail_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(/*! ./Options/Classes/Trail.js */ \"./dist/browser/Options/Classes/Trail.js\");\n/* harmony import */ var _TrailInstance_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(/*! ./TrailInstance.js */ \"./dist/browser/TrailInstance.js\");\n\n\nclass TrailPlugin {\n  constructor(engine) {\n    this.id = \"trail\";\n    this._engine = engine;\n  }\n  getPlugin(container) {\n    return Promise.resolve(new _TrailInstance_js__WEBPACK_IMPORTED_MODULE_1__.TrailInstance(container, this._engine));\n  }\n  loadOptions(options, source) {\n    if (!this.needsPlugin()) {\n      return;\n    }\n    let trailOptions = options.trail;\n    if (!trailOptions?.load) {\n      options.trail = trailOptions = new _Options_Classes_Trail_js__WEBPACK_IMPORTED_MODULE_0__.Trail();\n    }\n    trailOptions.load(source?.trail);\n  }\n  needsPlugin() {\n    return true;\n  }\n}\n\n//# sourceURL=webpack://@tsparticles/plugin-trail/./dist/browser/TrailPlugin.js?\n}");
+
+/***/ }
+
+}]);

package/esm/Options/Classes/Trail.js

@@ -0,0 +1,23 @@
+import { isNull } from "@tsparticles/engine";
+import { TrailFill } from "./TrailFill.js";
+export class Trail {
+    constructor() {
+        this.enable = false;
+        this.length = 10;
+        this.fill = new TrailFill();
+    }
+    load(data) {
+        if (isNull(data)) {
+            return;
+        }
+        if (data.enable !== undefined) {
+            this.enable = data.enable;
+        }
+        if (data.fill !== undefined) {
+            this.fill.load(data.fill);
+        }
+        if (data.length !== undefined) {
+            this.length = data.length;
+        }
+    }
+}

package/esm/Options/Classes/TrailFill.js

@@ -0,0 +1,14 @@
+import { OptionsColor, isNull } from "@tsparticles/engine";
+export class TrailFill {
+    load(data) {
+        if (isNull(data)) {
+            return;
+        }
+        if (data.color !== undefined) {
+            this.color = OptionsColor.create(this.color, data.color);
+        }
+        if (data.image !== undefined) {
+            this.image = data.image;
+        }
+    }
+}

package/esm/Options/Interfaces/ITrail.js

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

package/esm/Options/Interfaces/ITrailFill.js

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

package/esm/TrailInstance.js

@@ -0,0 +1,72 @@
+import { getLogger, getStyleFromRgb, inverseFactorNumerator, rangeColorToRgb, safeDocument, } from "@tsparticles/engine";
+const minimumLength = 0;
+export class TrailInstance {
+    constructor(container, engine) {
+        this._initTrail = async () => {
+            const options = this._container.actualOptions, trail = options.trail;
+            if (!trail?.enable) {
+                return;
+            }
+            const trailFill = trail.fill, opacity = inverseFactorNumerator / trail.length;
+            if (trailFill.color) {
+                const fillColor = rangeColorToRgb(this._engine, trailFill.color);
+                if (!fillColor) {
+                    return;
+                }
+                this._trailFill = {
+                    color: {
+                        ...fillColor,
+                    },
+                    opacity,
+                };
+            }
+            else {
+                await new Promise((resolve, reject) => {
+                    if (!trailFill.image) {
+                        return;
+                    }
+                    const img = safeDocument().createElement("img");
+                    img.addEventListener("load", () => {
+                        this._trailFill = {
+                            image: img,
+                            opacity,
+                        };
+                        resolve();
+                    });
+                    img.addEventListener("error", evt => {
+                        getLogger().error(evt);
+                        reject(new Error("Error loading image"));
+                    });
+                    img.src = trailFill.image;
+                });
+            }
+        };
+        this._container = container;
+        this._engine = engine;
+    }
+    canvasClear() {
+        const container = this._container, trail = container.actualOptions.trail, trailFill = this._trailFill;
+        if (!trail?.enable || !trailFill || trail.length <= minimumLength) {
+            return false;
+        }
+        let handled = false;
+        const canvas = container.canvas;
+        if (trailFill.color) {
+            canvas.paintBase(getStyleFromRgb(trailFill.color, container.hdr, trailFill.opacity));
+            handled = true;
+        }
+        else if (trailFill.image) {
+            canvas.paintImage(trailFill.image, trailFill.opacity);
+            handled = true;
+        }
+        return handled;
+    }
+    async init() {
+        try {
+            await this._initTrail();
+        }
+        catch (e) {
+            getLogger().error(e);
+        }
+    }
+}

package/esm/TrailPlugin.js

@@ -0,0 +1,24 @@
+import { Trail } from "./Options/Classes/Trail.js";
+import { TrailInstance } from "./TrailInstance.js";
+export class TrailPlugin {
+    constructor(engine) {
+        this.id = "trail";
+        this._engine = engine;
+    }
+    getPlugin(container) {
+        return Promise.resolve(new TrailInstance(container, this._engine));
+    }
+    loadOptions(options, source) {
+        if (!this.needsPlugin()) {
+            return;
+        }
+        let trailOptions = options.trail;
+        if (!trailOptions?.load) {
+            options.trail = trailOptions = new Trail();
+        }
+        trailOptions.load(source?.trail);
+    }
+    needsPlugin() {
+        return true;
+    }
+}

package/esm/index.js

@@ -0,0 +1,7 @@
+export function loadTrailPlugin(engine) {
+    engine.checkVersion("4.0.0-alpha.0");
+    engine.register(async (e) => {
+        const { TrailPlugin } = await import("./TrailPlugin.js");
+        e.addPlugin(new TrailPlugin(engine));
+    });
+}

package/esm/package.json

@@ -0,0 +1 @@
+{ "type": "module" }

package/esm/types.js

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