pixi-particles-engine 0.1.8 → 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.8",
+    "version": "0.1.10",
     "description": "High-performance PixiJS v8 particle engine with behaviours and pooling",
     "license": "MIT",
     "repository": {
@@ -31,6 +31,7 @@
     },
     "files": [
         "dist",
+        "src",
         "README.md",
         "LICENSE"
     ],

package/src/behaviour.ts

@@ -0,0 +1,74 @@
+import { ParticleProperties } from "pixi.js";
+import { Emitter } from "./emitter";
+import { PxParticle } from "./px-particle";
+
+/**
+ * A Behaviour is a modular unit of particle logic.
+ *
+ * Behaviours can:
+ * - Initialize particle state at spawn (velocity, alpha, scale, etc)
+ * - Update particle state each frame (curves, gravity, drag, color fade, etc)
+ * - Clean up any per-particle state when the particle is recycled
+ *
+ * Lifecycle:
+ * - init(emitter) is called once when the behaviour is added to an emitter
+ * - onSpawn(p, emitter) is called each time a particle is spawned
+ * - update(p, dt, emitter) is called every frame for each active particle
+ * - onKill(p, emitter) is called when a particle dies and returns to the pool
+ */
+export interface Behaviour {
+    /**
+     * Execution order relative to other behaviours.
+     *
+     * Lower priority runs earlier.
+     * When priorities are equal, execution order is stable and follows registration order.
+     *
+     * Use priority to ensure correct ordering when behaviours depend on each other
+     * (e.g. apply movement first, then apply alpha/scale curves).
+     */
+    readonly priority?: number;
+
+    /**
+     * Dynamic property requirements for this behaviour.
+     *
+     * PixiJS ParticleContainer uses `dynamicProperties` to decide which attributes
+     * must be re-uploaded to the GPU each frame.
+     *
+     * If your behaviour changes a property over time that affects rendering,
+     * declare it here so the emitter enables the correct dynamicProperties.
+     *
+     * Examples:
+     * - Changing `alpha` over time → requires: { color: true }
+     * - Changing `scaleX/scaleY` over time → may require: { vertex: true } (depends on Pixi internals)
+     * - Changing `rotation` over time → requires: { rotation: true }
+     *
+     * NOTE:
+     * If your behaviour only sets values ON SPAWN and never changes them after,
+     * you usually do NOT need to require dynamic properties.
+     */
+    readonly requires?: ParticleProperties;
+
+    /**
+     * Optional: called once when the behaviour is registered on an emitter.
+     * Useful for caching references, precomputing curves, or validating options.
+     */
+    init?(emitter: Emitter): void;
+
+    /**
+     * Optional: called when a particle is spawned (taken from pool and activated).
+     * Use this to initialize per-particle state for this behaviour.
+     */
+    onSpawn?(p: PxParticle, emitter: Emitter): void;
+
+    /**
+     * Optional: called every frame for each active particle.
+     * `dt` is delta time in seconds (already clamped by the emitter).
+     */
+    update?(p: PxParticle, dt: number, emitter: Emitter): void;
+
+    /**
+     * Optional: called when the particle is killed and returned to the pool.
+     * Use this to clear any per-particle state allocated by the behaviour.
+     */
+    onKill?(p: PxParticle, emitter: Emitter): void;
+}

package/src/behaviours/alpha-behaviour.ts

@@ -0,0 +1,29 @@
+import { PxParticle } from "../px-particle";
+import { Behaviour } from "../behaviour";
+import { Emitter } from "../emitter";
+
+/**
+ * Linearly fades alpha from startAlpha -> endAlpha over particle lifetime.
+ */
+export class AlphaBehaviour implements Behaviour {
+    public readonly requires = { color: true };
+
+    public readonly priority = 50;
+
+    public startAlpha = 1;
+    public endAlpha = 0;
+
+    constructor(startAlpha = 1, endAlpha = 0) {
+        this.startAlpha = startAlpha;
+        this.endAlpha = endAlpha;
+    }
+
+    public onSpawn(p: PxParticle, _emitter: Emitter): void {
+        p.alpha = this.startAlpha;
+    }
+
+    public update(p: PxParticle, _dt: number, _emitter: Emitter): void {
+        const t = p.life > 0 ? Math.min(1, Math.max(0, p.age / p.life)) : 1;
+        p.alpha = this.startAlpha + (this.endAlpha - this.startAlpha) * t;
+    }
+}

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

@@ -0,0 +1,34 @@
+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";
+
+/**
+ * Alpha over lifetime driven by a curve.
+ *
+ * Keyframes are sampled using normalized lifetime t in [0..1].
+ * Output is clamped to [0..1].
+ */
+export class AlphaCurveBehaviour implements Behaviour {
+    /** Alpha changes over time, so ParticleContainer must treat color as dynamic. */
+    public readonly requires = { color: true };
+
+    public readonly priority = 50;
+
+    private curve: Curve;
+
+    constructor(keyframes: CurveKeyframe[], opts?: CurveOptions) {
+        // Always clamp alpha to [0..1]
+        this.curve = new Curve(keyframes, { ...opts, clamp: { min: 0, max: 1 } });
+    }
+
+    public onSpawn(p: PxParticle) {
+        p.alpha = this.curve.sample(0);
+    }
+
+    public update(p: PxParticle, _dt?: number, _emitter?: Emitter) {
+        const t = p.life > 0 ? p.age / p.life : 1;
+        p.alpha = this.curve.sample(t);
+    }
+}

package/src/behaviours/curved-behaviour/curve-key-frame.ts

@@ -0,0 +1,23 @@
+export type EaseFn = (x: number) => number;
+
+export type CurveKeyframe = {
+    /** Normalized lifetime [0..1]. */
+    time: number;
+
+    /** Value at this time. */
+    value: number;
+
+    /**
+     * Optional easing applied to the segment starting at this keyframe,
+     * i.e. easing used for interpolation from this keyframe -> next keyframe.
+     */
+    ease?: EaseFn;
+};
+
+export type CurveOptions = {
+    /** Default easing used when a segment has no per-keyframe ease. */
+    defaultEase?: EaseFn;
+
+    /** Optional clamp on sampled output. */
+    clamp?: { min: number; max: number };
+};

package/src/behaviours/curved-behaviour/curve-sampler.ts

@@ -0,0 +1,92 @@
+import { Utils } from "../../utils";
+import { CurveKeyframe, EaseFn, CurveOptions } from "./curve-key-frame";
+
+/**
+ * Lightweight curve sampler for keyframed 1D values over normalized time [0..1].
+ *
+ * - Keyframes are clamped to [0..1] and sorted by time.
+ * - Endpoints at t=0 and t=1 are ensured (added if missing).
+ * - Each segment can have its own easing function.
+ */
+export class Curve {
+    /** Cleaned + sorted keyframes (always includes endpoints at 0 and 1). */
+    private keys: CurveKeyframe[];
+
+    /** Default easing used when the keyframe has no `ease`. */
+    private defaultEase?: EaseFn;
+
+    /** Optional output clamp. */
+    private clamp?: { min: number; max: number };
+
+    constructor(keyframes: CurveKeyframe[], opts?: CurveOptions) {
+        this.defaultEase = opts?.defaultEase;
+        this.clamp = opts?.clamp;
+
+        // Normalize and sort keyframes.
+        const cleaned: CurveKeyframe[] = (keyframes ?? [])
+            .map((k) => ({
+                time: Utils.clamp01(k.time),
+                value: k.value,
+                ease: k.ease,
+            }))
+            .sort((a, b) => a.time - b.time);
+
+        // Fallback: flat zero curve.
+        if (cleaned.length === 0) cleaned.push({ time: 0, value: 0 }, { time: 1, value: 0 });
+
+        // Ensure endpoints exist at t=0 and t=1.
+        if (cleaned[0].time !== 0) cleaned.unshift({ time: 0, value: cleaned[0].value });
+
+        if (cleaned[cleaned.length - 1].time !== 1)
+            cleaned.push({
+                time: 1,
+                value: cleaned[cleaned.length - 1].value,
+            });
+
+        this.keys = cleaned;
+    }
+
+    /**
+     * Samples the curve at normalized time t01.
+     * Input is clamped to [0..1].
+     */
+    public sample(t01: number): number {
+        const t = Utils.clamp01(t01);
+
+        // Find which segment [k0..k1] contains t.
+        const i = this.findSegmentIndex(t);
+        const k0 = this.keys[i];
+        const k1 = this.keys[i + 1];
+
+        const span = k1.time - k0.time;
+        if (span <= 0) return this.clampValue(k1.value);
+
+        // Normalize t into segment space [0..1].
+        let u = (t - k0.time) / span;
+        u = Utils.clamp01(u);
+
+        // Apply easing for this segment (if any).
+        const ease = k0.ease ?? this.defaultEase;
+        if (ease) u = Utils.clamp01(ease(u));
+
+        // Linear interpolation between segment endpoints.
+        const v = Utils.lerp(k0.value, k1.value, u);
+        return this.clampValue(v);
+    }
+
+    /**
+     * Finds the segment index i such that t is between keys[i] and keys[i+1].
+     */
+    private findSegmentIndex(t: number): number {
+        for (let i = 0; i < this.keys.length - 2; i++) {
+            if (t <= this.keys[i + 1].time) return i;
+        }
+        return this.keys.length - 2;
+    }
+
+    /** Applies optional output clamp. */
+    private clampValue(v: number): number {
+        if (!this.clamp) return v;
+        return Math.min(this.clamp.max, Math.max(this.clamp.min, v));
+    }
+}