Merge pull request tsparticles#5596 from tsparticles/v4

4.0.0-alpha.28

Author: matteobruni

.github/workflows/nodejs.yml

@@ -32,7 +32,7 @@ jobs:
         with:
           node-version: "24"
 
-      - uses: pnpm/action-setup@v4.2.0
+      - uses: pnpm/action-setup@v4.4.0
         with:
           run_install: false
 

.github/workflows/npm-publish.yml

@@ -33,7 +33,7 @@ jobs:
           node-version: '24'
           registry-url: https://registry.npmjs.org
 
-      - uses: pnpm/action-setup@v4.2.0
+      - uses: pnpm/action-setup@v4.4.0
         name: Install pnpm
         with:
           run_install: false

CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15)
+
+### Bug Fixes
+
+- squircle fix ([ed45b4d](https://github.com/tsparticles/tsparticles/commit/ed45b4d134d7e6ab23caaec5e9bce2e2f2f2774b))
+- squircle fix ([e1e79b0](https://github.com/tsparticles/tsparticles/commit/e1e79b01b4b1570fd745c6fd1bfdc11b35a01095))
+
+### Features
+
+- made squircle shape configurable ([58480b8](https://github.com/tsparticles/tsparticles/commit/58480b8ddc6ca947ae8c077840990df6aa205d0e))
+
 # [4.0.0-alpha.27](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.26...v4.0.0-alpha.27) (2026-03-09)
 
 ### Bug Fixes

README.md

@@ -697,8 +697,14 @@ flowchart TD
 
   subgraph bundle-basic [tsParticles Basic]
 
-    subgraph basic-movers [Movers]
-      move-base[Base]
+    subgraph basic-plugins [Plugins]
+      plugin-move[Move]
+
+      subgraph basic-plugins-colors [Colors]
+        plugin-hex-color[Hex Color]
+        plugin-hsl-color[HSL Color]
+        plugin-rgb-color[RGB Color]
+      end
     end
 
     subgraph basic-shapes [Shapes]
@@ -772,6 +778,7 @@ flowchart TD
     end
 
     subgraph slim-plugins [Plugins]
+      plugin-interactivity[Interactivity]
 
       subgraph slim-plugins-easings [Easings]
         plugin-easing-quad[Quad]
@@ -863,10 +870,10 @@ flowchart TD
 
   subgraph bundle-all [tsParticles All]
 
-    bundle-pjs[tsParticles Particles.js Compatibility]
-
     subgraph all-effects [Effects]
       effect-bubble[Bubble]
+      effect-particles[Particles]
+      effect-shadow[Shadow]
       effect-trail[Trail]
     end
 
@@ -884,26 +891,51 @@ flowchart TD
     end
 
     subgraph all-paths [Paths]
+      path-branches[Branches]
+      path-brownian[Brownian]
       path-curl-noise[Curl Noise]
       path-curves[Curves]
+      path-fractal-noise[Fractal Noise]
+      path-grid[Grid]
+      path-levy[Levy]
       path-perlin-noise[Perlin Noise]
       path-polygon[Polygon]
+      path-random[Random]
       path-simplex-noise[Simplex Noise]
+      path-spiral[Spiral]
       path-svg[SVG]
+      path-zig-zag[Zig Zag]
     end
 
     subgraph all-plugins [Plugins]
+      plugin-background-mask[Background Mask]
+      plugin-blend[Blend]
       plugin-canvas-mask[Canvas Mask]
 
+      subgraph all-plugins-colors [Colors]
+        plugin-hsv-color[HSV Color]
+        plugin-hwb-color[HWB Color]
+        plugin-lab-color[Lab Color]
+        plugin-lch-color[Lch Color]
+        plugin-named-color[Named Color]
+        plugin-oklab-color[Oklab Color]
+        plugin-oklch-color[Oklch Color]
+      end
+
       subgraph all-plugins-easings [Easings]
         plugin-easing-back[Back]
+        plugin-easing-bounce[Bounce]
         plugin-easing-circ[Circ]
         plugin-easing-cubic[Cubic]
+        plugin-easing-elastic[Elastic]
         plugin-easing-expo[Expo]
+        plugin-easing-gaussian[Gaussian]
         plugin-easing-linear[Linear]
         plugin-easing-quart[Quart]
         plugin-easing-quint[Quint]
+        plugin-easing-sigmoid[Sigmoid]
         plugin-easing-sine[Sine]
+        plugin-easing-smoothstep[Smoothstep]
       end
 
       subgraph all-plugin-emitters-shapes [Emitters Shapes]
@@ -918,23 +950,30 @@ flowchart TD
         plugin-export-video[Video]
       end
 
-      plugin-hsv-color[HSV Color]
       plugin-infection[Infection]
+      plugin-manual-particles[Manual Particles]
       plugin-motion[Motion]
       plugin-poisson-disc[Poisson Disc]
       plugin-polygon-mask[Polygon Mask]
+      plugin-responsive[Responsive]
       plugin-sounds[Sounds]
+      plugin-themes[Themes]
+      plugin-trail[Trail]
+      plugin-zoom[Zoom]
     end
 
     subgraph all-shapes [Shapes]
       shape-arrow[Arrow]
       shape-cards[Cards]
       shape-cog[Cog]
       shape-heart[Heart]
+      shape-infinity[Infinity]
+      shape-matrix[Matrix]
       shape-path[Path]
       shape-rounded-polygon[Rounded Polygon]
       shape-rounded-rect[Rounded Rect]
       shape-spiral[Spiral]
+      shape-squircle[Squircle]
     end
 
     subgraph all-updaters [Updaters]

bundles/all/CHANGELOG.md

@@ -3,6 +3,10 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [4.0.0-alpha.28](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.27...v4.0.0-alpha.28) (2026-03-15)
+
+**Note:** Version bump only for package @tsparticles/all
+
 # [4.0.0-alpha.27](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.26...v4.0.0-alpha.27) (2026-03-09)
 
 ### Features

bundles/all/README.md

@@ -9,44 +9,198 @@
 **Included Packages**
 
 - [tsparticles (and all its dependencies)](https://github.com/tsparticles/tsparticles/tree/main/bundles/full)
+- [@tsparticles/engine](https://github.com/tsparticles/tsparticles/tree/main/engine)
+- [@tsparticles/effect-bubble](https://github.com/tsparticles/tsparticles/tree/main/effects/bubble)
+- [@tsparticles/effect-particles](https://github.com/tsparticles/tsparticles/tree/main/effects/particles)
+- [@tsparticles/effect-shadow](https://github.com/tsparticles/tsparticles/tree/main/effects/shadow)
+- [@tsparticles/effect-trail](https://github.com/tsparticles/tsparticles/tree/main/effects/trail)
 - [@tsparticles/interaction-external-particle](https://github.com/tsparticles/tsparticles/tree/main/interactions/external/particle)
 - [@tsparticles/interaction-external-pop](https://github.com/tsparticles/tsparticles/tree/main/interactions/external/pop)
 - [@tsparticles/interaction-light](https://github.com/tsparticles/tsparticles/tree/main/interactions/light)
 - [@tsparticles/interaction-particles-repulse](https://github.com/tsparticles/tsparticles/tree/main/interactions/particles/repulse)
+- [@tsparticles/path-branches](https://github.com/tsparticles/tsparticles/tree/main/paths/branches)
+- [@tsparticles/path-brownian](https://github.com/tsparticles/tsparticles/tree/main/paths/brownian)
+- [@tsparticles/path-curl-noise](https://github.com/tsparticles/tsparticles/tree/main/paths/curlNoise)
 - [@tsparticles/path-curves](https://github.com/tsparticles/tsparticles/tree/main/paths/curves)
+- [@tsparticles/path-fractal-noise](https://github.com/tsparticles/tsparticles/tree/main/paths/fractalNoise)
+- [@tsparticles/path-grid](https://github.com/tsparticles/tsparticles/tree/main/paths/grid)
+- [@tsparticles/path-levy](https://github.com/tsparticles/tsparticles/tree/main/paths/levy)
 - [@tsparticles/path-perlin-noise](https://github.com/tsparticles/tsparticles/tree/main/paths/perlinNoise)
 - [@tsparticles/path-polygon](https://github.com/tsparticles/tsparticles/tree/main/paths/polygon)
+- [@tsparticles/path-random](https://github.com/tsparticles/tsparticles/tree/main/paths/random)
 - [@tsparticles/path-simplex-noise](https://github.com/tsparticles/tsparticles/tree/main/paths/simplexNoise)
+- [@tsparticles/path-spiral](https://github.com/tsparticles/tsparticles/tree/main/paths/spiral)
 - [@tsparticles/path-svg](https://github.com/tsparticles/tsparticles/tree/main/paths/svg)
+- [@tsparticles/path-zig-zag](https://github.com/tsparticles/tsparticles/tree/main/paths/zigZag)
+- [@tsparticles/plugin-background-mask](https://github.com/tsparticles/tsparticles/tree/main/plugins/backgroundMask)
+- [@tsparticles/plugin-blend](https://github.com/tsparticles/tsparticles/tree/main/plugins/blend)
 - [@tsparticles/plugin-canvas-mask](https://github.com/tsparticles/tsparticles/tree/main/plugins/canvasMask)
 - [@tsparticles/plugin-easing-back](https://github.com/tsparticles/tsparticles/tree/main/plugins/easings/back)
+- [@tsparticles/plugin-easing-bounce](https://github.com/tsparticles/tsparticles/tree/main/plugins/easings/bounce)
 - [@tsparticles/plugin-easing-circ](https://github.com/tsparticles/tsparticles/tree/main/plugins/easings/circ)
 - [@tsparticles/plugin-easing-cubic](https://github.com/tsparticles/tsparticles/tree/main/plugins/easings/cubic)
+- [@tsparticles/plugin-easing-elastic](https://github.com/tsparticles/tsparticles/tree/main/plugins/easings/elastic)
 - [@tsparticles/plugin-easing-expo](https://github.com/tsparticles/tsparticles/tree/main/plugins/easings/expo)
+- [@tsparticles/plugin-easing-gaussian](https://github.com/tsparticles/tsparticles/tree/main/plugins/easings/gaussian)
+- [@tsparticles/plugin-easing-linear](https://github.com/tsparticles/tsparticles/tree/main/plugins/easings/linear)
 - [@tsparticles/plugin-easing-quart](https://github.com/tsparticles/tsparticles/tree/main/plugins/easings/quart)
 - [@tsparticles/plugin-easing-quint](https://github.com/tsparticles/tsparticles/tree/main/plugins/easings/quint)
+- [@tsparticles/plugin-easing-sigmoid](https://github.com/tsparticles/tsparticles/tree/main/plugins/easings/sigmoid)
 - [@tsparticles/plugin-easing-sine](https://github.com/tsparticles/tsparticles/tree/main/plugins/easings/sine)
+- [@tsparticles/plugin-easing-smoothstep](https://github.com/tsparticles/tsparticles/tree/main/plugins/easings/smoothstep)
+- [@tsparticles/plugin-emitters-shape-canvas](https://github.com/tsparticles/tsparticles/tree/main/plugins/emitters/shape/canvas)
+- [@tsparticles/plugin-emitters-shape-path](https://github.com/tsparticles/tsparticles/tree/main/plugins/emitters/shape/path)
+- [@tsparticles/plugin-emitters-shape-polygon](https://github.com/tsparticles/tsparticles/tree/main/plugins/emitters/shape/polygon)
 - [@tsparticles/plugin-export-image](https://github.com/tsparticles/tsparticles/tree/main/plugins/exports/image)
 - [@tsparticles/plugin-export-json](https://github.com/tsparticles/tsparticles/tree/main/plugins/exports/json)
 - [@tsparticles/plugin-export-video](https://github.com/tsparticles/tsparticles/tree/main/plugins/exports/video)
-- [@tsparticles/plugin-hsv-color](https://github.com/tsparticles/tsparticles/tree/main/plugins/hsvColor)
+- [@tsparticles/plugin-hsv-color](https://github.com/tsparticles/tsparticles/tree/main/plugins/colors/hsvColor)
+- [@tsparticles/plugin-hwb-color](https://github.com/tsparticles/tsparticles/tree/main/plugins/colors/hwbColor)
 - [@tsparticles/plugin-infection](https://github.com/tsparticles/tsparticles/tree/main/plugins/infection)
+- [@tsparticles/plugin-lab-color](https://github.com/tsparticles/tsparticles/tree/main/plugins/colors/labColor)
+- [@tsparticles/plugin-lch-color](https://github.com/tsparticles/tsparticles/tree/main/plugins/colors/lchColor)
+- [@tsparticles/plugin-manual-particles](https://github.com/tsparticles/tsparticles/tree/main/plugins/manualParticles)
 - [@tsparticles/plugin-motion](https://github.com/tsparticles/tsparticles/tree/main/plugins/motion)
-- [@tsparticles/plugin-named-color](https://github.com/tsparticles/tsparticles/tree/main/plugins/namedColor)
+- [@tsparticles/plugin-named-color](https://github.com/tsparticles/tsparticles/tree/main/plugins/colors/namedColor)
+- [@tsparticles/plugin-oklab-color](https://github.com/tsparticles/tsparticles/tree/main/plugins/colors/oklabColor)
+- [@tsparticles/plugin-oklch-color](https://github.com/tsparticles/tsparticles/tree/main/plugins/colors/oklchColor)
+- [@tsparticles/plugin-poisson-disc](https://github.com/tsparticles/tsparticles/tree/main/plugins/poissonDisc)
 - [@tsparticles/plugin-polygon-mask](https://github.com/tsparticles/tsparticles/tree/main/plugins/polygonMask)
+- [@tsparticles/plugin-responsive](https://github.com/tsparticles/tsparticles/tree/main/plugins/responsive)
 - [@tsparticles/plugin-sounds](https://github.com/tsparticles/tsparticles/tree/main/plugins/sounds)
+- [@tsparticles/plugin-themes](https://github.com/tsparticles/tsparticles/tree/main/plugins/themes)
+- [@tsparticles/plugin-trail](https://github.com/tsparticles/tsparticles/tree/main/plugins/trail)
+- [@tsparticles/plugin-zoom](https://github.com/tsparticles/tsparticles/tree/main/plugins/zoom)
 - [@tsparticles/shape-arrow](https://github.com/tsparticles/tsparticles/tree/main/shapes/arrow)
-- [@tsparticles/shape-bubble](https://github.com/tsparticles/tsparticles/tree/main/shapes/bubble)
 - [@tsparticles/shape-cards](https://github.com/tsparticles/tsparticles/tree/main/shapes/cards)
 - [@tsparticles/shape-cog](https://github.com/tsparticles/tsparticles/tree/main/shapes/cog)
 - [@tsparticles/shape-heart](https://github.com/tsparticles/tsparticles/tree/main/shapes/heart)
+- [@tsparticles/shape-infinity](https://github.com/tsparticles/tsparticles/tree/main/shapes/infinity)
+- [@tsparticles/shape-matrix](https://github.com/tsparticles/tsparticles/tree/main/shapes/matrix)
 - [@tsparticles/shape-path](https://github.com/tsparticles/tsparticles/tree/main/shapes/path)
 - [@tsparticles/shape-rounded-polygon](https://github.com/tsparticles/tsparticles/tree/main/shapes/polygon)
 - [@tsparticles/shape-rounded-rect](https://github.com/tsparticles/tsparticles/tree/main/shapes/rect)
 - [@tsparticles/shape-spiral](https://github.com/tsparticles/tsparticles/tree/main/shapes/spiral)
+- [@tsparticles/shape-squircle](https://github.com/tsparticles/tsparticles/tree/main/shapes/squircle)
 - [@tsparticles/updater-gradient](https://github.com/tsparticles/tsparticles/tree/main/updaters/gradient)
 - [@tsparticles/updater-orbit](https://github.com/tsparticles/tsparticles/tree/main/updaters/orbit)
 
+## Dependency Graph
+
+```mermaid
+flowchart TD
+
+subgraph b [Bundle]
+  ba[tsparticles/all]
+  bf[tsparticles]
+end
+
+subgraph c [Core]
+  ce[tsparticles/engine]
+end
+
+subgraph e [Effects]
+  eb[tsparticles/effect-bubble]
+  ep[tsparticles/effect-particles]
+  es[tsparticles/effect-shadow]
+  et[tsparticles/effect-trail]
+end
+
+subgraph i [Interactions]
+  iep[tsparticles/interaction-external-particle]
+  iepo[tsparticles/interaction-external-pop]
+  il[tsparticles/interaction-light]
+  ipr[tsparticles/interaction-particles-repulse]
+end
+
+subgraph pa [Paths]
+  pabr[tsparticles/path-branches]
+  pabrw[tsparticles/path-brownian]
+  pac[tsparticles/path-curl-noise]
+  pacu[tsparticles/path-curves]
+  paf[tsparticles/path-fractal-noise]
+  pag[tsparticles/path-grid]
+  pal[tsparticles/path-levy]
+  pap[tsparticles/path-perlin-noise]
+  papo[tsparticles/path-polygon]
+  par[tsparticles/path-random]
+  pas[tsparticles/path-simplex-noise]
+  pasp[tsparticles/path-spiral]
+  pasv[tsparticles/path-svg]
+  paz[tsparticles/path-zig-zag]
+end
+
+subgraph p [Plugins]
+  pbm[tsparticles/plugin-background-mask]
+  pbl[tsparticles/plugin-blend]
+  pcm[tsparticles/plugin-canvas-mask]
+  phsv[tsparticles/plugin-hsv-color]
+  phwb[tsparticles/plugin-hwb-color]
+  plab[tsparticles/plugin-lab-color]
+  plch[tsparticles/plugin-lch-color]
+  pnamed[tsparticles/plugin-named-color]
+  poklab[tsparticles/plugin-oklab-color]
+  poklch[tsparticles/plugin-oklch-color]
+  peback[tsparticles/plugin-easing-back]
+  pebounce[tsparticles/plugin-easing-bounce]
+  pecirc[tsparticles/plugin-easing-circ]
+  pecubic[tsparticles/plugin-easing-cubic]
+  peelastic[tsparticles/plugin-easing-elastic]
+  peexpo[tsparticles/plugin-easing-expo]
+  pegaussian[tsparticles/plugin-easing-gaussian]
+  pelinear[tsparticles/plugin-easing-linear]
+  pequart[tsparticles/plugin-easing-quart]
+  pequint[tsparticles/plugin-easing-quint]
+  pesigmoid[tsparticles/plugin-easing-sigmoid]
+  pesine[tsparticles/plugin-easing-sine]
+  pesmooth[tsparticles/plugin-easing-smoothstep]
+  pesc[tsparticles/plugin-emitters-shape-canvas]
+  pesp[tsparticles/plugin-emitters-shape-path]
+  pespo[tsparticles/plugin-emitters-shape-polygon]
+  pei[tsparticles/plugin-export-image]
+  pej[tsparticles/plugin-export-json]
+  pev[tsparticles/plugin-export-video]
+  pin[tsparticles/plugin-infection]
+  pmp[tsparticles/plugin-manual-particles]
+  pmo[tsparticles/plugin-motion]
+  ppd[tsparticles/plugin-poisson-disc]
+  ppm[tsparticles/plugin-polygon-mask]
+  pr[tsparticles/plugin-responsive]
+  ps[tsparticles/plugin-sounds]
+  pt[tsparticles/plugin-themes]
+  ptr[tsparticles/plugin-trail]
+  pz[tsparticles/plugin-zoom]
+end
+
+subgraph s [Shapes]
+  sar[tsparticles/shape-arrow]
+  sca[tsparticles/shape-cards]
+  sco[tsparticles/shape-cog]
+  sh[tsparticles/shape-heart]
+  si[tsparticles/shape-infinity]
+  sm[tsparticles/shape-matrix]
+  sp[tsparticles/shape-path]
+  srp[tsparticles/shape-rounded-polygon]
+  srr[tsparticles/shape-rounded-rect]
+  ss[tsparticles/shape-spiral]
+  ssq[tsparticles/shape-squircle]
+end
+
+subgraph u [Updaters]
+  ug[tsparticles/updater-gradient]
+  uo[tsparticles/updater-orbit]
+end
+
+ba --> bf
+ba --> ce
+ba --> e
+ba --> i
+ba --> pa
+ba --> p
+ba --> s
+ba --> u
+```
+
 ## How to use it
 
 ### CDN / Vanilla JS / jQuery
@@ -192,7 +346,7 @@ let options = {
   /* custom options */
 };
 
-let particlesInit = async (engine) => {
+let particlesInit = async engine => {
   await loadAll(engine);
 };
 ```