pixi-particles-engine 0.1.9 → 0.1.10

package/dist/esm/behaviours/spawn-behaviours/circle-spawn-behaviour.js.map

@@ -1 +1 @@
-{"version":3,"file":"circle-spawn-behaviour.js","sourceRoot":"","sources":["../../../../src/behaviours/spawn-behaviours/circle-spawn-behaviour.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IAG7B,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;QAF3B,aAAQ,GAAG,CAAC,GAAG,CAAC;IAEc,CAAC;IAExC,OAAO,CAAC,CAAa;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QAE1C,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QAEjD,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;CACJ"}
+{"version":3,"file":"circle-spawn-behaviour.js","sourceRoot":"","sources":["../../../../src/behaviours/spawn-behaviours/circle-spawn-behaviour.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,oBAAoB;IAG7B,YACW,MAAc,EACd,cAAsB,CAAC;QADvB,WAAM,GAAN,MAAM,CAAQ;QACd,gBAAW,GAAX,WAAW,CAAY;QAJlB,aAAQ,GAAG,CAAC,GAAG,CAAC;IAK7B,CAAC;IAEG,OAAO,CAAC,CAAa;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QAE1C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAEpD,wCAAwC;QACxC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;QAEnE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;CACJ"}

package/dist/esm/behaviours/spawn-behaviours/rectangle-spawn-behaviour.d.ts

@@ -1,13 +1,23 @@
 import { PxParticle } from "../../px-particle";
 import { Behaviour } from "../../behaviour";
 /**
- * Spawns particles uniformly inside a rectangle centered at (0, 0).
- * */
+ * Spawns particles inside a rectangular border/ring centered at (0, 0).
+ *
+ * Outer size:
+ *   width x height
+ *
+ * Inner empty area:
+ *   innerWidth x innerHeight
+ *
+ * Particles spawn only in the area between the outer and inner rectangles.
+ */
 export declare class RectangleSpawnBehaviour implements Behaviour {
-    private readonly width;
-    private readonly height;
+    width: number;
+    height: number;
+    innerWidth: number;
+    innerHeight: number;
     readonly priority = -100;
-    constructor(width: number, height: number);
+    constructor(width: number, height: number, innerWidth?: number, innerHeight?: number);
     onSpawn(p: PxParticle): void;
     /** Inclusive-exclusive uniform random. */
     private rand;

package/dist/esm/behaviours/spawn-behaviours/rectangle-spawn-behaviour.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rectangle-spawn-behaviour.d.ts","sourceRoot":"","sources":["../../../../src/behaviours/spawn-behaviours/rectangle-spawn-behaviour.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;KAEK;AACL,qBAAa,uBAAwB,YAAW,SAAS;IAIjD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJ3B,SAAgB,QAAQ,QAAQ;gBAGX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM;IAG5B,OAAO,CAAC,CAAC,EAAE,UAAU;IAQ5B,0CAA0C;IAC1C,OAAO,CAAC,IAAI;CAGf"}
+{"version":3,"file":"rectangle-spawn-behaviour.d.ts","sourceRoot":"","sources":["../../../../src/behaviours/spawn-behaviours/rectangle-spawn-behaviour.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,qBAAa,uBAAwB,YAAW,SAAS;IAI1C,KAAK,EAAE,MAAM;IACb,MAAM,EAAE,MAAM;IAGd,UAAU,EAAE,MAAM;IAClB,WAAW,EAAE,MAAM;IAR9B,SAAgB,QAAQ,QAAQ;gBAGrB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAGd,UAAU,GAAE,MAAU,EACtB,WAAW,GAAE,MAAU;IAG3B,OAAO,CAAC,CAAC,EAAE,UAAU;IA6B5B,0CAA0C;IAC1C,OAAO,CAAC,IAAI;CAGf"}

package/dist/esm/behaviours/spawn-behaviours/rectangle-spawn-behaviour.js

@@ -1,17 +1,46 @@
 /**
- * Spawns particles uniformly inside a rectangle centered at (0, 0).
- * */
+ * Spawns particles inside a rectangular border/ring centered at (0, 0).
+ *
+ * Outer size:
+ *   width x height
+ *
+ * Inner empty area:
+ *   innerWidth x innerHeight
+ *
+ * Particles spawn only in the area between the outer and inner rectangles.
+ */
 export class RectangleSpawnBehaviour {
-    constructor(width, height) {
+    constructor(width, height, 
+    // Optional inner empty rectangle
+    innerWidth = 0, innerHeight = 0) {
         this.width = width;
         this.height = height;
+        this.innerWidth = innerWidth;
+        this.innerHeight = innerHeight;
         this.priority = -100;
     }
     onSpawn(p) {
-        const hw = this.width * 0.5;
-        const hh = this.height * 0.5;
-        p.x = this.rand(-hw, hw);
-        p.y = this.rand(-hh, hh);
+        const outerHW = this.width * 0.5;
+        const outerHH = this.height * 0.5;
+        const innerHW = this.innerWidth * 0.5;
+        const innerHH = this.innerHeight * 0.5;
+        // No inner hole -> normal rectangle spawn
+        if (this.innerWidth <= 0 || this.innerHeight <= 0) {
+            p.x = this.rand(-outerHW, outerHW);
+            p.y = this.rand(-outerHH, outerHH);
+            return;
+        }
+        // Pick a random point until it lands outside the inner rectangle
+        while (true) {
+            const x = this.rand(-outerHW, outerHW);
+            const y = this.rand(-outerHH, outerHH);
+            const insideInner = x > -innerHW && x < innerHW && y > -innerHH && y < innerHH;
+            if (!insideInner) {
+                p.x = x;
+                p.y = y;
+                return;
+            }
+        }
     }
     /** Inclusive-exclusive uniform random. */
     rand(min, max) {

package/dist/esm/behaviours/spawn-behaviours/rectangle-spawn-behaviour.js.map

@@ -1 +1 @@
-{"version":3,"file":"rectangle-spawn-behaviour.js","sourceRoot":"","sources":["../../../../src/behaviours/spawn-behaviours/rectangle-spawn-behaviour.ts"],"names":[],"mappings":"AAGA;;KAEK;AACL,MAAM,OAAO,uBAAuB;IAGhC,YACqB,KAAa,EACb,MAAc;QADd,UAAK,GAAL,KAAK,CAAQ;QACb,WAAM,GAAN,MAAM,CAAQ;QAJnB,aAAQ,GAAG,CAAC,GAAG,CAAC;IAK7B,CAAC;IAEG,OAAO,CAAC,CAAa;QACxB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;QAC5B,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;QAE7B,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,0CAA0C;IAClC,IAAI,CAAC,GAAW,EAAE,GAAW;QACjC,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;IAC7C,CAAC;CACJ"}
+{"version":3,"file":"rectangle-spawn-behaviour.js","sourceRoot":"","sources":["../../../../src/behaviours/spawn-behaviours/rectangle-spawn-behaviour.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,OAAO,uBAAuB;IAGhC,YACW,KAAa,EACb,MAAc;IAErB,iCAAiC;IAC1B,aAAqB,CAAC,EACtB,cAAsB,CAAC;QALvB,UAAK,GAAL,KAAK,CAAQ;QACb,WAAM,GAAN,MAAM,CAAQ;QAGd,eAAU,GAAV,UAAU,CAAY;QACtB,gBAAW,GAAX,WAAW,CAAY;QARlB,aAAQ,GAAG,CAAC,GAAG,CAAC;IAS7B,CAAC;IAEG,OAAO,CAAC,CAAa;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;QAElC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;QAEvC,0CAA0C;QAC1C,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC;YAChD,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACnC,OAAO;QACX,CAAC;QAED,iEAAiE;QACjE,OAAO,IAAI,EAAE,CAAC;YACV,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAEvC,MAAM,WAAW,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,OAAO,CAAC;YAE/E,IAAI,CAAC,WAAW,EAAE,CAAC;gBACf,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBACR,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBACR,OAAO;YACX,CAAC;QACL,CAAC;IACL,CAAC;IAED,0CAA0C;IAClC,IAAI,CAAC,GAAW,EAAE,GAAW;QACjC,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;IAC7C,CAAC;CACJ"}

package/dist/esm/behaviours/static-behaviours/static-rotation-behaviour.d.ts

@@ -4,13 +4,38 @@ import { PxParticle } from "../../px-particle";
  * Sets a particle's angular velocity at spawn time.
  *
  * Does NOT modify rotation per frame directly.
- * Instead, it initializes `angleV`, which the emitter integrates each tick.
+ * Instead, it initializes `angleVBase`, which the emitter integrates each tick.
  *
+ * Supports:
+ *
+ * - Fixed value:
+ *    2
+ *
+ * - Random range:
+ *    { min: -3, max: 3 }
+ *
+ * - Random range with minimum absolute magnitude:
+ *    { min: -3, max: 3, minAbs: 2 }
+ *
+ *    Result:
+ *      [-3 .. -2] U [2 .. 3]
  */
 export declare class StaticRotationBehaviour implements Behaviour {
     speed: number | {
         min: number;
         max: number;
+        /**
+         * Optional minimum absolute value.
+         *
+         * Example:
+         *   min=-3
+         *   max=3
+         *   minAbs=2
+         *
+         * Produces:
+         *   [-3..-2] U [2..3]
+         */
+        minAbs?: number;
     };
     readonly priority = -60;
     readonly requires: {
@@ -18,13 +43,26 @@ export declare class StaticRotationBehaviour implements Behaviour {
     };
     /**
      * @param speed
-     *  - number → fixed angular velocity (radians/sec)
-     *  - {min,max} → randomized angular velocity per particle
+     *  - number → fixed angular velocity
+     *  - object → randomized angular velocity
      */
     constructor(speed: number | {
         min: number;
         max: number;
+        /**
+         * Optional minimum absolute value.
+         *
+         * Example:
+         *   min=-3
+         *   max=3
+         *   minAbs=2
+         *
+         * Produces:
+         *   [-3..-2] U [2..3]
+         */
+        minAbs?: number;
     });
     onSpawn(p: PxParticle): void;
+    private randomRange;
 }
 //# sourceMappingURL=static-rotation-behaviour.d.ts.map

package/dist/esm/behaviours/static-behaviours/static-rotation-behaviour.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static-rotation-behaviour.d.ts","sourceRoot":"","sources":["../../../../src/behaviours/static-behaviours/static-rotation-behaviour.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,SAAS;IAUlC,KAAK,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAT/D,SAAgB,QAAQ,OAAO;IAE/B,SAAgB,QAAQ;;MAAsB;IAE9C;;;;OAIG;gBACgB,KAAK,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAExD,OAAO,CAAC,CAAC,EAAE,UAAU;CAK/B"}
+{"version":3,"file":"static-rotation-behaviour.d.ts","sourceRoot":"","sources":["../../../../src/behaviours/static-behaviours/static-rotation-behaviour.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,uBAAwB,YAAW,SAAS;IAW1C,KAAK,EACN,MAAM,GACN;QACI,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QAEZ;;;;;;;;;;WAUG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB;IA5BX,SAAgB,QAAQ,OAAO;IAE/B,SAAgB,QAAQ;;MAAsB;IAE9C;;;;OAIG;gBAEQ,KAAK,EACN,MAAM,GACN;QACI,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QAEZ;;;;;;;;;;WAUG;QACH,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB;IAGJ,OAAO,CAAC,CAAC,EAAE,UAAU;IAM5B,OAAO,CAAC,WAAW;CAqCtB"}

package/dist/esm/behaviours/static-behaviours/static-rotation-behaviour.js

@@ -2,14 +2,27 @@
  * Sets a particle's angular velocity at spawn time.
  *
  * Does NOT modify rotation per frame directly.
- * Instead, it initializes `angleV`, which the emitter integrates each tick.
+ * Instead, it initializes `angleVBase`, which the emitter integrates each tick.
  *
+ * Supports:
+ *
+ * - Fixed value:
+ *    2
+ *
+ * - Random range:
+ *    { min: -3, max: 3 }
+ *
+ * - Random range with minimum absolute magnitude:
+ *    { min: -3, max: 3, minAbs: 2 }
+ *
+ *    Result:
+ *      [-3 .. -2] U [2 .. 3]
  */
 export class StaticRotationBehaviour {
     /**
      * @param speed
-     *  - number → fixed angular velocity (radians/sec)
-     *  - {min,max} → randomized angular velocity per particle
+     *  - number → fixed angular velocity
+     *  - object → randomized angular velocity
      */
     constructor(speed) {
         this.speed = speed;
@@ -17,8 +30,36 @@ export class StaticRotationBehaviour {
         this.requires = { rotation: true };
     }
     onSpawn(p) {
-        const s = typeof this.speed === "number" ? this.speed : this.speed.min + Math.random() * (this.speed.max - this.speed.min);
-        p.angleV = s;
+        const s = typeof this.speed === "number" ? this.speed : this.randomRange(this.speed.min, this.speed.max, this.speed.minAbs);
+        p.angleVBase = s;
+    }
+    randomRange(min, max, minAbs) {
+        // Normal range
+        if (minAbs == null || minAbs <= 0) {
+            return min + Math.random() * (max - min);
+        }
+        // If the excluded center does not intersect range,
+        // fallback to normal random
+        if (min >= minAbs || max <= -minAbs) {
+            return min + Math.random() * (max - min);
+        }
+        const leftMin = min;
+        const leftMax = Math.min(-minAbs, max);
+        const rightMin = Math.max(minAbs, min);
+        const rightMax = max;
+        const leftSize = Math.max(0, leftMax - leftMin);
+        const rightSize = Math.max(0, rightMax - rightMin);
+        const total = leftSize + rightSize;
+        if (total <= 0) {
+            return 0;
+        }
+        const pick = Math.random() * total;
+        // Left segment
+        if (pick < leftSize) {
+            return leftMin + Math.random() * leftSize;
+        }
+        // Right segment
+        return rightMin + Math.random() * rightSize;
     }
 }
 //# sourceMappingURL=static-rotation-behaviour.js.map

package/dist/esm/behaviours/static-behaviours/static-rotation-behaviour.js.map

@@ -1 +1 @@
-{"version":3,"file":"static-rotation-behaviour.js","sourceRoot":"","sources":["../../../../src/behaviours/static-behaviours/static-rotation-behaviour.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,OAAO,uBAAuB;IAKhC;;;;OAIG;IACH,YAAmB,KAA4C;QAA5C,UAAK,GAAL,KAAK,CAAuC;QAT/C,aAAQ,GAAG,CAAC,EAAE,CAAC;QAEf,aAAQ,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAOoB,CAAC;IAE5D,OAAO,CAAC,CAAa;QACxB,MAAM,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE3H,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACjB,CAAC;CACJ"}
+{"version":3,"file":"static-rotation-behaviour.js","sourceRoot":"","sources":["../../../../src/behaviours/static-behaviours/static-rotation-behaviour.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,uBAAuB;IAKhC;;;;OAIG;IACH,YACW,KAkBA;QAlBA,UAAK,GAAL,KAAK,CAkBL;QA5BK,aAAQ,GAAG,CAAC,EAAE,CAAC;QAEf,aAAQ,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IA2B3C,CAAC;IAEG,OAAO,CAAC,CAAa;QACxB,MAAM,CAAC,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE5H,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;IACrB,CAAC;IAEO,WAAW,CAAC,GAAW,EAAE,GAAW,EAAE,MAAe;QACzD,eAAe;QACf,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;YAChC,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;QAC7C,CAAC;QAED,mDAAmD;QACnD,4BAA4B;QAC5B,IAAI,GAAG,IAAI,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,OAAO,GAAG,GAAG,CAAC;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAEvC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,GAAG,CAAC;QAErB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;QAEnD,MAAM,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;QAEnC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACb,OAAO,CAAC,CAAC;QACb,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC;QAEnC,eAAe;QACf,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;YAClB,OAAO,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC;QAC9C,CAAC;QAED,gBAAgB;QAChB,OAAO,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC;IAChD,CAAC;CACJ"}

package/dist/esm/index.d.ts

@@ -13,6 +13,7 @@ export * from "./behaviours/spawn-behaviours/circle-spawn-behaviour";
 export * from "./behaviours/spawn-behaviours/rectangle-spawn-behaviour";
 export * from "./behaviours/static-behaviours/static-rotation-behaviour";
 export * from "./behaviours/static-behaviours/static-scale-behaviour";
+export * from "./behaviours/rotation-curve-behaviour";
 export * from "./texture-providers/animated-texture-provider";
 export * from "./texture-providers/single-texture-provider";
 export * from "./texture-providers/weighted-texture-provider";

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,oDAAoD,CAAC;AACnE,cAAc,2DAA2D,CAAC;AAC1E,cAAc,yDAAyD,CAAC;AACxE,cAAc,sDAAsD,CAAC;AACrE,cAAc,yDAAyD,CAAC;AACxE,cAAc,0DAA0D,CAAC;AACzE,cAAc,uDAAuD,CAAC;AACtE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+CAA+C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,oDAAoD,CAAC;AACnE,cAAc,2DAA2D,CAAC;AAC1E,cAAc,yDAAyD,CAAC;AACxE,cAAc,sDAAsD,CAAC;AACrE,cAAc,yDAAyD,CAAC;AACxE,cAAc,0DAA0D,CAAC;AACzE,cAAc,uDAAuD,CAAC;AACtE,cAAc,uCAAuC,CAAC;AACtD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+CAA+C,CAAC"}

package/dist/esm/index.js

@@ -13,6 +13,7 @@ export * from "./behaviours/spawn-behaviours/circle-spawn-behaviour.js";
 export * from "./behaviours/spawn-behaviours/rectangle-spawn-behaviour.js";
 export * from "./behaviours/static-behaviours/static-rotation-behaviour.js";
 export * from "./behaviours/static-behaviours/static-scale-behaviour.js";
+export * from "./behaviours/rotation-curve-behaviour.js";
 export * from "./texture-providers/animated-texture-provider.js";
 export * from "./texture-providers/single-texture-provider.js";
 export * from "./texture-providers/weighted-texture-provider.js";

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,oDAAoD,CAAC;AACnE,cAAc,2DAA2D,CAAC;AAC1E,cAAc,yDAAyD,CAAC;AACxE,cAAc,sDAAsD,CAAC;AACrE,cAAc,yDAAyD,CAAC;AACxE,cAAc,0DAA0D,CAAC;AACzE,cAAc,uDAAuD,CAAC;AACtE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+CAA+C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,oDAAoD,CAAC;AACnE,cAAc,2DAA2D,CAAC;AAC1E,cAAc,yDAAyD,CAAC;AACxE,cAAc,sDAAsD,CAAC;AACrE,cAAc,yDAAyD,CAAC;AACxE,cAAc,0DAA0D,CAAC;AACzE,cAAc,uDAAuD,CAAC;AACtE,cAAc,uCAAuC,CAAC;AACtD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,+CAA+C,CAAC"}

package/dist/esm/px-particle.d.ts

@@ -29,14 +29,19 @@ export declare class PxParticle extends Particle {
     vx: number;
     /** Velocity in pixels per second (Y axis). */
     vy: number;
-    /** Angular velocity in radians per second. */
-    angleV: number;
+    /** Base angular velocity in radians per second. */
+    private _angleVBase;
+    /** Base angular velocity scale for angleVBase */
+    private _angleVScale;
     /**
      * Optional provider-specific animation state.
      * Used by AnimatedTextureProvider (if present).
      */
     animatedParticleState?: AnimatedParticleState;
     constructor(options: ParticleOptions);
+    set angleVBase(base: number);
+    set angleVScale(scale: number);
+    get angleV(): number;
     /**
      * Resets the particle into pooled (inactive) state.
      *

package/dist/esm/px-particle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"px-particle.d.ts","sourceRoot":"","sources":["../../src/px-particle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,qBAAa,UAAW,SAAQ,QAAQ;IACpC,2BAA2B;IACpB,GAAG,SAAK;IAEf,uEAAuE;IAChE,IAAI,SAAK;IAEhB,8CAA8C;IACvC,EAAE,SAAK;IAEd,8CAA8C;IACvC,EAAE,SAAK;IAEd,8CAA8C;IACvC,MAAM,SAAK;IAElB;;;OAGG;IACI,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;gBAEzC,OAAO,EAAE,eAAe;IAWpC;;;;;;;;OAQG;IACI,MAAM,IAAI,IAAI;IAWrB;;;;;;;;OAQG;IACI,OAAO,IAAI,IAAI;CAqBzB"}
+{"version":3,"file":"px-particle.d.ts","sourceRoot":"","sources":["../../src/px-particle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,qBAAa,UAAW,SAAQ,QAAQ;IACpC,2BAA2B;IACpB,GAAG,SAAK;IAEf,uEAAuE;IAChE,IAAI,SAAK;IAEhB,8CAA8C;IACvC,EAAE,SAAK;IAEd,8CAA8C;IACvC,EAAE,SAAK;IAEd,mDAAmD;IACnD,OAAO,CAAC,WAAW,CAAK;IAExB,iDAAiD;IACjD,OAAO,CAAC,YAAY,CAAK;IAEzB;;;OAGG;IACI,qBAAqB,CAAC,EAAE,qBAAqB,CAAC;gBAEzC,OAAO,EAAE,eAAe;IAWpC,IAAW,UAAU,CAAC,IAAI,EAAE,MAAM,EAEjC;IAED,IAAW,WAAW,CAAC,KAAK,EAAE,MAAM,EAEnC;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED;;;;;;;;OAQG;IACI,MAAM,IAAI,IAAI;IAYrB;;;;;;;;OAQG;IACI,OAAO,IAAI,IAAI;CAsBzB"}

package/dist/esm/px-particle.js

@@ -25,11 +25,22 @@ export class PxParticle extends Particle {
         this.vx = 0;
         /** Velocity in pixels per second (Y axis). */
         this.vy = 0;
-        /** Angular velocity in radians per second. */
-        this.angleV = 0;
+        /** Base angular velocity in radians per second. */
+        this._angleVBase = 0;
+        /** Base angular velocity scale for angleVBase */
+        this._angleVScale = 1;
         // Start in pooled/inactive state.
         this.onKill();
     }
+    set angleVBase(base) {
+        this._angleVBase = base;
+    }
+    set angleVScale(scale) {
+        this._angleVScale = scale;
+    }
+    get angleV() {
+        return this._angleVBase * this._angleVScale;
+    }
     /**
      * Resets the particle into pooled (inactive) state.
      *
@@ -44,7 +55,8 @@ export class PxParticle extends Particle {
         this.life = 1;
         this.vx = 0;
         this.vy = 0;
-        this.angleV = 0;
+        this._angleVBase = 0;
+        this._angleVScale = 1;
         this.animatedParticleState = undefined;
     }
     /**
@@ -61,7 +73,8 @@ export class PxParticle extends Particle {
         this.life = 1;
         this.vx = 0;
         this.vy = 0;
-        this.angleV = 0;
+        this._angleVBase = 0;
+        this._angleVScale = 1;
         this.animatedParticleState = undefined;
         // Reset visual state
         this.alpha = 1;

package/dist/esm/px-particle.js.map

@@ -1 +1 @@
-{"version":3,"file":"px-particle.js","sourceRoot":"","sources":["../../src/px-particle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,SAAS,CAAC;AAYpD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,UAAW,SAAQ,QAAQ;IAsBpC,YAAY,OAAwB;QAChC,2BAA2B;QAC3B,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC;QACtB,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QA1BnB,2BAA2B;QACpB,QAAG,GAAG,CAAC,CAAC;QAEf,uEAAuE;QAChE,SAAI,GAAG,CAAC,CAAC;QAEhB,8CAA8C;QACvC,OAAE,GAAG,CAAC,CAAC;QAEd,8CAA8C;QACvC,OAAE,GAAG,CAAC,CAAC;QAEd,8CAA8C;QACvC,WAAM,GAAG,CAAC,CAAC;QAed,kCAAkC;QAClC,IAAI,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM;QACT,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAEd,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAEhB,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAC3C,CAAC;IAED;;;;;;;;OAQG;IACI,OAAO;QACV,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAEd,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAEhB,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC;QAEvC,qBAAqB;QACrB,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;QAErB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAEhB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;CACJ"}
+{"version":3,"file":"px-particle.js","sourceRoot":"","sources":["../../src/px-particle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,SAAS,CAAC;AAYpD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,UAAW,SAAQ,QAAQ;IAyBpC,YAAY,OAAwB;QAChC,2BAA2B;QAC3B,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC;QACtB,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC;QAEtB,KAAK,CAAC,OAAO,CAAC,CAAC;QA7BnB,2BAA2B;QACpB,QAAG,GAAG,CAAC,CAAC;QAEf,uEAAuE;QAChE,SAAI,GAAG,CAAC,CAAC;QAEhB,8CAA8C;QACvC,OAAE,GAAG,CAAC,CAAC;QAEd,8CAA8C;QACvC,OAAE,GAAG,CAAC,CAAC;QAEd,mDAAmD;QAC3C,gBAAW,GAAG,CAAC,CAAC;QAExB,iDAAiD;QACzC,iBAAY,GAAG,CAAC,CAAC;QAerB,kCAAkC;QAClC,IAAI,CAAC,MAAM,EAAE,CAAC;IAClB,CAAC;IAED,IAAW,UAAU,CAAC,IAAY;QAC9B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,IAAW,WAAW,CAAC,KAAa;QAChC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC9B,CAAC;IAED,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC;IAChD,CAAC;IAED;;;;;;;;OAQG;IACI,MAAM;QACT,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAEd,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QAEtB,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAC3C,CAAC;IAED;;;;;;;;OAQG;IACI,OAAO;QACV,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAEd,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QAEtB,IAAI,CAAC,qBAAqB,GAAG,SAAS,CAAC;QAEvC,qBAAqB;QACrB,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;QAErB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAEhB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;CACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pixi-particles-engine",
-    "version": "0.1.9",
+    "version": "0.1.10",
     "description": "High-performance PixiJS v8 particle engine with behaviours and pooling",
     "license": "MIT",
     "repository": {

package/src/behaviours/rotation-curve-behaviour.ts

@@ -0,0 +1,32 @@
+import { Behaviour } from "../behaviour";
+import { PxParticle } from "../px-particle";
+import { CurveKeyframe, CurveOptions } from "./curved-behaviour/curve-key-frame";
+import { Curve } from "./curved-behaviour/curve-sampler";
+import { Emitter } from "../emitter";
+
+/**
+ * Rotation over lifetime driven by a curve.
+ *
+ * Keyframes are sampled using normalized lifetime t in [0..1].
+ * Output is clamped to [0..1].
+ */
+export class RotationCurveBehaviour implements Behaviour {
+    public readonly requires = { color: true };
+
+    public readonly priority = 50;
+
+    private curve: Curve;
+
+    constructor(keyframes: CurveKeyframe[], opts?: CurveOptions) {
+        this.curve = new Curve(keyframes);
+    }
+
+    public onSpawn(p: PxParticle) {
+        p.angleVScale = this.curve.sample(0);
+    }
+
+    public update(p: PxParticle, _dt?: number, _emitter?: Emitter) {
+        const t = p.life > 0 ? p.age / p.life : 1;
+        p.angleVScale = this.curve.sample(t);
+    }
+}

package/src/behaviours/spawn-behaviours/circle-spawn-behaviour.ts

@@ -2,21 +2,34 @@ import { PxParticle } from "../../px-particle";
 import { Behaviour } from "../../behaviour";
 
 /**
- * Spawns particles uniformly within a circle centered at (0, 0).
+ * Spawns particles inside a circular ring centered at (0, 0).
  *
- * Uses sqrt(random) to achieve uniform distribution by area
- * (without sqrt you'd get clustering toward the center).
+ * Outer radius:
+ *   radius
  *
+ * Inner empty radius:
+ *   innerRadius
+ *
+ * Particles spawn only between the outer and inner circles.
+ *
+ * Uses sqrt(random) to maintain uniform area distribution.
  */
 export class CircleSpawnBehaviour implements Behaviour {
     public readonly priority = -100;
 
-    constructor(private readonly radius: number) {}
+    constructor(
+        public radius: number,
+        public innerRadius: number = 0,
+    ) {}
 
     public onSpawn(p: PxParticle) {
         const angle = Math.random() * Math.PI * 2;
 
-        const r = Math.sqrt(Math.random()) * this.radius;
+        const outerR2 = this.radius * this.radius;
+        const innerR2 = this.innerRadius * this.innerRadius;
+
+        // Uniform distribution across ring area
+        const r = Math.sqrt(innerR2 + Math.random() * (outerR2 - innerR2));
 
         p.x = Math.cos(angle) * r;
         p.y = Math.sin(angle) * r;

package/src/behaviours/spawn-behaviours/rectangle-spawn-behaviour.ts

@@ -2,22 +2,55 @@ import { PxParticle } from "../../px-particle";
 import { Behaviour } from "../../behaviour";
 
 /**
- * Spawns particles uniformly inside a rectangle centered at (0, 0).
- * */
+ * Spawns particles inside a rectangular border/ring centered at (0, 0).
+ *
+ * Outer size:
+ *   width x height
+ *
+ * Inner empty area:
+ *   innerWidth x innerHeight
+ *
+ * Particles spawn only in the area between the outer and inner rectangles.
+ */
 export class RectangleSpawnBehaviour implements Behaviour {
     public readonly priority = -100;
 
     constructor(
-        private readonly width: number,
-        private readonly height: number,
+        public width: number,
+        public height: number,
+
+        // Optional inner empty rectangle
+        public innerWidth: number = 0,
+        public innerHeight: number = 0,
     ) {}
 
     public onSpawn(p: PxParticle) {
-        const hw = this.width * 0.5;
-        const hh = this.height * 0.5;
+        const outerHW = this.width * 0.5;
+        const outerHH = this.height * 0.5;
+
+        const innerHW = this.innerWidth * 0.5;
+        const innerHH = this.innerHeight * 0.5;
+
+        // No inner hole -> normal rectangle spawn
+        if (this.innerWidth <= 0 || this.innerHeight <= 0) {
+            p.x = this.rand(-outerHW, outerHW);
+            p.y = this.rand(-outerHH, outerHH);
+            return;
+        }
+
+        // Pick a random point until it lands outside the inner rectangle
+        while (true) {
+            const x = this.rand(-outerHW, outerHW);
+            const y = this.rand(-outerHH, outerHH);
+
+            const insideInner = x > -innerHW && x < innerHW && y > -innerHH && y < innerHH;
 
-        p.x = this.rand(-hw, hw);
-        p.y = this.rand(-hh, hh);
+            if (!insideInner) {
+                p.x = x;
+                p.y = y;
+                return;
+            }
+        }
     }
 
     /** Inclusive-exclusive uniform random. */

package/src/behaviours/static-behaviours/static-rotation-behaviour.ts

@@ -5,8 +5,21 @@ import { PxParticle } from "../../px-particle";
  * Sets a particle's angular velocity at spawn time.
  *
  * Does NOT modify rotation per frame directly.
- * Instead, it initializes `angleV`, which the emitter integrates each tick.
+ * Instead, it initializes `angleVBase`, which the emitter integrates each tick.
  *
+ * Supports:
+ *
+ * - Fixed value:
+ *    2
+ *
+ * - Random range:
+ *    { min: -3, max: 3 }
+ *
+ * - Random range with minimum absolute magnitude:
+ *    { min: -3, max: 3, minAbs: 2 }
+ *
+ *    Result:
+ *      [-3 .. -2] U [2 .. 3]
  */
 export class StaticRotationBehaviour implements Behaviour {
     public readonly priority = -60;
@@ -15,14 +28,72 @@ export class StaticRotationBehaviour implements Behaviour {
 
     /**
      * @param speed
-     *  - number → fixed angular velocity (radians/sec)
-     *  - {min,max} → randomized angular velocity per particle
+     *  - number → fixed angular velocity
+     *  - object → randomized angular velocity
      */
-    constructor(public speed: number | { min: number; max: number }) {}
+    constructor(
+        public speed:
+            | number
+            | {
+                  min: number;
+                  max: number;
+
+                  /**
+                   * Optional minimum absolute value.
+                   *
+                   * Example:
+                   *   min=-3
+                   *   max=3
+                   *   minAbs=2
+                   *
+                   * Produces:
+                   *   [-3..-2] U [2..3]
+                   */
+                  minAbs?: number;
+              },
+    ) {}
 
     public onSpawn(p: PxParticle) {
-        const s = typeof this.speed === "number" ? this.speed : this.speed.min + Math.random() * (this.speed.max - this.speed.min);
+        const s = typeof this.speed === "number" ? this.speed : this.randomRange(this.speed.min, this.speed.max, this.speed.minAbs);
+
+        p.angleVBase = s;
+    }
+
+    private randomRange(min: number, max: number, minAbs?: number): number {
+        // Normal range
+        if (minAbs == null || minAbs <= 0) {
+            return min + Math.random() * (max - min);
+        }
+
+        // If the excluded center does not intersect range,
+        // fallback to normal random
+        if (min >= minAbs || max <= -minAbs) {
+            return min + Math.random() * (max - min);
+        }
+
+        const leftMin = min;
+        const leftMax = Math.min(-minAbs, max);
+
+        const rightMin = Math.max(minAbs, min);
+        const rightMax = max;
+
+        const leftSize = Math.max(0, leftMax - leftMin);
+        const rightSize = Math.max(0, rightMax - rightMin);
+
+        const total = leftSize + rightSize;
+
+        if (total <= 0) {
+            return 0;
+        }
+
+        const pick = Math.random() * total;
+
+        // Left segment
+        if (pick < leftSize) {
+            return leftMin + Math.random() * leftSize;
+        }
 
-        p.angleV = s;
+        // Right segment
+        return rightMin + Math.random() * rightSize;
     }
 }

package/src/index.ts

@@ -13,6 +13,7 @@ export * from "./behaviours/spawn-behaviours/circle-spawn-behaviour";
 export * from "./behaviours/spawn-behaviours/rectangle-spawn-behaviour";
 export * from "./behaviours/static-behaviours/static-rotation-behaviour";
 export * from "./behaviours/static-behaviours/static-scale-behaviour";
+export * from "./behaviours/rotation-curve-behaviour";
 export * from "./texture-providers/animated-texture-provider";
 export * from "./texture-providers/single-texture-provider";
 export * from "./texture-providers/weighted-texture-provider";