Merge pull request tsparticles#5572 from tsparticles/v4

4.0.0-alpha.14

Author: matteobruni

.gemini/settings.json

@@ -1,13 +1,13 @@
 {
-    "mcpServers": {
-        "nx-mcp": {
-            "type": "stdio",
-            "command": "npx",
-            "args": [
-                "nx",
-                "mcp"
-            ]
-        }
-    },
-    "contextFileName": "AGENTS.md"
+  "mcpServers": {
+    "nx-mcp": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "nx",
+        "mcp"
+      ]
+    }
+  },
+  "contextFileName": "AGENTS.md"
 }

.github/workflows/npm-publish.yml

@@ -29,22 +29,29 @@ jobs:
 
       - run: pnpm install
 
+      - name: Build All Packages
+        run: pnpm run build:ci
+        env:
+          CI: true
+
       - name: Publish
         run: |
+          npm config set //registry.npmjs.org/:_authToken ""
+          
           TAG="${GITHUB_REF#refs/tags/}"
+          
+          BASE_CMD="lerna publish from-package --ignore-scripts --loglevel verbose"
 
           if [[ "$TAG" == *"-alpha."* ]]; then
-            pnpm run publish:alpha
+            $BASE_CMD --pre-dist-tag alpha --preid alpha
           elif [[ "$TAG" == *"-beta."* ]]; then
-            pnpm run publish:beta
+            $BASE_CMD --pre-dist-tag beta --preid beta
+          elif [[ "$TAG" == v1* ]]; then
+            $BASE_CMD --dist-tag v1
+          elif [[ "$TAG" == v2* ]]; then
+            $BASE_CMD --dist-tag v2
+          elif [[ "$TAG" == v3* ]]; then
+            $BASE_CMD --dist-tag v3
           else
-            if [[ "$TAG" == v1* ]]; then
-              pnpm run publish:v1
-            elif [[ "$TAG" == v2* ]]; then
-              pnpm run publish:v2
-            elif [[ "$TAG" == v3* ]]; then
-              pnpm run publish:v3
-            else
-              pnpm run publish:next
-            fi
+            $BASE_CMD
           fi

.mcp.json

@@ -1,12 +1,12 @@
 {
-    "mcpServers": {
-        "nx-mcp": {
-            "type": "stdio",
-            "command": "npx",
-            "args": [
-                "nx",
-                "mcp"
-            ]
-        }
+  "mcpServers": {
+    "nx-mcp": {
+      "type": "stdio",
+      "command": "npx",
+      "args": [
+        "nx",
+        "mcp"
+      ]
     }
+  }
 }

AGENTS.md

@@ -9,5 +9,6 @@
 - When working in individual projects, use the `nx_project_details` mcp tool to analyze and understand the specific project structure and dependencies
 - For questions around nx configuration, best practices or if you're unsure, use the `nx_docs` tool to get relevant, up-to-date docs. Always use this instead of assuming things about nx configuration
 - If the user needs help with an Nx configuration or project graph error, use the `nx_workspace` tool to get any errors
+- For Nx plugin best practices, check `node_modules/@nx/<plugin>/PLUGIN.md`. Not all plugins have this file - proceed without it if unavailable.
 
 <!-- nx configuration end-->

CHANGELOG.md

@@ -3,6 +3,59 @@
 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.14](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.13...v4.0.0-alpha.14) (2026-02-02)
+
+**Note:** Version bump only for package @tsparticles/workspace
+
+# [4.0.0-alpha.13](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.12...v4.0.0-alpha.13) (2026-02-02)
+
+### Bug Fixes
+
+- fixed some issues with emitters/absorbers life ([76f95ad](https://github.com/tsparticles/tsparticles/commit/76f95ad53bb9f7a9bc36e1cb725a4dac9e549d4e))
+
+# [4.0.0-alpha.12](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.11...v4.0.0-alpha.12) (2026-02-02)
+
+**Note:** Version bump only for package @tsparticles/workspace
+
+# [4.0.0-alpha.11](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.10...v4.0.0-alpha.11) (2026-02-02)
+
+### Bug Fixes
+
+- small fixes ([ea234fc](https://github.com/tsparticles/tsparticles/commit/ea234fc0bf5d373ccfc1b1d259ccea6a66934426))
+- small fixes ([c4e6d06](https://github.com/tsparticles/tsparticles/commit/c4e6d0691b9055165fb745eb6a77d6601dcebae2))
+
+# [4.0.0-alpha.10](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.9...v4.0.0-alpha.10) (2026-02-02)
+
+**Note:** Version bump only for package @tsparticles/workspace
+
+# [4.0.0-alpha.9](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.8...v4.0.0-alpha.9) (2026-02-02)
+
+### Bug Fixes
+
+- add particle to pool when unable to add to the canvas ([90343c7](https://github.com/tsparticles/tsparticles/commit/90343c7d933eabe5862cd44c49dac0e443a4328b))
+- change break to continue in default case for better flow ([c397377](https://github.com/tsparticles/tsparticles/commit/c3973771e2485627cba03f1b563861a6c24278da))
+- clear all relevant plugin types from container in clearPlugins method ([9c582ee](https://github.com/tsparticles/tsparticles/commit/9c582ee8801696cc84f9772a506f617e21aa36d7))
+- fixed performance picking only the used path generators ([8426714](https://github.com/tsparticles/tsparticles/commit/842671431c14336ee8182532361e35f64660edb5))
+- fixed some plugins initializations and cleanup ([f58601c](https://github.com/tsparticles/tsparticles/commit/f58601c61cf71509ec51f321a1aa9cbfaa55877d))
+- improved roll angle calculation and logic ([a886da3](https://github.com/tsparticles/tsparticles/commit/a886da36443ca811fdb5ec09cdfe0ebb9e8bf870))
+- remove unnecessary comment in Engine.ts ([fdee2c8](https://github.com/tsparticles/tsparticles/commit/fdee2c87727d24e32ed1808ebf801302e34e5015))
+- update getCacheKey function to include hdr parameter ([8dfa161](https://github.com/tsparticles/tsparticles/commit/8dfa16101a63de4d5d7df4c4073feb74ec6bce90))
+- update path generator reference in Particles.ts ([97dbfca](https://github.com/tsparticles/tsparticles/commit/97dbfca7751664a5207390e777a36fe47a41b29a))
+
+### Features
+
+- add branches path generator and related configurations ([41de076](https://github.com/tsparticles/tsparticles/commit/41de07658b1d5ab92f566520ac197fcacc17ac18))
+- add brownian path generator and related configurations ([d42ccaf](https://github.com/tsparticles/tsparticles/commit/d42ccaf6903309bc3c9c55ca7e4d501f767c6bcb))
+- add effect particles with configuration and drawing logic ([dee10d8](https://github.com/tsparticles/tsparticles/commit/dee10d847b4339f38432906cd36e4a5c51679f7a))
+- add full card shape, and utilities for path drawing ([f4a985f](https://github.com/tsparticles/tsparticles/commit/f4a985f092e7da94e6f8bd211c3007246d0488b3))
+- add grid and maze path options for particle movement ([400a6f6](https://github.com/tsparticles/tsparticles/commit/400a6f652de8bbd192ceda25a37517f25e3f01d2))
+- add grid path generator and related files ([5d2a1c8](https://github.com/tsparticles/tsparticles/commit/5d2a1c869fb5b9fcfba07a31214c4b68455c59c7))
+- add Levy path generator and related configurations ([ae59df8](https://github.com/tsparticles/tsparticles/commit/ae59df81081c2436be6d38afb6f2c5997820d1fb))
+- add life management to Absorber with new AbsorberLife class ([78b5126](https://github.com/tsparticles/tsparticles/commit/78b512680df568a196c80ce4afceeb5916906f41))
+- add spiral path generator and related files ([5aeeb58](https://github.com/tsparticles/tsparticles/commit/5aeeb58c6413db6cee187c43c2d95620c866b409))
+- initialize plugin arrays for particle updates ([d0cd05d](https://github.com/tsparticles/tsparticles/commit/d0cd05d06f629bb4e51682bbe9c373e8987ee72b))
+- refactor path generators to use container-specific options and add spiral path generator ([3aa87c3](https://github.com/tsparticles/tsparticles/commit/3aa87c39c5a70adfb146cd281b62a229623e3412))
+
 # [4.0.0-alpha.8](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.7...v4.0.0-alpha.8) (2026-01-22)
 
 **Note:** Version bump only for package @tsparticles/workspace

CLAUDE.md

@@ -9,5 +9,6 @@
 - When working in individual projects, use the `nx_project_details` mcp tool to analyze and understand the specific project structure and dependencies
 - For questions around nx configuration, best practices or if you're unsure, use the `nx_docs` tool to get relevant, up-to-date docs. Always use this instead of assuming things about nx configuration
 - If the user needs help with an Nx configuration or project graph error, use the `nx_workspace` tool to get any errors
+- For Nx plugin best practices, check `node_modules/@nx/<plugin>/PLUGIN.md`. Not all plugins have this file - proceed without it if unavailable.
 
 <!-- nx configuration end-->

bundles/all/CHANGELOG.md

@@ -3,6 +3,33 @@
 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.14](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.13...v4.0.0-alpha.14) (2026-02-02)
+
+**Note:** Version bump only for package @tsparticles/all
+
+# [4.0.0-alpha.13](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.12...v4.0.0-alpha.13) (2026-02-02)
+
+**Note:** Version bump only for package @tsparticles/all
+
+# [4.0.0-alpha.11](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.10...v4.0.0-alpha.11) (2026-02-02)
+
+**Note:** Version bump only for package @tsparticles/all
+
+# [4.0.0-alpha.10](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.9...v4.0.0-alpha.10) (2026-02-02)
+
+**Note:** Version bump only for package @tsparticles/all
+
+# [4.0.0-alpha.9](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.8...v4.0.0-alpha.9) (2026-02-02)
+
+### Features
+
+- add branches path generator and related configurations ([41de076](https://github.com/tsparticles/tsparticles/commit/41de07658b1d5ab92f566520ac197fcacc17ac18))
+- add brownian path generator and related configurations ([d42ccaf](https://github.com/tsparticles/tsparticles/commit/d42ccaf6903309bc3c9c55ca7e4d501f767c6bcb))
+- add effect particles with configuration and drawing logic ([dee10d8](https://github.com/tsparticles/tsparticles/commit/dee10d847b4339f38432906cd36e4a5c51679f7a))
+- add grid path generator and related files ([5d2a1c8](https://github.com/tsparticles/tsparticles/commit/5d2a1c869fb5b9fcfba07a31214c4b68455c59c7))
+- add Levy path generator and related configurations ([ae59df8](https://github.com/tsparticles/tsparticles/commit/ae59df81081c2436be6d38afb6f2c5997820d1fb))
+- add spiral path generator and related files ([5aeeb58](https://github.com/tsparticles/tsparticles/commit/5aeeb58c6413db6cee187c43c2d95620c866b409))
+
 # [4.0.0-alpha.8](https://github.com/tsparticles/tsparticles/compare/v4.0.0-alpha.7...v4.0.0-alpha.8) (2026-01-22)
 
 **Note:** Version bump only for package @tsparticles/all

bundles/all/package.dist.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/all",
-  "version": "4.0.0-alpha.8",
+  "version": "4.0.0-alpha.14",
   "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.",
   "homepage": "https://particles.js.org",
   "repository": {
@@ -99,72 +99,78 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@tsparticles/effect-bubble": "4.0.0-alpha.8",
-    "@tsparticles/effect-shadow": "4.0.0-alpha.8",
-    "@tsparticles/effect-trail": "4.0.0-alpha.8",
-    "@tsparticles/engine": "4.0.0-alpha.8",
-    "@tsparticles/interaction-external-particle": "4.0.0-alpha.8",
-    "@tsparticles/interaction-external-pop": "4.0.0-alpha.8",
-    "@tsparticles/interaction-light": "4.0.0-alpha.8",
-    "@tsparticles/interaction-particles-repulse": "4.0.0-alpha.8",
-    "@tsparticles/path-curl-noise": "4.0.0-alpha.8",
-    "@tsparticles/path-curves": "4.0.0-alpha.8",
-    "@tsparticles/path-fractal-noise": "4.0.0-alpha.8",
-    "@tsparticles/path-perlin-noise": "4.0.0-alpha.8",
-    "@tsparticles/path-polygon": "4.0.0-alpha.8",
-    "@tsparticles/path-simplex-noise": "4.0.0-alpha.8",
-    "@tsparticles/path-svg": "4.0.0-alpha.8",
-    "@tsparticles/path-zig-zag": "4.0.0-alpha.8",
-    "@tsparticles/plugin-background-mask": "4.0.0-alpha.8",
-    "@tsparticles/plugin-blend": "4.0.0-alpha.8",
-    "@tsparticles/plugin-canvas-mask": "4.0.0-alpha.8",
-    "@tsparticles/plugin-easing-back": "4.0.0-alpha.8",
-    "@tsparticles/plugin-easing-bounce": "4.0.0-alpha.8",
-    "@tsparticles/plugin-easing-circ": "4.0.0-alpha.8",
-    "@tsparticles/plugin-easing-cubic": "4.0.0-alpha.8",
-    "@tsparticles/plugin-easing-elastic": "4.0.0-alpha.8",
-    "@tsparticles/plugin-easing-expo": "4.0.0-alpha.8",
-    "@tsparticles/plugin-easing-gaussian": "4.0.0-alpha.8",
-    "@tsparticles/plugin-easing-linear": "4.0.0-alpha.8",
-    "@tsparticles/plugin-easing-quart": "4.0.0-alpha.8",
-    "@tsparticles/plugin-easing-quint": "4.0.0-alpha.8",
-    "@tsparticles/plugin-easing-sigmoid": "4.0.0-alpha.8",
-    "@tsparticles/plugin-easing-sine": "4.0.0-alpha.8",
-    "@tsparticles/plugin-easing-smoothstep": "4.0.0-alpha.8",
-    "@tsparticles/plugin-emitters-shape-canvas": "4.0.0-alpha.8",
-    "@tsparticles/plugin-emitters-shape-path": "4.0.0-alpha.8",
-    "@tsparticles/plugin-emitters-shape-polygon": "4.0.0-alpha.8",
-    "@tsparticles/plugin-export-image": "4.0.0-alpha.8",
-    "@tsparticles/plugin-export-json": "4.0.0-alpha.8",
-    "@tsparticles/plugin-export-video": "4.0.0-alpha.8",
-    "@tsparticles/plugin-hsv-color": "4.0.0-alpha.8",
-    "@tsparticles/plugin-hwb-color": "4.0.0-alpha.8",
-    "@tsparticles/plugin-infection": "4.0.0-alpha.8",
-    "@tsparticles/plugin-lab-color": "4.0.0-alpha.8",
-    "@tsparticles/plugin-lch-color": "4.0.0-alpha.8",
-    "@tsparticles/plugin-manual-particles": "4.0.0-alpha.8",
-    "@tsparticles/plugin-motion": "4.0.0-alpha.8",
-    "@tsparticles/plugin-named-color": "4.0.0-alpha.8",
-    "@tsparticles/plugin-oklab-color": "4.0.0-alpha.8",
-    "@tsparticles/plugin-oklch-color": "4.0.0-alpha.8",
-    "@tsparticles/plugin-poisson-disc": "4.0.0-alpha.8",
-    "@tsparticles/plugin-polygon-mask": "4.0.0-alpha.8",
-    "@tsparticles/plugin-responsive": "4.0.0-alpha.8",
-    "@tsparticles/plugin-sounds": "4.0.0-alpha.8",
-    "@tsparticles/plugin-themes": "4.0.0-alpha.8",
-    "@tsparticles/plugin-trail": "4.0.0-alpha.8",
-    "@tsparticles/shape-arrow": "4.0.0-alpha.8",
-    "@tsparticles/shape-cards": "4.0.0-alpha.8",
-    "@tsparticles/shape-cog": "4.0.0-alpha.8",
-    "@tsparticles/shape-heart": "4.0.0-alpha.8",
-    "@tsparticles/shape-infinity": "4.0.0-alpha.8",
-    "@tsparticles/shape-path": "4.0.0-alpha.8",
-    "@tsparticles/shape-rounded-polygon": "4.0.0-alpha.8",
-    "@tsparticles/shape-rounded-rect": "4.0.0-alpha.8",
-    "@tsparticles/shape-spiral": "4.0.0-alpha.8",
-    "@tsparticles/updater-gradient": "4.0.0-alpha.8",
-    "@tsparticles/updater-orbit": "4.0.0-alpha.8",
-    "tsparticles": "4.0.0-alpha.8"
+    "@tsparticles/effect-bubble": "4.0.0-alpha.14",
+    "@tsparticles/effect-particles": "4.0.0-alpha.14",
+    "@tsparticles/effect-shadow": "4.0.0-alpha.14",
+    "@tsparticles/effect-trail": "4.0.0-alpha.14",
+    "@tsparticles/engine": "4.0.0-alpha.14",
+    "@tsparticles/interaction-external-particle": "4.0.0-alpha.14",
+    "@tsparticles/interaction-external-pop": "4.0.0-alpha.14",
+    "@tsparticles/interaction-light": "4.0.0-alpha.14",
+    "@tsparticles/interaction-particles-repulse": "4.0.0-alpha.14",
+    "@tsparticles/path-branches": "4.0.0-alpha.14",
+    "@tsparticles/path-brownian": "4.0.0-alpha.14",
+    "@tsparticles/path-curl-noise": "4.0.0-alpha.14",
+    "@tsparticles/path-curves": "4.0.0-alpha.14",
+    "@tsparticles/path-fractal-noise": "4.0.0-alpha.14",
+    "@tsparticles/path-grid": "4.0.0-alpha.14",
+    "@tsparticles/path-levy": "4.0.0-alpha.14",
+    "@tsparticles/path-perlin-noise": "4.0.0-alpha.14",
+    "@tsparticles/path-polygon": "4.0.0-alpha.14",
+    "@tsparticles/path-simplex-noise": "4.0.0-alpha.14",
+    "@tsparticles/path-spiral": "4.0.0-alpha.14",
+    "@tsparticles/path-svg": "4.0.0-alpha.14",
+    "@tsparticles/path-zig-zag": "4.0.0-alpha.14",
+    "@tsparticles/plugin-background-mask": "4.0.0-alpha.14",
+    "@tsparticles/plugin-blend": "4.0.0-alpha.14",
+    "@tsparticles/plugin-canvas-mask": "4.0.0-alpha.14",
+    "@tsparticles/plugin-easing-back": "4.0.0-alpha.14",
+    "@tsparticles/plugin-easing-bounce": "4.0.0-alpha.14",
+    "@tsparticles/plugin-easing-circ": "4.0.0-alpha.14",
+    "@tsparticles/plugin-easing-cubic": "4.0.0-alpha.14",
+    "@tsparticles/plugin-easing-elastic": "4.0.0-alpha.14",
+    "@tsparticles/plugin-easing-expo": "4.0.0-alpha.14",
+    "@tsparticles/plugin-easing-gaussian": "4.0.0-alpha.14",
+    "@tsparticles/plugin-easing-linear": "4.0.0-alpha.14",
+    "@tsparticles/plugin-easing-quart": "4.0.0-alpha.14",
+    "@tsparticles/plugin-easing-quint": "4.0.0-alpha.14",
+    "@tsparticles/plugin-easing-sigmoid": "4.0.0-alpha.14",
+    "@tsparticles/plugin-easing-sine": "4.0.0-alpha.14",
+    "@tsparticles/plugin-easing-smoothstep": "4.0.0-alpha.14",
+    "@tsparticles/plugin-emitters-shape-canvas": "4.0.0-alpha.14",
+    "@tsparticles/plugin-emitters-shape-path": "4.0.0-alpha.14",
+    "@tsparticles/plugin-emitters-shape-polygon": "4.0.0-alpha.14",
+    "@tsparticles/plugin-export-image": "4.0.0-alpha.14",
+    "@tsparticles/plugin-export-json": "4.0.0-alpha.14",
+    "@tsparticles/plugin-export-video": "4.0.0-alpha.14",
+    "@tsparticles/plugin-hsv-color": "4.0.0-alpha.14",
+    "@tsparticles/plugin-hwb-color": "4.0.0-alpha.14",
+    "@tsparticles/plugin-infection": "4.0.0-alpha.14",
+    "@tsparticles/plugin-lab-color": "4.0.0-alpha.14",
+    "@tsparticles/plugin-lch-color": "4.0.0-alpha.14",
+    "@tsparticles/plugin-manual-particles": "4.0.0-alpha.14",
+    "@tsparticles/plugin-motion": "4.0.0-alpha.14",
+    "@tsparticles/plugin-named-color": "4.0.0-alpha.14",
+    "@tsparticles/plugin-oklab-color": "4.0.0-alpha.14",
+    "@tsparticles/plugin-oklch-color": "4.0.0-alpha.14",
+    "@tsparticles/plugin-poisson-disc": "4.0.0-alpha.14",
+    "@tsparticles/plugin-polygon-mask": "4.0.0-alpha.14",
+    "@tsparticles/plugin-responsive": "4.0.0-alpha.14",
+    "@tsparticles/plugin-sounds": "4.0.0-alpha.14",
+    "@tsparticles/plugin-themes": "4.0.0-alpha.14",
+    "@tsparticles/plugin-trail": "4.0.0-alpha.14",
+    "@tsparticles/shape-arrow": "4.0.0-alpha.14",
+    "@tsparticles/shape-cards": "4.0.0-alpha.14",
+    "@tsparticles/shape-cog": "4.0.0-alpha.14",
+    "@tsparticles/shape-heart": "4.0.0-alpha.14",
+    "@tsparticles/shape-infinity": "4.0.0-alpha.14",
+    "@tsparticles/shape-path": "4.0.0-alpha.14",
+    "@tsparticles/shape-rounded-polygon": "4.0.0-alpha.14",
+    "@tsparticles/shape-rounded-rect": "4.0.0-alpha.14",
+    "@tsparticles/shape-spiral": "4.0.0-alpha.14",
+    "@tsparticles/updater-gradient": "4.0.0-alpha.14",
+    "@tsparticles/updater-orbit": "4.0.0-alpha.14",
+    "tsparticles": "4.0.0-alpha.14"
   },
   "publishConfig": {
     "access": "public"