@tsparticles/effect-trail 4.0.0-beta.6 → 4.0.0-beta.9

package/{827.min.js → 410.min.js}

@@ -1 +1 @@
-"use strict";(this.webpackChunk_tsparticles_effect_trail=this.webpackChunk_tsparticles_effect_trail||[]).push([[827],{827(t,a,i){i.d(a,{TrailDrawer:()=>r});var e=i(303);let l={a:1,b:0,c:0,d:1};class r{_container;constructor(t){this._container=t}drawAfter(t){let{context:a,drawPosition:i,drawRadius:r,drawScale:n,particle:h,transformData:o}=t,s=this._container,d=r*e.double,c=s.retina.pixelRatio,f=h.trail;if(!f||!h.trailLength)return;let g=h.trailLength*n+r;if(f.push({color:a.fillStyle||a.strokeStyle,position:{x:i.x,y:i.y},transformData:o}),f.length<3)return;let x=Math.floor(g);f.length>x&&f.splice(0,f.length-x);let p=Math.min(f.length,g),u={width:s.canvas.size.width*n+d,height:s.canvas.size.height*n+d};a.save(),a.lineCap="butt",a.lineJoin="round";for(let t=p-2;t>0;t--){let i=f[t+1],r=f[t],o=f[t-1];if(!i||!r||!o)continue;let s=i.position,x=r.position,y=o.position,b=h.trailTransform?r.transformData??l:l,{distance:m}=(0,e.getDistances)(s,x),{distance:M}=(0,e.getDistances)(x,y);if(m>g*e.double||M>g*e.double||Math.abs(s.x-x.x)>u.width*e.half||Math.abs(s.y-x.y)>u.height*e.half||Math.abs(x.x-y.x)>u.width*e.half||Math.abs(x.y-y.y)>u.height*e.half)continue;a.setTransform(b.a,b.b,b.c,b.d,x.x,x.y);let W=(s.x+x.x)*e.half-x.x,_=(s.y+x.y)*e.half-x.y,v=(x.x+y.x)*e.half-x.x,w=(x.y+y.y)*e.half-x.y;a.beginPath(),a.moveTo(W,_),a.quadraticCurveTo(e.originPoint.x,e.originPoint.y,v,w);let k=Math.max(t/p*d,c,(h.trailMinWidth??-1)*n),R=a.globalAlpha;a.globalAlpha=h.trailFade?t/p:e.defaultAlpha,a.lineWidth=h.trailMaxWidth?Math.min(k,h.trailMaxWidth*n):k,a.strokeStyle=r.color,a.stroke(),a.globalAlpha=R}a.restore()}particleInit(t,a){a.trail=[];let i=a.effectData;a.trailFade=i?.fade??!0,a.trailLength=(0,e.getRangeValue)(i?.length??10)*t.retina.pixelRatio,a.trailMaxWidth=i?.maxWidth?(0,e.getRangeValue)(i.maxWidth)*t.retina.pixelRatio:void 0,a.trailMinWidth=i?.minWidth?(0,e.getRangeValue)(i.minWidth)*t.retina.pixelRatio:void 0,a.trailTransform=i?.transform??!1}}}}]);
+"use strict";(this.webpackChunk_tsparticles_effect_trail=this.webpackChunk_tsparticles_effect_trail||[]).push([[410],{410(t,a,i){i.d(a,{TrailDrawer:()=>r});var e=i(303);let l={a:1,b:0,c:0,d:1};class r{_container;constructor(t){this._container=t}drawAfter(t){let{context:a,drawPosition:i,drawRadius:r,drawScale:n,particle:h,transformData:o}=t,s=this._container,d=r*e.double,c=s.retina.pixelRatio,f=h.trail;if(!f||!h.trailLength)return;let g=h.trailLength*n+r;if(f.push({color:a.fillStyle||a.strokeStyle,position:{x:i.x,y:i.y},transformData:o}),f.length<3)return;let x=Math.floor(g);f.length>x&&f.splice(0,f.length-x);let p=Math.min(f.length,g),u={width:s.canvas.size.width*n+d,height:s.canvas.size.height*n+d};a.save(),a.lineCap="butt",a.lineJoin="round";for(let t=p-2;t>0;t--){let i=f[t+1],r=f[t],o=f[t-1];if(!i||!r||!o)continue;let s=i.position,x=r.position,y=o.position,b=h.trailTransform?r.transformData??l:l,{distance:m}=(0,e.getDistances)(s,x),{distance:M}=(0,e.getDistances)(x,y);if(m>g*e.double||M>g*e.double||Math.abs(s.x-x.x)>u.width*e.half||Math.abs(s.y-x.y)>u.height*e.half||Math.abs(x.x-y.x)>u.width*e.half||Math.abs(x.y-y.y)>u.height*e.half)continue;a.setTransform(b.a,b.b,b.c,b.d,x.x,x.y);let W=(s.x+x.x)*e.half-x.x,_=(s.y+x.y)*e.half-x.y,v=(x.x+y.x)*e.half-x.x,w=(x.y+y.y)*e.half-x.y;a.beginPath(),a.moveTo(W,_),a.quadraticCurveTo(e.originPoint.x,e.originPoint.y,v,w);let k=Math.max(t/p*d,c,(h.trailMinWidth??-1)*n),R=a.globalAlpha;a.globalAlpha=h.trailFade?t/p:e.defaultAlpha,a.lineWidth=h.trailMaxWidth?Math.min(k,h.trailMaxWidth*n):k,a.strokeStyle=r.color,a.stroke(),a.globalAlpha=R}a.restore()}particleInit(t,a){a.trail=[];let i=a.effectData;a.trailFade=i?.fade??!0,a.trailLength=(0,e.getRangeValue)(i?.length??10)*t.retina.pixelRatio,a.trailMaxWidth=i?.maxWidth?(0,e.getRangeValue)(i.maxWidth)*t.retina.pixelRatio:void 0,a.trailMinWidth=i?.minWidth?(0,e.getRangeValue)(i.minWidth)*t.retina.pixelRatio:void 0,a.trailTransform=i?.transform??!1}}}}]);

package/README.md

@@ -8,6 +8,12 @@
 
 [tsParticles](https://github.com/tsparticles/tsparticles) additional trail effect.
 
+## Quick checklist
+
+1. Install `@tsparticles/engine` (or use the CDN bundle below)
+2. Call the package loader function(s) before `tsParticles.load(...)`
+3. Apply the package options in your `tsParticles.load(...)` config
+
 ## How to use it
 
 ### CDN / Vanilla JS / jQuery
@@ -73,3 +79,20 @@ import { loadTrailEffect } from "@tsparticles/effect-trail";
   await loadTrailEffect(tsParticles);
 })();
 ```
+
+## Option mapping
+
+- Effects are usually enabled through dedicated package loaders and effect-specific options.
+- Package scope: `trail`
+- Start from the usage snippet in this README, then merge with your main options object incrementally.
+
+## Common pitfalls
+
+- Calling `tsParticles.load(...)` before `loadTrailEffect(...)`
+- Verify required peer packages before enabling advanced options
+- Change one option group at a time to isolate regressions quickly
+
+## Related docs
+
+- All packages catalog: <https://github.com/tsparticles/tsparticles>
+- Main docs: <https://particles.js.org/docs/>

package/browser/index.js

@@ -1,5 +1,5 @@
 export async function loadTrailEffect(engine) {
-    engine.checkVersion("4.0.0-beta.6");
+    engine.checkVersion("4.0.0-beta.9");
     await engine.pluginManager.register(e => {
         e.pluginManager.addEffect("trail", async (container) => {
             const { TrailDrawer } = await import("./TrailDrawer.js");

package/cjs/index.js

@@ -1,5 +1,5 @@
 export async function loadTrailEffect(engine) {
-    engine.checkVersion("4.0.0-beta.6");
+    engine.checkVersion("4.0.0-beta.9");
     await engine.pluginManager.register(e => {
         e.pluginManager.addEffect("trail", async (container) => {
             const { TrailDrawer } = await import("./TrailDrawer.js");

package/dist_browser_TrailDrawer_js.js

@@ -4,7 +4,7 @@
  * Demo / Generator : https://particles.js.org/
  * GitHub : https://www.github.com/matteobruni/tsparticles
  * How to use? : Check the GitHub README
- * v4.0.0-beta.6
+ * v4.0.0-beta.9
  */
 "use strict";
 /*

package/esm/index.js

@@ -1,5 +1,5 @@
 export async function loadTrailEffect(engine) {
-    engine.checkVersion("4.0.0-beta.6");
+    engine.checkVersion("4.0.0-beta.9");
     await engine.pluginManager.register(e => {
         e.pluginManager.addEffect("trail", async (container) => {
             const { TrailDrawer } = await import("./TrailDrawer.js");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/effect-trail",
-  "version": "4.0.0-beta.6",
+  "version": "4.0.0-beta.9",
   "description": "tsParticles trail effect",
   "homepage": "https://particles.js.org",
   "repository": {
@@ -99,7 +99,7 @@
     "./package.json": "./package.json"
   },
   "peerDependencies": {
-    "@tsparticles/engine": "4.0.0-beta.6"
+    "@tsparticles/engine": "4.0.0-beta.9"
   },
   "publishConfig": {
     "access": "public"

package/report.html

@@ -3,7 +3,7 @@
       <head>
         <meta charset="UTF-8" />
         <meta name="viewport" content="width=device-width, initial-scale=1" />
-        <title>@tsparticles/effect-trail [2 Apr 2026 at 15:15]</title>
+        <title>@tsparticles/effect-trail [8 Apr 2026 at 07:17]</title>
         <link
           rel="shortcut icon"
           href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAABrVBMVEUAAAD///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////+O1foceMD///+J0/qK1Pr7/v8Xdr/9///W8P4UdL7L7P0Scr2r4Pyj3vwad8D5/f/2/f+55f3E6f34+/2H0/ojfMKpzOd0rNgQcb3F3O/j9f7c8v6g3Pz0/P/w+v/q+P7n9v6T1/uQ1vuE0vqLut/y+v+Z2fvt+f+15Pzv9fuc2/vR7v2V2Pvd6/bg9P7I6/285/2y4/yp3/zp8vk8i8kqgMT7/P31+fyv4vxGkcz6/P6/6P3j7vfS5PNnpNUxhcbO7f7F6v3O4vHK3/DA2u631Ouy0eqXweKJud5wqthfoNMMbLvY8f73+v2dxeR8sNtTmdDx9/zX6PSjyeaCtd1YnNGX2PuQveCGt95Nls42h8dLlM3F4vBtAAAAM3RSTlMAAyOx0/sKBvik8opWGBMOAe3l1snDm2E9LSb06eHcu5JpHbarfHZCN9CBb08zzkdNS0kYaptYAAAFV0lEQVRYw92X51/aYBDHHS2O2qqttVbrqNq9m+TJIAYIShBkWwqIiCgoWvfeq7Z2/s29hyQNyUcR7LveGwVyXy6XH8/9rqxglLfUPLxVduUor3h0rfp2TYvpivk37929TkG037hffoX0+peVtZQc1589rigVUdXS/ABSAyEmGIO/1XfvldSK8vs3OqB6u3m0nxmIrvgB0dj7rr7Y9IbuF68hnfFaiHA/sxqm0wciIG43P60qKv9WXWc1RXGh/mFESFABTSBi0sNAKzqet17eCtOb3kZIDwxEEU0oAIJGYxNBDhBND29e0rtXXbcpuPmED9IhEAAQ/AXEaF8EPmnrrKsv0LvWR3fg5sWDNAFZOgAgaKvZDogHNU9MFwnnYROkc56RD5CjAbQX9Ow4g7upCsvYu55aSI/Nj0H1akgKQEUM94dwK65hYRmFU9MIcH/fqJYOZYcnuJSU/waKDgTOEVaVKhwrTRP5XzgSpAITYzom7UvkhFX5VutmxeNnWDjjswTKTyfgluNDGbUpWissXhF3s7mlSml+czWkg3D0l1nNjGNjz3myOQOa1KM/jOS6ebdbAVTCi4gljHSFrviza7tOgRWcS0MOUX9zdNgag5w7rRqA44Lzw0hr1WqES36dFliSJFlh2rXIae3FFcDDgKdxrUIDePr8jGcSClV1u7A9xeN0ModY/pHMxmR1EzRh8TJiwqsHmKW0l4FCEZI+jHio+JdPPE9qwQtTRxku2D8sIeRL2LnxWSllANCQGOIiqVHAz2ye2JR0DcH+HoxDkaADLjgxjKQ+AwCX/g0+DNgdG0ukYCONAe+dbc2IAc6fwt1ARoDSezNHxV2Cmzwv3O6lDMV55edBGwGK9n1+x2F8EDfAGCxug8MhpsMEcTEAWf3rx2vZhe/LAmtIn/6apE6PN0ULKgywD9mmdxbmFl3OvD5AS5fW5zLbv/YHmcsBTjf/afDz3MaZTVCfAP9z6/Bw6ycv8EUBWJIn9zYcoAWWlW9+OzO3vkTy8H+RANLmdrpOuYWdZYEXpo+TlCJrW5EARb7fF+bWdqf3hhyZI1nWJQHgznErZhbjoEsWqi8dQNoE294aldzFurwSABL2XXMf9+H1VQGke9exw5P/AnA5Pv5ngMul7LOvO922iwACu8WkCwLCafvM4CeWPxfA8lNHcWZSoi8EwMAIciKX2Z4SWCMAa3snCZ/G4EA8D6CMLNFsGQhkkz/gQNEBbPCbWsxGUpYVu3z8IyNAknwJkfPMEhLyrdi5RTyUVACkw4GSFRNWJNEW+fgPGwHD8/JxnRuLabN4CGNRkAE23na2+VmEAUmrYymSGjMAYqH84YUIyzgzs3XC7gNgH36Vcc4zKY9o9fgPBXUAiHHwVboBHGLiX6Zcjp1f2wu4tvzZKo0ecPnDtQYDQvJXaBeNzce45Fp28ZQLrEZVuFqgBwOalArKXnW1UzlnSusQKJqKYNuz4tOnI6sZG4zanpemv+7ySU2jbA9h6uhcgpfy6G2PahirDZ6zvq6zDduMVFTKvzw8wgyEdelwY9in3XkEPs3osJuwRQ4qTkfzifndg9Gfc4pdsu82+tTnHZTBa2EAMrqr2t43pguc8tNm7JQVQ2S0ukj2d22dhXYP0/veWtwKrCkNoNimAN5+Xr/oLrxswKbVJjteWrX7eR63o4j9q0GxnaBdWgGA5VStpanIjQmEhV0/nVt5VOFUvix6awJhPcAaTEShgrG+iGyvb5a0Ndb1YGHFPEwoqAinoaykaID1o1pdPNu7XsnCKQ3R+hwWIIhGvORcJUBYXe3Xa3vq/mF/N9V13ugufMkfXn+KHsRD0B8AAAAASUVORK5CYII="

package/tsparticles.effect.trail.js

@@ -4,7 +4,7 @@
  * Demo / Generator : https://particles.js.org/
  * GitHub : https://www.github.com/matteobruni/tsparticles
  * How to use? : Check the GitHub README
- * v4.0.0-beta.6
+ * v4.0.0-beta.9
  */
 /*
  * ATTENTION: The "eval" devtool has been used (maybe by default in mode: "development").
@@ -44,7 +44,7 @@ module.exports = __WEBPACK_EXTERNAL_MODULE__tsparticles_engine__;
   \*******************************/
 (__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 */   loadTrailEffect: () => (/* binding */ loadTrailEffect)\n/* harmony export */ });\nasync function loadTrailEffect(engine) {\n    engine.checkVersion(\"4.0.0-beta.6\");\n    await engine.pluginManager.register((e)=>{\n        e.pluginManager.addEffect(\"trail\", async (container)=>{\n            const { TrailDrawer } = await __webpack_require__.e(/*! import() */ \"dist_browser_TrailDrawer_js\").then(__webpack_require__.bind(__webpack_require__, /*! ./TrailDrawer.js */ \"./dist/browser/TrailDrawer.js\"));\n            return new TrailDrawer(container);\n        });\n    });\n}\n\n\n//# sourceURL=webpack://@tsparticles/effect-trail/./dist/browser/index.js?\n}");
+eval("{__webpack_require__.r(__webpack_exports__);\n/* harmony export */ __webpack_require__.d(__webpack_exports__, {\n/* harmony export */   loadTrailEffect: () => (/* binding */ loadTrailEffect)\n/* harmony export */ });\nasync function loadTrailEffect(engine) {\n    engine.checkVersion(\"4.0.0-beta.9\");\n    await engine.pluginManager.register((e)=>{\n        e.pluginManager.addEffect(\"trail\", async (container)=>{\n            const { TrailDrawer } = await __webpack_require__.e(/*! import() */ \"dist_browser_TrailDrawer_js\").then(__webpack_require__.bind(__webpack_require__, /*! ./TrailDrawer.js */ \"./dist/browser/TrailDrawer.js\"));\n            return new TrailDrawer(container);\n        });\n    });\n}\n\n\n//# sourceURL=webpack://@tsparticles/effect-trail/./dist/browser/index.js?\n}");
 
 /***/ }
 

package/tsparticles.effect.trail.min.js

@@ -1,2 +1,2 @@
 !function(e,t){if("object"==typeof exports&&"object"==typeof module)module.exports=t(require("@tsparticles/engine"));else if("function"==typeof define&&define.amd)define(["@tsparticles/engine"],t);else{var r="object"==typeof exports?t(require("@tsparticles/engine")):t(e.window);for(var o in r)("object"==typeof exports?exports:e)[o]=r[o]}}(this,e=>(()=>{"use strict";var t,r,o,i={303(t){t.exports=e}},n={};function a(e){var t=n[e];if(void 0!==t)return t.exports;var r=n[e]={exports:{}};return i[e](r,r.exports,a),r.exports}a.m=i,a.d=(e,t)=>{for(var r in t)a.o(t,r)&&!a.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:t[r]})},a.f={},a.e=e=>Promise.all(Object.keys(a.f).reduce((t,r)=>(a.f[r](e,t),t),[])),a.u=e=>""+e+".min.js",a.g=function(){if("object"==typeof globalThis)return globalThis;try{return this||Function("return this")()}catch(e){if("object"==typeof window)return window}}(),a.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),c={},a.l=(e,t,r,o)=>{if(c[e])return void c[e].push(t);if(void 0!==r)for(var i,n,s=document.getElementsByTagName("script"),l=0;l<s.length;l++){var p=s[l];if(p.getAttribute("src")==e||p.getAttribute("data-webpack")=="@tsparticles/effect-trail:"+r){i=p;break}}i||(n=!0,(i=document.createElement("script")).charset="utf-8",a.nc&&i.setAttribute("nonce",a.nc),i.setAttribute("data-webpack","@tsparticles/effect-trail:"+r),i.src=e),c[e]=[t];var u=(t,r)=>{i.onerror=i.onload=null,clearTimeout(f);var o=c[e];if(delete c[e],i.parentNode&&i.parentNode.removeChild(i),o&&o.forEach(e=>e(r)),t)return t(r)},f=setTimeout(u.bind(null,void 0,{type:"timeout",target:i}),12e4);i.onerror=u.bind(null,i.onerror),i.onload=u.bind(null,i.onload),n&&document.head.appendChild(i)},a.r=e=>{"u">typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},a.g.importScripts&&(s=a.g.location+"");var c,s,l=a.g.document;if(!s&&l&&(l.currentScript&&"SCRIPT"===l.currentScript.tagName.toUpperCase()&&(s=l.currentScript.src),!s)){var p=l.getElementsByTagName("script");if(p.length)for(var u=p.length-1;u>-1&&(!s||!/^http(s?):/.test(s));)s=p[u--].src}if(!s)throw Error("Automatic publicPath is not supported in this browser");a.p=s=s.replace(/^blob:/,"").replace(/#.*$/,"").replace(/\?.*$/,"").replace(/\/[^\/]+$/,"/"),t={826:0},a.f.j=(e,r)=>{var o=a.o(t,e)?t[e]:void 0;if(0!==o)if(o)r.push(o[2]);else{var i=new Promise((r,i)=>o=t[e]=[r,i]);r.push(o[2]=i);var n=a.p+a.u(e),c=Error();a.l(n,r=>{if(a.o(t,e)&&(0!==(o=t[e])&&(t[e]=void 0),o)){var i=r&&("load"===r.type?"missing":r.type),n=r&&r.target&&r.target.src;c.message="Loading chunk "+e+` failed.
-(`+i+": "+n+")",c.name="ChunkLoadError",c.type=i,c.request=n,o[1](c)}},"chunk-"+e,e)}},r=(e,r)=>{var o,i,[n,c,s]=r,l=0;if(n.some(e=>0!==t[e])){for(o in c)a.o(c,o)&&(a.m[o]=c[o]);s&&s(a)}for(e&&e(r);l<n.length;l++)i=n[l],a.o(t,i)&&t[i]&&t[i][0](),t[i]=0},(o=this.webpackChunk_tsparticles_effect_trail=this.webpackChunk_tsparticles_effect_trail||[]).forEach(r.bind(null,0)),o.push=r.bind(null,o.push.bind(o));var f={};async function d(e){e.checkVersion("4.0.0-beta.6"),await e.pluginManager.register(e=>{e.pluginManager.addEffect("trail",async e=>{let{TrailDrawer:t}=await a.e(827).then(a.bind(a,827));return new t(e)})})}return a.r(f),a.d(f,{loadTrailEffect:()=>d}),f})());
+(`+i+": "+n+")",c.name="ChunkLoadError",c.type=i,c.request=n,o[1](c)}},"chunk-"+e,e)}},r=(e,r)=>{var o,i,[n,c,s]=r,l=0;if(n.some(e=>0!==t[e])){for(o in c)a.o(c,o)&&(a.m[o]=c[o]);s&&s(a)}for(e&&e(r);l<n.length;l++)i=n[l],a.o(t,i)&&t[i]&&t[i][0](),t[i]=0},(o=this.webpackChunk_tsparticles_effect_trail=this.webpackChunk_tsparticles_effect_trail||[]).forEach(r.bind(null,0)),o.push=r.bind(null,o.push.bind(o));var f={};async function d(e){e.checkVersion("4.0.0-beta.9"),await e.pluginManager.register(e=>{e.pluginManager.addEffect("trail",async e=>{let{TrailDrawer:t}=await a.e(410).then(a.bind(a,410));return new t(e)})})}return a.r(f),a.d(f,{loadTrailEffect:()=>d}),f})());