Uncodedtech · pull · Jun 3, 2026 · Jun 3, 2026 · Jun 3, 2026 · Jun 3, 2026
diff --git a/bundles/ribbons/README.md b/bundles/ribbons/README.md
@@ -64,7 +64,8 @@ Main options:
 
 - `count` _Integer (default: 5)_
 - `ticks` _Number (default: 200)_
-- `position` _Object_ (`x`/`y`, default 50/0)
+- `position` _Object_ (`x`/`y`, default 50/0, in percent)
+- `emitterSize` _Object_ (`width`/`height`, default 100/0, in percent)
 - `colors` _Array&lt;String&gt;_
 - `ribbonOptions` _Object_ (`particles.shape.options.ribbon`)
   - Includes `darken: { enable: true, value: 30 }` by default
@@ -73,7 +74,7 @@ Main options:
 - `disableForReducedMotion` _Boolean (default: true)_
 
 The `ribbons` bundle disables `roll`, `rotate`, `tilt`, and `wobble` on ribbon particles by default for better shape stability.
-The emitter uses a full-width top strip (`width: 100`, `height: 0`) and downward movement speed range (`4..6`) for a falling-from-top behavior.
+The emitter spawns from the configured `position` using a full-width strip and downward movement for a falling-from-top effect.
 
 Deprecated aliases still accepted:
 

diff --git a/bundles/ribbons/src/IRibbonsOptions.ts b/bundles/ribbons/src/IRibbonsOptions.ts
@@ -2,9 +2,6 @@ import type { ICoordinates, IDimension, IShapeValues, SingleOrMultiple } from "@
 
 /** Ribbons options interface */
 export interface IRibbonsOptions {
-  /** Ribbons emission angle */
-  angle: number;
-
   /** Ribbon colors */
   colors: SingleOrMultiple<string>;
 
@@ -14,9 +11,6 @@ export interface IRibbonsOptions {
   /** Disables ribbons for users who prefer reduced motion */
   disableForReducedMotion: boolean;
 
-  /** Ribbons drift */
-  drift: number;
-
   /** Emitter size for particle spawn area (in percent). Default: { width: 100, height: 0 } */
   emitterSize: IDimension;
 
@@ -39,9 +33,6 @@ export interface IRibbonsOptions {
   /** Ribbons size scalar */
   scalar: number;
 
-  /** Ribbons spread */
-  spread: number;
-
   /** Number of animation ticks */
   ticks: number;
 

diff --git a/bundles/ribbons/src/RibbonsOptions.ts b/bundles/ribbons/src/RibbonsOptions.ts
@@ -14,9 +14,6 @@ import type { IRibbonsOptions } from "./IRibbonsOptions.js";
 
 /** Ribbons options class */
 export class RibbonsOptions implements IRibbonsOptions, IOptionLoader<IRibbonsOptions> {
-  /** Ribbons angle */
-  angle: number;
-
   /** Ribbon colors */
   colors: SingleOrMultiple<string>;
 
@@ -26,9 +23,6 @@ export class RibbonsOptions implements IRibbonsOptions, IOptionLoader<IRibbonsOp
   /** Disables ribbons for users who prefer reduced motion */
   disableForReducedMotion: boolean;
 
-  /** Ribbons drift offset */
-  drift: number;
-
   /** Emitter size for particle spawn area */
   emitterSize: IDimension;
 
@@ -41,9 +35,6 @@ export class RibbonsOptions implements IRibbonsOptions, IOptionLoader<IRibbonsOp
   /** Ribbons size scalar */
   scalar: number;
 
-  /** Ribbons spread angle */
-  spread: number;
-
   /** Ribbons animation ticks */
   ticks: number;
 
@@ -52,10 +43,7 @@ export class RibbonsOptions implements IRibbonsOptions, IOptionLoader<IRibbonsOp
 
   /** Creates a new RibbonsOptions instance with default values */
   constructor() {
-    this.angle = 90;
     this.count = 5;
-    this.spread = 0;
-    this.drift = 0;
     this.emitterSize = {
       width: 100,
       height: 0,
@@ -137,25 +125,13 @@ export class RibbonsOptions implements IRibbonsOptions, IOptionLoader<IRibbonsOp
       return;
     }
 
-    if (data.angle !== undefined) {
-      this.angle = data.angle;
-    }
-
     // eslint-disable-next-line @typescript-eslint/no-deprecated
     const count = data.count ?? data.particleCount;
 
     if (count !== undefined) {
       this.count = count;
     }
 
-    if (data.spread !== undefined) {
-      this.spread = data.spread;
-    }
-
-    if (data.drift !== undefined) {
-      this.drift = data.drift;
-    }
-
     if (data.ticks !== undefined) {
       this.ticks = data.ticks;
     }

diff --git a/scripts/resolve-dist-package.cjs b/scripts/resolve-dist-package.cjs
@@ -10,7 +10,13 @@ const distPkgOut = path.join(distDir, "package.json");
 
 const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
 const distPkg = JSON.parse(fs.readFileSync(distPkgPath, "utf8"));
+const srcPkg = JSON.parse(fs.readFileSync(distPkgPath, "utf8"));
 
+/* sync version back to source template, but keep __VERSION__ placeholders intact */
+srcPkg.version = pkg.version;
+fs.writeFileSync(distPkgPath, JSON.stringify(srcPkg, null, 2) + "\n");
+
+/* resolve __VERSION__ for the published dist/package.json */
 distPkg.version = pkg.version;
 
 for (const key of ["dependencies", "peerDependencies", "optionalDependencies"]) {

diff --git a/websites/ribbons/README.md b/websites/ribbons/README.md
@@ -6,7 +6,7 @@ tsParticles official ribbons website examples.
 
 - Basic Ribbons
 - Custom Colors
-- Wide Spread
+- Multiple Bursts
 - Continuous Fall
 - Custom Canvas
 - Fixed Position

diff --git a/websites/ribbons/src/main.js b/websites/ribbons/src/main.js
@@ -255,34 +255,23 @@ const modes = [
   },
 
   {
-    id: 'spread',
-    name: 'Wide Spread',
+    id: 'multiple',
+    name: 'Multiple Bursts',
     description: [
       {
         cssClass: '',
-        text: 'Create a cascading ribbon waterfall effect by combining spread, angle, and multiple counts.',
+        text: 'Spawn multiple ribbon bursts with staggered timing for a layered cascading effect.',
       },
     ],
     fn: function () {
-      ribbons({
-        count: 2,
-        spread: 60,
-      });
+      ribbons();
 
       setTimeout(() => {
-        ribbons({
-          count: 2,
-          spread: 60,
-          angle: 60,
-        });
+        ribbons();
       }, 300);
 
       setTimeout(() => {
-        ribbons({
-          count: 2,
-          spread: 60,
-          angle: 120,
-        });
+        ribbons();
       }, 600);
     },
   },

diff --git a/websites/website/docs/de/demos/recipes/ribbons.md b/websites/website/docs/de/demos/recipes/ribbons.md
@@ -17,7 +17,6 @@ import { ribbons } from "@tsparticles/ribbons";
 
 await ribbons({
   count: 5,
-  spread: 0,
   colors: ["#FF0055", "#00D1FF", "#FFD23F", "#61FF7E", "#B284FF"],
 });
 ```

diff --git a/websites/website/docs/demos/recipes/ribbons.md b/websites/website/docs/demos/recipes/ribbons.md
@@ -17,7 +17,6 @@ import { ribbons } from "@tsparticles/ribbons";
 
 await ribbons({
   count: 5,
-  spread: 0,
   colors: ["#FF0055", "#00D1FF", "#FFD23F", "#61FF7E", "#B284FF"],
 });
 ```

diff --git a/websites/website/docs/es/demos/recipes/ribbons.md b/websites/website/docs/es/demos/recipes/ribbons.md
@@ -17,7 +17,6 @@ import { ribbons } from "@tsparticles/ribbons";
 
 await ribbons({
   count: 5,
-  spread: 0,
   colors: ["#FF0055", "#00D1FF", "#FFD23F", "#61FF7E", "#B284FF"],
 });
 ```

diff --git a/websites/website/docs/fr/demos/recipes/ribbons.md b/websites/website/docs/fr/demos/recipes/ribbons.md
@@ -17,7 +17,6 @@ import { ribbons } from "@tsparticles/ribbons";
 
 await ribbons({
   count: 5,
-  spread: 0,
   colors: ["#FF0055", "#00D1FF", "#FFD23F", "#61FF7E", "#B284FF"],
 });
 ```

diff --git a/websites/website/docs/hi/demos/recipes/ribbons.md b/websites/website/docs/hi/demos/recipes/ribbons.md
@@ -17,7 +17,6 @@ import { ribbons } from "@tsparticles/ribbons";
 
 await ribbons({
   count: 5,
-  spread: 0,
   colors: ["#FF0055", "#00D1FF", "#FFD23F", "#61FF7E", "#B284FF"],
 });
 ```

diff --git a/websites/website/docs/it/demos/recipes/ribbons.md b/websites/website/docs/it/demos/recipes/ribbons.md
@@ -17,7 +17,6 @@ import { ribbons } from "@tsparticles/ribbons";
 
 await ribbons({
   count: 5,
-  spread: 0,
   colors: ["#FF0055", "#00D1FF", "#FFD23F", "#61FF7E", "#B284FF"],
 });
 ```

diff --git a/websites/website/docs/ja/demos/recipes/ribbons.md b/websites/website/docs/ja/demos/recipes/ribbons.md
@@ -17,7 +17,6 @@ import { ribbons } from "@tsparticles/ribbons";
 
 await ribbons({
   count: 5,
-  spread: 0,
   colors: ["#FF0055", "#00D1FF", "#FFD23F", "#61FF7E", "#B284FF"],
 });
 ```

diff --git a/websites/website/docs/pt/demos/recipes/ribbons.md b/websites/website/docs/pt/demos/recipes/ribbons.md
@@ -17,7 +17,6 @@ import { ribbons } from "@tsparticles/ribbons";
 
 await ribbons({
   count: 5,
-  spread: 0,
   colors: ["#FF0055", "#00D1FF", "#FFD23F", "#61FF7E", "#B284FF"],
 });
 ```

diff --git a/websites/website/docs/ru/demos/recipes/ribbons.md b/websites/website/docs/ru/demos/recipes/ribbons.md
@@ -17,7 +17,6 @@ import { ribbons } from "@tsparticles/ribbons";
 
 await ribbons({
   count: 5,
-  spread: 0,
   colors: ["#FF0055", "#00D1FF", "#FFD23F", "#61FF7E", "#B284FF"],
 });
 ```

diff --git a/websites/website/docs/zh/demos/recipes/ribbons.md b/websites/website/docs/zh/demos/recipes/ribbons.md
@@ -17,7 +17,6 @@ import { ribbons } from "@tsparticles/ribbons";
 
 await ribbons({
   count: 5,
-  spread: 0,
   colors: ["#FF0055", "#00D1FF", "#FFD23F", "#61FF7E", "#B284FF"],
 });
 ```

diff --git a/wrappers/astro/package.dist.json b/wrappers/astro/package.dist.json
@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/astro",
-  "version": "4.0.5",
+  "version": "4.1.3",
   "description": "Official tsParticles Astro Component - Easily create highly customizable particle, confetti and fireworks animations and use them as animated backgrounds for your website. Ready to use components available also for Web Components, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, React.js, Riot.js, Solid.js, Inferno.",
   "repository": {
     "url": "git+https://github.com/tsparticles/tsparticles.git",

diff --git a/wrappers/ember/package.dist.json b/wrappers/ember/package.dist.json
@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/ember",
-  "version": "4.0.5",
+  "version": "4.1.3",
   "description": "Ember.js component for using tsParticles",
   "repository": {
     "type": "git",

diff --git a/wrappers/inferno/package.dist.json b/wrappers/inferno/package.dist.json
@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/inferno",
-  "version": "4.0.5",
+  "version": "4.1.3",
   "description": "Official tsParticles Inferno Component - Easily create highly customizable particle, confetti and fireworks animations and use them as animated backgrounds for your website. Ready to use components available also for Web Components, React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Riot.js, Solid.js.",
   "homepage": "https://particles.js.org",
   "repository": {

diff --git a/wrappers/jquery/package.dist.json b/wrappers/jquery/package.dist.json
@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/jquery",
-  "version": "4.0.5",
+  "version": "4.1.3",
   "description": "Official tsParticles jQuery Plugin - Easily create highly customizable particle, confetti and fireworks animations and use them as animated backgrounds for your website. Ready to use components available also for Web Components, React, Vue.js (2.x and 3.x), Angular, Svelte, Preact, Riot.js, Solid.js, Inferno.",
   "homepage": "https://particles.js.org",
   "repository": {

diff --git a/wrappers/nextjs/package.dist.json b/wrappers/nextjs/package.dist.json
@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/nextjs",
-  "version": "4.0.5",
+  "version": "4.1.3",
   "type": "module",
   "repository": {
     "type": "git",

diff --git a/wrappers/nuxt2/package.dist.json b/wrappers/nuxt2/package.dist.json
@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/nuxt2",
-  "version": "4.0.5",
+  "version": "4.1.3",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/tsparticles/tsparticles.git",

diff --git a/wrappers/nuxt3/package.dist.json b/wrappers/nuxt3/package.dist.json
@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/nuxt3",
-  "version": "4.0.5",
+  "version": "4.1.3",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/tsparticles/tsparticles.git",

diff --git a/wrappers/nuxt4/package.dist.json b/wrappers/nuxt4/package.dist.json
@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/nuxt4",
-  "version": "4.0.5",
+  "version": "4.1.3",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/tsparticles/tsparticles.git",

diff --git a/wrappers/react/package.dist.json b/wrappers/react/package.dist.json
@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/react",
-  "version": "4.0.5",
+  "version": "4.1.3",
   "type": "module",
   "repository": {
     "type": "git",

diff --git a/wrappers/riot/package.dist.json b/wrappers/riot/package.dist.json
@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/riot",
-  "version": "4.0.5",
+  "version": "4.1.3",
   "description": "Official tsParticles Riot Component - Easily create highly customizable particle, confetti and fireworks animations and use them as animated backgrounds for your website. Ready to use components available also for Web Components, React, Vue.js (2.x and 3.x), Angular, Svelte, jQuery, Preact, Inferno.",
   "repository": {
     "type": "git",

diff --git a/wrappers/solid/package.dist.json b/wrappers/solid/package.dist.json
@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/solid",
-  "version": "4.0.5",
+  "version": "4.1.3",
   "description": "Official tsParticles Solid Component - Easily create highly customizable particle, confetti and fireworks 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, Inferno, Riot.js.",
   "license": "MIT",
   "author": "Matteo Bruni <matteo.bruni@me.com>",

diff --git a/wrappers/stencil/package.dist.json b/wrappers/stencil/package.dist.json
@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/stencil",
-  "version": "4.0.5",
+  "version": "4.1.3",
   "description": "Official tsParticles Stencil Component - Easily create highly customizable particle, confetti and fireworks animations and use them as animated backgrounds for your website.",
   "homepage": "https://particles.js.org",
   "repository": {

diff --git a/wrappers/svelte/CHANGELOG.md b/wrappers/svelte/CHANGELOG.md
@@ -7,10 +7,6 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline
 
 **Note:** Version bump only for package @tsparticles/svelte
 
-
-
-
-
 ## [4.1.2](https://github.com/tsparticles/tsparticles/compare/v4.1.1...v4.1.2) (2026-06-01)
 
 **Note:** Version bump only for package @tsparticles/svelte
Original file line number	Diff line number	Diff line change
Expand Up		@@ -7,10 +7,6 @@ See [Conventional Commits](https://conventionalcommits.org) for commit guideline

		Note: Version bump only for package @tsparticles/svelte





		## [4.1.2](https://github.com/tsparticles/tsparticles/compare/v4.1.1...v4.1.2) (2026-06-01)

		Note: Version bump only for package @tsparticles/svelte
Expand Down