custom-pixi-particles 8.8.0 → 8.9.1

package/README.md

@@ -552,6 +552,43 @@ emitController: {
 
 Behaviours define how particles behave throughout their lifetime. Each behaviour has a `priority` (higher = processed first) and can be `enabled` or disabled.
 
+#### Custom behaviours (IBehaviour)
+
+You can add your own behaviours by implementing the **IBehaviour** interface (or extending the base **Behaviour** class) and registering them with **BehaviourRegistry**. Custom behaviours can then be used by name in your emitter config (e.g. from JSON or the editor).
+
+```javascript
+import { Behaviour, BehaviourRegistry, customPixiParticles } from 'custom-pixi-particles'
+
+// Extend Behaviour and implement required methods
+class MyCustomBehaviour extends Behaviour {
+  enabled = true
+  priority = 0
+  getName() { return 'MyCustomBehaviour' }
+  getProps() { return { enabled: this.enabled, priority: this.priority, name: this.getName() } }
+  init(particle, model, turbulencePool) { /* ... */ }
+  apply(particle, deltaTime, model) { /* ... */ }
+}
+
+// Register so config can create it by name
+BehaviourRegistry.register('MyCustomBehaviour', MyCustomBehaviour)
+
+// Your emitter config can now include: { behaviours: [{ name: 'MyCustomBehaviour', ... }] }
+```
+
+You can also add a custom behaviour instance at runtime: get the emitter from your renderer and call `emitter.behaviours.add(myCustomBehaviour)`.
+
+```javascript
+// After creating the particle emitter
+const particles = customPixiParticles.create({ textures, emitterConfig })
+app.stage.addChild(particles)
+particles.play()
+
+// Add a custom behaviour at runtime
+const myCustomBehaviour = new MyCustomBehaviour()
+particles.emitter.behaviours.add(myCustomBehaviour)
+// New and existing particles will use the new behaviour on the next update
+```
+
 #### Life Behaviour
 Controls particle lifetime.
 

package/dist/index.d.ts

@@ -14,4 +14,7 @@ declare const customPixiParticles: {
 declare const _customPixiParticlesEditorOnly: {
     create(settings: ICustomPixiParticlesSettings): TestRenderer;
 };
+export type { IBehaviour } from './lib/behaviour';
+export { Behaviour, BehaviourRegistry } from './lib/behaviour';
+export { Application, Assets } from 'pixi.js';
 export { Renderer, customPixiParticles, _customPixiParticlesEditorOnly, ICustomPixiParticlesSettings, ShatterEffect, DissolveEffect, MagneticAssemblyEffect, GhostEffect, GlitchEffect, MeltEffect, };

package/dist/index.js

@@ -42,5 +42,8 @@ const _customPixiParticlesEditorOnly = {
         });
     },
 };
+export { Behaviour, BehaviourRegistry } from './lib/behaviour';
+// Re-export so demos can use one import (avoids loading Pixi twice)
+export { Application, Assets } from 'pixi.js';
 export { Renderer, customPixiParticles, _customPixiParticlesEditorOnly, ShatterEffect, DissolveEffect, MagneticAssemblyEffect, GhostEffect, GlitchEffect, MeltEffect, };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,qBAAqB,CAAA;AAE1C,OAAO,YAAY,MAAM,yBAAyB,CAAA;AAClD,OAAO,EACL,cAAc,EACd,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,aAAa,GACd,MAAM,eAAe,CAAA;AAetB;;;;GAIG;AACH,MAAM,mBAAmB,GAAG;IAC1B,MAAM,CAAC,QAAsC;QAC3C,MAAM,EACJ,QAAQ,EACR,aAAa,EACb,qBAAqB,GAAG,CAAC,EACzB,0BAA0B,GAAG,CAAC,EAC9B,iBAAiB,GAAG,EAAE,EACtB,QAAQ,GAAG,IAAI,EACf,QAAQ,GAAG,IAAI,EACf,QAAQ,GAAG,IAAI,EACf,GAAG,GAAG,IAAI,EACV,IAAI,GAAG,IAAI,EACX,YAAY,GAAG,KAAK,EACpB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,EACX,WAAW,GAAG,IAAI,GACnB,GAAG,QAAQ,CAAA;QACZ,OAAO,IAAI,QAAQ,CAAC;YAClB,QAAQ;YACR,qBAAqB;YACrB,0BAA0B;YAC1B,aAAa;YACb,iBAAiB;YACjB,QAAQ;YACR,QAAQ;YACR,QAAQ;YACR,GAAG;YACH,IAAI;YACJ,YAAY;YACZ,MAAM;YACN,MAAM;YACN,WAAW;SACZ,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAED,MAAM,8BAA8B,GAAG;IACrC,MAAM,CAAC,QAAsC;QAC3C,MAAM,EACJ,QAAQ,EACR,aAAa,EACb,qBAAqB,GAAG,CAAC,EACzB,0BAA0B,GAAG,CAAC,EAC9B,iBAAiB,GAAG,EAAE,EACtB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,EACX,WAAW,GAAG,IAAI,GACnB,GAAG,QAAQ,CAAA;QACZ,OAAO,IAAI,YAAY,CAAC;YACtB,QAAQ;YACR,qBAAqB;YACrB,0BAA0B;YAC1B,aAAa;YACb,iBAAiB;YACjB,MAAM;YACN,MAAM;YACN,WAAW;SACZ,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAED,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,8BAA8B,EAE9B,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,WAAW,EACX,YAAY,EACZ,UAAU,GACX,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,qBAAqB,CAAA;AAE1C,OAAO,YAAY,MAAM,yBAAyB,CAAA;AAClD,OAAO,EACL,cAAc,EACd,WAAW,EACX,YAAY,EACZ,sBAAsB,EACtB,UAAU,EACV,aAAa,GACd,MAAM,eAAe,CAAA;AAetB;;;;GAIG;AACH,MAAM,mBAAmB,GAAG;IAC1B,MAAM,CAAC,QAAsC;QAC3C,MAAM,EACJ,QAAQ,EACR,aAAa,EACb,qBAAqB,GAAG,CAAC,EACzB,0BAA0B,GAAG,CAAC,EAC9B,iBAAiB,GAAG,EAAE,EACtB,QAAQ,GAAG,IAAI,EACf,QAAQ,GAAG,IAAI,EACf,QAAQ,GAAG,IAAI,EACf,GAAG,GAAG,IAAI,EACV,IAAI,GAAG,IAAI,EACX,YAAY,GAAG,KAAK,EACpB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,EACX,WAAW,GAAG,IAAI,GACnB,GAAG,QAAQ,CAAA;QACZ,OAAO,IAAI,QAAQ,CAAC;YAClB,QAAQ;YACR,qBAAqB;YACrB,0BAA0B;YAC1B,aAAa;YACb,iBAAiB;YACjB,QAAQ;YACR,QAAQ;YACR,QAAQ;YACR,GAAG;YACH,IAAI;YACJ,YAAY;YACZ,MAAM;YACN,MAAM;YACN,WAAW;SACZ,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAED,MAAM,8BAA8B,GAAG;IACrC,MAAM,CAAC,QAAsC;QAC3C,MAAM,EACJ,QAAQ,EACR,aAAa,EACb,qBAAqB,GAAG,CAAC,EACzB,0BAA0B,GAAG,CAAC,EAC9B,iBAAiB,GAAG,EAAE,EACtB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,EACX,WAAW,GAAG,IAAI,GACnB,GAAG,QAAQ,CAAA;QACZ,OAAO,IAAI,YAAY,CAAC;YACtB,QAAQ;YACR,qBAAqB;YACrB,0BAA0B;YAC1B,aAAa;YACb,iBAAiB;YACjB,MAAM;YACN,MAAM;YACN,WAAW;SACZ,CAAC,CAAA;IACJ,CAAC;CACF,CAAA;AAGD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAE9D,oEAAoE;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAE7C,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,8BAA8B,EAE9B,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,WAAW,EACX,YAAY,EACZ,UAAU,GACX,CAAA"}

package/dist/lib/behaviour/BehaviourRegistry.d.ts

@@ -0,0 +1,44 @@
+import type { IBehaviour } from './IBehaviour';
+type BehaviourConstructor = new () => IBehaviour;
+/**
+ * Registry for custom behaviour classes. Register a class here so it can be
+ * created by name when loading emitter config (e.g. from JSON or the editor).
+ *
+ * @example
+ * import { Behaviour, BehaviourRegistry } from 'custom-pixi-particles'
+ *
+ * class MyCustomBehaviour extends Behaviour {
+ *   enabled = true
+ *   priority = 0
+ *   getName() { return 'MyCustomBehaviour' }
+ *   getProps() { return { enabled: this.enabled, priority: this.priority, name: this.getName() } }
+ *   init(particle, model, turbulencePool) { ... }
+ *   apply(particle, deltaTime, model) { ... }
+ * }
+ *
+ * BehaviourRegistry.register('MyCustomBehaviour', MyCustomBehaviour)
+ *
+ * // Now config can use: { behaviours: [{ name: 'MyCustomBehaviour', ... }] }
+ */
+export declare const BehaviourRegistry: {
+    _behaviours: Map<string, BehaviourConstructor>;
+    /**
+     * Register a custom behaviour class by name. This name must match the string
+     * used in your emitter config (config.behaviours[].name).
+     */
+    register(name: string, BehaviourClass: BehaviourConstructor): void;
+    /**
+     * Unregister a custom behaviour by name.
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get a registered behaviour constructor by name, or undefined if not registered.
+     * Used internally by EmitterParser when creating behaviours from config.
+     */
+    get(name: string): BehaviourConstructor | undefined;
+    /**
+     * Check if a name is registered (custom or built-in is not checked here).
+     */
+    has(name: string): boolean;
+};
+export {};

package/dist/lib/behaviour/BehaviourRegistry.js

@@ -0,0 +1,50 @@
+/**
+ * Registry for custom behaviour classes. Register a class here so it can be
+ * created by name when loading emitter config (e.g. from JSON or the editor).
+ *
+ * @example
+ * import { Behaviour, BehaviourRegistry } from 'custom-pixi-particles'
+ *
+ * class MyCustomBehaviour extends Behaviour {
+ *   enabled = true
+ *   priority = 0
+ *   getName() { return 'MyCustomBehaviour' }
+ *   getProps() { return { enabled: this.enabled, priority: this.priority, name: this.getName() } }
+ *   init(particle, model, turbulencePool) { ... }
+ *   apply(particle, deltaTime, model) { ... }
+ * }
+ *
+ * BehaviourRegistry.register('MyCustomBehaviour', MyCustomBehaviour)
+ *
+ * // Now config can use: { behaviours: [{ name: 'MyCustomBehaviour', ... }] }
+ */
+export const BehaviourRegistry = {
+    _behaviours: new Map(),
+    /**
+     * Register a custom behaviour class by name. This name must match the string
+     * used in your emitter config (config.behaviours[].name).
+     */
+    register(name, BehaviourClass) {
+        this._behaviours.set(name, BehaviourClass);
+    },
+    /**
+     * Unregister a custom behaviour by name.
+     */
+    unregister(name) {
+        return this._behaviours.delete(name);
+    },
+    /**
+     * Get a registered behaviour constructor by name, or undefined if not registered.
+     * Used internally by EmitterParser when creating behaviours from config.
+     */
+    get(name) {
+        return this._behaviours.get(name);
+    },
+    /**
+     * Check if a name is registered (custom or built-in is not checked here).
+     */
+    has(name) {
+        return this._behaviours.has(name);
+    },
+};
+//# sourceMappingURL=BehaviourRegistry.js.map

package/dist/lib/behaviour/BehaviourRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BehaviourRegistry.js","sourceRoot":"","sources":["../../../src/lib/behaviour/BehaviourRegistry.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,IAAI,GAAG,EAAgC;IAEpD;;;OAGG;IACH,QAAQ,CAAC,IAAY,EAAE,cAAoC;QACzD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,CAAA;IAC5C,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACtC,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACnC,CAAC;CACF,CAAA"}

package/dist/lib/behaviour/EmitterBehaviours.d.ts

@@ -1,29 +1,31 @@
+import type { IBehaviour } from './IBehaviour';
 import Particle from '../Particle';
 import Model from '../Model';
 import TurbulencePool from '../util/turbulencePool';
 /**
- * EmitterBehaviours class manages the behaviour of particles
+ * EmitterBehaviours class manages the behaviour of particles.
+ * Accepts built-in behaviours and custom behaviours that implement IBehaviour.
  */
 export default class EmitterBehaviours {
-    behaviours: any;
+    behaviours: IBehaviour[];
     /**
      * Gets all the enabled behaviours
      *
      * @return {any[]} The enabled behaviours
      */
-    getAll: () => any;
+    getAll: () => IBehaviour[];
     /**
      * Clears all the stored behaviours
      */
     clear: () => void;
     /**
-     * Adds a behaviour
+     * Adds a behaviour (built-in or custom implementing IBehaviour).
      *
-     * @param {any} behaviour The behaviour to add
+     * @param {IBehaviour} behaviour The behaviour to add
      *
-     * @return {any} The added behaviour
+     * @return {IBehaviour} The added behaviour
      */
-    add: (behaviour: any) => any;
+    add: (behaviour: IBehaviour) => IBehaviour;
     /**
      * Checks if there are no behaviours stored
      *
@@ -37,7 +39,7 @@ export default class EmitterBehaviours {
      *
      * @return {any | null} The behaviour with the given name or null if not found
      */
-    getByName: (name: string) => any;
+    getByName: (name: string) => IBehaviour | null;
     /**
      * Removes a behaviour by name
      *

package/dist/lib/behaviour/EmitterBehaviours.js

@@ -1,7 +1,8 @@
 // src/lib/behaviour/EmitterBehaviours.ts
 // tslint:disable:prefer-for-of
 /**
- * EmitterBehaviours class manages the behaviour of particles
+ * EmitterBehaviours class manages the behaviour of particles.
+ * Accepts built-in behaviours and custom behaviours that implement IBehaviour.
  */
 export default class EmitterBehaviours {
     constructor() {
@@ -23,11 +24,11 @@ export default class EmitterBehaviours {
             this.behaviours = [];
         };
         /**
-         * Adds a behaviour
+         * Adds a behaviour (built-in or custom implementing IBehaviour).
          *
-         * @param {any} behaviour The behaviour to add
+         * @param {IBehaviour} behaviour The behaviour to add
          *
-         * @return {any} The added behaviour
+         * @return {IBehaviour} The added behaviour
          */
         this.add = (behaviour) => {
             if (this.getByName(behaviour.getName()) !== null) {
@@ -108,8 +109,9 @@ export default class EmitterBehaviours {
          */
         this.update = (deltaTime) => {
             for (let i = 0; i < this.behaviours.length; ++i) {
-                if (this.behaviours[i].update)
-                    this.behaviours[i].update(deltaTime);
+                const updateFn = this.behaviours[i].update;
+                if (updateFn)
+                    updateFn(deltaTime);
             }
         };
         /**
@@ -119,9 +121,9 @@ export default class EmitterBehaviours {
          */
         this.onParticleRemoved = (particle) => {
             for (let i = 0; i < this.behaviours.length; ++i) {
-                if (typeof this.behaviours[i].onParticleRemoved === 'function') {
-                    this.behaviours[i].onParticleRemoved(particle);
-                }
+                const onRemoved = this.behaviours[i].onParticleRemoved;
+                if (onRemoved)
+                    onRemoved(particle);
             }
         };
     }

package/dist/lib/behaviour/EmitterBehaviours.js.map

@@ -1 +1 @@
-{"version":3,"file":"EmitterBehaviours.js","sourceRoot":"","sources":["../../../src/lib/behaviour/EmitterBehaviours.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,+BAA+B;AAM/B;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAiB;IAAtC;QACE,eAAU,GAAQ,EAAE,CAAA;QAEpB;;;;WAIG;QACH,WAAM,GAAG,GAAG,EAAE;YACZ,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAc,EAAE,EAAE;gBAC/C,OAAO,SAAS,CAAC,OAAO,CAAA;YAC1B,CAAC,CAAC,CAAA;QACJ,CAAC,CAAA;QAED;;WAEG;QACH,UAAK,GAAG,GAAG,EAAE;YACX,IAAI,CAAC,UAAU,GAAG,EAAE,CAAA;QACtB,CAAC,CAAA;QAED;;;;;;WAMG;QACH,QAAG,GAAG,CAAC,SAAc,EAAE,EAAE;YACvB,IAAI,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;gBACjD,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAA;YACtC,CAAC;YAED,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,CAAM,EAAE,EAAE;gBACtC,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAA;YAChC,CAAC,CAAC,CAAA;YAEF,OAAO,SAAS,CAAA;QAClB,CAAC,CAAA;QAED;;;;WAIG;QACH,YAAO,GAAG,GAAG,EAAE;YACb,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,KAAK,CAAC,CAAA;QACnC,CAAC,CAAA;QAED;;;;;;WAMG;QACH,cAAS,GAAG,CAAC,IAAY,EAAE,EAAE;YAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;gBAChD,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;oBAC1C,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;gBAC3B,CAAC;YACH,CAAC;YAED,OAAO,IAAI,CAAA;QACb,CAAC,CAAA;QAED;;;;WAIG;QACH,iBAAY,GAAG,CAAC,IAAY,EAAE,EAAE;YAC9B,MAAM,UAAU,GAAG,EAAE,CAAA;YACrB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;gBAChD,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;oBAC1C,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;gBACrC,CAAC;YACH,CAAC;YAED,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC9B,CAAC,CAAA;QAED;;;;;;WAMG;QACH,SAAI,GAAG,CAAC,QAAkB,EAAE,KAAY,EAAE,cAA8B,EAAE,EAAE;YAC1E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;gBAChD,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,cAAc,CAAC,CAAA;YAC1D,CAAC;QACH,CAAC,CAAA;QAED;;;;;;WAMG;QACH,UAAK,GAAG,CAAC,QAAkB,EAAE,SAAiB,EAAE,KAAY,EAAE,EAAE;YAC9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;gBAChD,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;gBAC7B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,CAAA;YACtD,CAAC;QACH,CAAC,CAAA;QAED;;;;WAIG;QACH,WAAM,GAAG,CAAC,SAAiB,EAAE,EAAE;YAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;gBAChD,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM;oBAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;YACrE,CAAC;QACH,CAAC,CAAA;QAED;;;;WAIG;QACH,sBAAiB,GAAG,CAAC,QAAkB,EAAE,EAAE;YACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;gBAChD,IAAI,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;oBAC/D,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAA;gBAChD,CAAC;YACH,CAAC;QACH,CAAC,CAAA;IACH,CAAC;CAAA"}
+{"version":3,"file":"EmitterBehaviours.js","sourceRoot":"","sources":["../../../src/lib/behaviour/EmitterBehaviours.ts"],"names":[],"mappings":"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"}

package/dist/lib/behaviour/IBehaviour.d.ts

@@ -0,0 +1,41 @@
+import type Particle from '../Particle';
+import type Model from '../Model';
+import type TurbulencePool from '../util/turbulencePool';
+import type BehaviourParser from '../parser/BehaviourParser';
+/**
+ * Interface that any behaviour must implement to work with the particle emitter.
+ * Use this for custom behaviours: implement IBehaviour (or extend Behaviour) and
+ * register your class with BehaviourRegistry so it can be used by name in config.
+ *
+ * @example
+ * // Custom behaviour implementing the interface
+ * class MyCustomBehaviour extends Behaviour {
+ *   enabled = true
+ *   priority = 0
+ *   getName() { return 'MyCustomBehaviour' }
+ *   getProps() { return { enabled: this.enabled, priority: this.priority, name: this.getName() } }
+ *   init(particle, model, turbulencePool) { ... }
+ *   apply(particle, deltaTime, model) { ... }
+ * }
+ * BehaviourRegistry.register('MyCustomBehaviour', MyCustomBehaviour)
+ */
+export interface IBehaviour {
+    /** Whether this behaviour is active */
+    enabled: boolean;
+    /** Higher priority behaviours run first (default 0) */
+    priority: number;
+    /** Unique name used in config and registry (e.g. 'MyCustomBehaviour') */
+    getName(): string;
+    /** Parser for serializing/deserializing this behaviour (default: new BehaviourParser(this)) */
+    getParser(): BehaviourParser;
+    /** Plain object of configurable properties for save/load (must include enabled, priority, name) */
+    getProps(): Record<string, unknown>;
+    /** Called once per particle when it is created */
+    init(particle: Particle, model: Model, turbulencePool: TurbulencePool): void;
+    /** Called every frame per particle */
+    apply(particle: Particle, deltaTime: number, model: Model): void;
+    /** Optional: called once per frame (not per particle) */
+    update?(deltaTime: number): void;
+    /** Optional: called when a particle is removed */
+    onParticleRemoved?(particle: Particle): void;
+}

package/dist/lib/behaviour/IBehaviour.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IBehaviour.js.map

package/dist/lib/behaviour/IBehaviour.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IBehaviour.js","sourceRoot":"","sources":["../../../src/lib/behaviour/IBehaviour.ts"],"names":[],"mappings":""}

package/dist/lib/behaviour/PlaceholderBehaviour.d.ts

@@ -0,0 +1,21 @@
+import type { IBehaviour } from './IBehaviour';
+import type Particle from '../Particle';
+import type Model from '../Model';
+import type TurbulencePool from '../util/turbulencePool';
+import BehaviourParser from '../parser/BehaviourParser';
+/**
+ * Placeholder for unknown/custom behaviour names (e.g. when the editor loads
+ * a config that references a behaviour not registered in this context).
+ * No-ops in init/apply but preserves config for save/load.
+ */
+export default class PlaceholderBehaviour implements IBehaviour {
+    enabled: boolean;
+    priority: number;
+    name: string;
+    constructor(name: string);
+    getName(): string;
+    getParser(): BehaviourParser;
+    getProps(): Record<string, unknown>;
+    init(_particle: Particle, _model: Model, _turbulencePool: TurbulencePool): void;
+    apply(_particle: Particle, _deltaTime: number, _model: Model): void;
+}

package/dist/lib/behaviour/PlaceholderBehaviour.js

@@ -0,0 +1,36 @@
+import BehaviourParser from '../parser/BehaviourParser';
+/**
+ * Placeholder for unknown/custom behaviour names (e.g. when the editor loads
+ * a config that references a behaviour not registered in this context).
+ * No-ops in init/apply but preserves config for save/load.
+ */
+export default class PlaceholderBehaviour {
+    constructor(name) {
+        this.enabled = true;
+        this.priority = 0;
+        this.name = '';
+        this.name = name;
+    }
+    getName() {
+        return this.name;
+    }
+    getParser() {
+        return new BehaviourParser(this);
+    }
+    getProps() {
+        const props = {};
+        for (const key of Object.keys(this)) {
+            if (typeof this[key] !== 'function') {
+                props[key] = this[key];
+            }
+        }
+        return props;
+    }
+    init(_particle, _model, _turbulencePool) {
+        // no-op
+    }
+    apply(_particle, _deltaTime, _model) {
+        // no-op
+    }
+}
+//# sourceMappingURL=PlaceholderBehaviour.js.map

package/dist/lib/behaviour/PlaceholderBehaviour.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaceholderBehaviour.js","sourceRoot":"","sources":["../../../src/lib/behaviour/PlaceholderBehaviour.ts"],"names":[],"mappings":"AAIA,OAAO,eAAe,MAAM,2BAA2B,CAAA;AAEvD;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,oBAAoB;IAKvC,YAAY,IAAY;QAJxB,YAAO,GAAG,IAAI,CAAA;QACd,aAAQ,GAAG,CAAC,CAAA;QACZ,SAAI,GAAG,EAAE,CAAA;QAGP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;IAED,SAAS;QACP,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;IAED,QAAQ;QACN,MAAM,KAAK,GAA4B,EAAE,CAAA;QACzC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,IAAI,OAAQ,IAAY,CAAC,GAAG,CAAC,KAAK,UAAU,EAAE,CAAC;gBAC7C,KAAK,CAAC,GAAG,CAAC,GAAI,IAAY,CAAC,GAAG,CAAC,CAAA;YACjC,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,CAAC,SAAmB,EAAE,MAAa,EAAE,eAA+B;QACtE,QAAQ;IACV,CAAC;IAED,KAAK,CAAC,SAAmB,EAAE,UAAkB,EAAE,MAAa;QAC1D,QAAQ;IACV,CAAC;CACF"}

package/dist/lib/behaviour/index.d.ts

@@ -21,4 +21,6 @@ import LightEffectBehaviour from './LightEffectBehaviour';
 import StretchBehaviour from './StretchBehaviour';
 import TemperatureBehaviour from './TemperatureBehaviour';
 import MoveToPointBehaviour from './MoveToPointBehaviour';
+export type { IBehaviour } from './IBehaviour';
+export { BehaviourRegistry } from './BehaviourRegistry';
 export { EmitterBehaviours, Behaviour, SpawnBehaviour, LifeBehaviour, PositionBehaviour, ColorBehaviour, SizeBehaviour, AngularVelocityBehaviour, EmitDirectionBehaviour, RotationBehaviour, TurbulenceBehaviour, CollisionBehaviour, AttractionRepulsionBehaviour, NoiseBasedMotionBehaviour, ForceFieldsBehaviour, TimelineBehaviour, GroupingBehaviour, SoundReactiveBehaviour, LightEffectBehaviour, StretchBehaviour, TemperatureBehaviour, BehaviourNames, MoveToPointBehaviour, };

package/dist/lib/behaviour/index.js

@@ -21,5 +21,6 @@ import LightEffectBehaviour from './LightEffectBehaviour';
 import StretchBehaviour from './StretchBehaviour';
 import TemperatureBehaviour from './TemperatureBehaviour';
 import MoveToPointBehaviour from './MoveToPointBehaviour';
+export { BehaviourRegistry } from './BehaviourRegistry';
 export { EmitterBehaviours, Behaviour, SpawnBehaviour, LifeBehaviour, PositionBehaviour, ColorBehaviour, SizeBehaviour, AngularVelocityBehaviour, EmitDirectionBehaviour, RotationBehaviour, TurbulenceBehaviour, CollisionBehaviour, AttractionRepulsionBehaviour, NoiseBasedMotionBehaviour, ForceFieldsBehaviour, TimelineBehaviour, GroupingBehaviour, SoundReactiveBehaviour, LightEffectBehaviour, StretchBehaviour, TemperatureBehaviour, BehaviourNames, MoveToPointBehaviour, };
 //# sourceMappingURL=index.js.map

package/dist/lib/behaviour/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/behaviour/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAA;AAC7C,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,SAAS,MAAM,aAAa,CAAA;AACnC,OAAO,aAAa,MAAM,iBAAiB,CAAA;AAC3C,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,cAAc,MAAM,kBAAkB,CAAA;AAC7C,OAAO,4BAA4B,MAAM,gCAAgC,CAAA;AACzE,OAAO,aAAa,MAAM,iBAAiB,CAAA;AAC3C,OAAO,wBAAwB,MAAM,4BAA4B,CAAA;AACjE,OAAO,sBAAsB,MAAM,0BAA0B,CAAA;AAC7D,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,mBAAmB,MAAM,uBAAuB,CAAA;AACvD,OAAO,kBAAkB,MAAM,sBAAsB,CAAA;AACrD,OAAO,yBAAyB,MAAM,6BAA6B,CAAA;AACnE,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AACzD,OAAO,cAAc,MAAM,kBAAkB,CAAA;AAC7C,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,sBAAsB,MAAM,0BAA0B,CAAA;AAC7D,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AACzD,OAAO,gBAAgB,MAAM,oBAAoB,CAAA;AACjD,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AACzD,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AAEzD,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,yBAAyB,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,oBAAoB,GACrB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/behaviour/index.ts"],"names":[],"mappings":"AAAA,OAAO,cAAc,MAAM,kBAAkB,CAAA;AAC7C,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,SAAS,MAAM,aAAa,CAAA;AAEnC,OAAO,aAAa,MAAM,iBAAiB,CAAA;AAC3C,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,cAAc,MAAM,kBAAkB,CAAA;AAC7C,OAAO,4BAA4B,MAAM,gCAAgC,CAAA;AACzE,OAAO,aAAa,MAAM,iBAAiB,CAAA;AAC3C,OAAO,wBAAwB,MAAM,4BAA4B,CAAA;AACjE,OAAO,sBAAsB,MAAM,0BAA0B,CAAA;AAC7D,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,mBAAmB,MAAM,uBAAuB,CAAA;AACvD,OAAO,kBAAkB,MAAM,sBAAsB,CAAA;AACrD,OAAO,yBAAyB,MAAM,6BAA6B,CAAA;AACnE,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AACzD,OAAO,cAAc,MAAM,kBAAkB,CAAA;AAC7C,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,iBAAiB,MAAM,qBAAqB,CAAA;AACnD,OAAO,sBAAsB,MAAM,0BAA0B,CAAA;AAC7D,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AACzD,OAAO,gBAAgB,MAAM,oBAAoB,CAAA;AACjD,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AACzD,OAAO,oBAAoB,MAAM,wBAAwB,CAAA;AAGzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,yBAAyB,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,oBAAoB,GACrB,CAAA"}

package/dist/lib/effects/DissolveEffect.d.ts

@@ -1,4 +1,4 @@
-import { ParticleContainer, Sprite } from 'pixi.js';
+import { Container, Sprite } from 'pixi.js';
 export type DissolveDirection = 'left-to-right' | 'right-to-left' | 'top-to-bottom' | 'bottom-to-top' | 'center-out';
 export interface IDissolveEffectOptions {
     pixelSize?: number;
@@ -10,7 +10,7 @@ export interface IDissolveEffectOptions {
     direction?: DissolveDirection;
     windAngle?: number;
 }
-export default class DissolveEffect extends ParticleContainer {
+export default class DissolveEffect extends Container {
     private sourceSprite;
     private fragments;
     private isProcessing;

package/dist/lib/effects/DissolveEffect.js

@@ -7,26 +7,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { ParticleContainer, Sprite, Texture, Ticker } from 'pixi.js';
+import { Container, Sprite, Texture, Ticker } from 'pixi.js';
 import ParticlePool from '../ParticlePool';
-export default class DissolveEffect extends ParticleContainer {
+export default class DissolveEffect extends Container {
     constructor(sourceSprite, options = {}) {
         var _a, _b, _c, _d, _e, _f, _g, _h;
-        // Determine bounds to set container size
-        const bounds = sourceSprite.getLocalBounds();
-        const pixelSize = (_a = options.pixelSize) !== null && _a !== void 0 ? _a : 2;
-        const maxParticles = Math.ceil((bounds.width * bounds.height) / (pixelSize * pixelSize));
-        super(maxParticles, {
-            vertices: true,
-            position: true,
-            uvs: true,
-            alpha: true,
-            tint: true,
-        });
+        super();
         this.sourceSprite = sourceSprite;
         this.fragments = [];
         this.isProcessing = false;
         this.progress = 0;
+        const pixelSize = (_a = options.pixelSize) !== null && _a !== void 0 ? _a : 2;
         this.options = {
             pixelSize,
             edgeSoftness: (_b = options.edgeSoftness) !== null && _b !== void 0 ? _b : 0.2,
@@ -35,34 +26,48 @@ export default class DissolveEffect extends ParticleContainer {
             lifetime: (_e = options.lifetime) !== null && _e !== void 0 ? _e : 1.5,
             fadeOutDuration: (_f = options.fadeOutDuration) !== null && _f !== void 0 ? _f : 0.5,
             direction: (_g = options.direction) !== null && _g !== void 0 ? _g : 'left-to-right',
-            windAngle: ((_h = options.windAngle) !== null && _h !== void 0 ? _h : -45) * (Math.PI / 180), // Support degrees from UI
+            windAngle: ((_h = options.windAngle) !== null && _h !== void 0 ? _h : -45) * (Math.PI / 180),
         };
+        // Copy transforms from source
         this.x = sourceSprite.x;
         this.y = sourceSprite.y;
         this.rotation = sourceSprite.rotation;
+        this.scale.copyFrom(sourceSprite.scale);
+        this.pivot.copyFrom(sourceSprite.pivot);
     }
     prepare() {
         const texture = this.sourceSprite.texture;
-        if (!texture || !texture.valid)
+        if (!texture || !texture.source) {
+            console.warn('DissolveEffect: Texture source not found.');
             return;
-        const canvas = document.createElement('canvas');
+        }
+        // In Pixi v8, 'resource' is the most reliable path to the raw image data.
+        // It can be an HTMLImageElement, HTMLCanvasElement, or ImageBitmap.
+        const sourceElement = texture.source.resource;
+        if (!sourceElement) {
+            console.warn('DissolveEffect: Could not find valid resource on texture.source.');
+            return;
+        }
         const { width, height } = texture.frame;
+        const canvas = document.createElement('canvas');
         canvas.width = width;
         canvas.height = height;
-        const ctx = canvas.getContext('2d');
-        const baseTex = texture.baseTexture.resource;
-        if (baseTex && (baseTex.source || baseTex.data)) {
-            // tslint:disable-next-line:max-line-length
-            ctx.drawImage(baseTex.source || baseTex.data, texture.frame.x, texture.frame.y, width, height, 0, 0, width, height);
+        const ctx = canvas.getContext('2d', { willReadFrequently: true });
+        // Draw the specific frame (important for Spritesheets/Atlases)
+        try {
+            ctx.drawImage(sourceElement, texture.frame.x, texture.frame.y, texture.frame.width, texture.frame.height, 0, 0, width, height);
+        }
+        catch (e) {
+            console.error('DissolveEffect: Failed to draw texture to canvas. This is likely a CORS issue.', e);
+            return;
         }
         const imgData = ctx.getImageData(0, 0, width, height).data;
         const { pixelSize, edgeSoftness, direction } = this.options;
         const anchorX = this.sourceSprite.anchor.x;
         const anchorY = this.sourceSprite.anchor.y;
-        const scale = this.sourceSprite.scale.x;
         for (let py = 0; py < height; py += pixelSize) {
             for (let px = 0; px < width; px += pixelSize) {
-                const i = (py * width + px) * 4;
+                const i = (Math.floor(py) * width + Math.floor(px)) * 4;
                 if (imgData[i + 3] < 10)
                     continue;
                 let spatialFactor = 0;
@@ -87,11 +92,11 @@ export default class DissolveEffect extends ParticleContainer {
                 }
                 const activationThreshold = spatialFactor * (1 - edgeSoftness) + Math.random() * edgeSoftness;
                 const sprite = new Sprite(Texture.WHITE);
-                sprite.width = sprite.height = pixelSize * scale;
+                sprite.width = sprite.height = pixelSize;
                 // tslint:disable-next-line:no-bitwise
                 sprite.tint = (imgData[i] << 16) | (imgData[i + 1] << 8) | imgData[i + 2];
-                const lx = (px - width * anchorX) * scale;
-                const ly = (py - height * anchorY) * scale;
+                const lx = px - width * anchorX;
+                const ly = py - height * anchorY;
                 const p = ParticlePool.global.pop();
                 p.reset();
                 p.x = lx;
@@ -106,6 +111,8 @@ export default class DissolveEffect extends ParticleContainer {
                     initialY: ly,
                 });
                 this.addChild(sprite);
+                sprite.x = lx;
+                sprite.y = ly;
             }
         }
         this.sourceSprite.visible = false;
@@ -113,6 +120,10 @@ export default class DissolveEffect extends ParticleContainer {
     start() {
         return __awaiter(this, void 0, void 0, function* () {
             this.prepare();
+            if (this.fragments.length === 0) {
+                this.finish();
+                return;
+            }
             this.isProcessing = true;
             return new Promise((resolve) => {
                 this.dissolveResolve = resolve;
@@ -129,9 +140,10 @@ export default class DissolveEffect extends ParticleContainer {
         if (!this.isProcessing)
             return;
         const dt = Ticker.shared.deltaMS / 1000;
-        // progress moves from 0 to 1.2 to ensure all thresholds are met
-        this.progress += dt * 0.6;
-        // Iterate backwards so we can safely splice the array
+        this.progress += dt * 0.7;
+        const { windAngle, driftStrength, noiseIntensity, fadeOutDuration } = this.options;
+        const windX = Math.cos(windAngle) * driftStrength;
+        const windY = Math.sin(windAngle) * driftStrength;
         for (let i = this.fragments.length - 1; i >= 0; i--) {
             const f = this.fragments[i];
             const p = f.particle;
@@ -140,30 +152,21 @@ export default class DissolveEffect extends ParticleContainer {
             }
             if (f.isActive) {
                 p.lifeTime += dt;
-                // Movement
-                const windX = Math.cos(this.options.windAngle) * this.options.driftStrength;
-                const windY = Math.sin(this.options.windAngle) * this.options.driftStrength;
-                const noiseX = (Math.random() - 0.5) * this.options.noiseIntensity;
-                const noiseY = (Math.random() - 0.5) * this.options.noiseIntensity;
-                p.x += (windX + noiseX) * dt;
-                p.y += (windY + noiseY) * dt;
+                const nx = (Math.random() - 0.5) * noiseIntensity;
+                const ny = (Math.random() - 0.5) * noiseIntensity;
+                p.x += (windX + nx) * dt;
+                p.y += (windY + ny) * dt;
                 f.sprite.x = p.x;
                 f.sprite.y = p.y;
-                // Alpha Fade
                 const lifeProg = p.lifeTime / p.maxLifeTime;
-                const fadeThreshold = 1 - this.options.fadeOutDuration / p.maxLifeTime;
+                const fadeThreshold = 1 - fadeOutDuration / p.maxLifeTime;
                 if (lifeProg > fadeThreshold) {
                     f.sprite.alpha = Math.max(0, 1 - (lifeProg - fadeThreshold) / (1 - fadeThreshold));
                 }
-                // REMOVAL LOGIC: Check if lifetime ended
                 if (p.lifeTime >= p.maxLifeTime || f.sprite.alpha <= 0) {
                     this.removeFragment(i);
                 }
             }
-            else {
-                f.sprite.x = f.initialX;
-                f.sprite.y = f.initialY;
-            }
         }
         if (this.fragments.length === 0) {
             this.finish();
@@ -187,7 +190,7 @@ export default class DissolveEffect extends ParticleContainer {
     }
     destroy(options) {
         Ticker.shared.remove(this.update, this);
-        this.fragments.forEach((f, i) => {
+        this.fragments.forEach((f) => {
             if (f.particle)
                 ParticlePool.global.push(f.particle);
         });