custom-pixi-particles 4.31.0 → 4.33.0

package/README.md

@@ -552,6 +552,60 @@ 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
+```
+
+**Extending built-in behaviours:** All built-in behaviour classes are exported from the package so you can extend any of them: `SpawnBehaviour`, `LifeBehaviour`, `PositionBehaviour`, `ColorBehaviour`, `SizeBehaviour`, `AngularVelocityBehaviour`, `EmitDirectionBehaviour`, `RotationBehaviour`, `TurbulenceBehaviour`, `CollisionBehaviour`, `AttractionRepulsionBehaviour`, `NoiseBasedMotionBehaviour`, `ForceFieldsBehaviour`, `TimelineBehaviour`, `GroupingBehaviour`, `SoundReactiveBehaviour`, `LightEffectBehaviour`, `StretchBehaviour`, `TemperatureBehaviour`, `MoveToPointBehaviour`. Also exported: `Behaviour`, `BehaviourRegistry`, `EmitterBehaviours`, `BehaviourNames`.
+
+**Replacing a built-in behaviour:** Register your class under the same name as a built-in (e.g. `SpawnBehaviour`) **before** creating the renderer or loading config. The registry is checked first, so your implementation is used instead. Use this for customizations like multiple trails on one shape, different trailing logic (e.g. CCV-style), or any variant of spawn/trail/position without changing the library.
+
+```javascript
+import { BehaviourRegistry, SpawnBehaviour } from 'custom-pixi-particles'
+
+class MySpawnBehaviour extends SpawnBehaviour {
+  getName() { return 'SpawnBehaviour' }
+  // Override init/apply, add multiple trails, custom trailing (e.g. CCV), etc.
+}
+BehaviourRegistry.register('SpawnBehaviour', MySpawnBehaviour)
+// Then create renderer / load config that uses name: 'SpawnBehaviour'
+```
+
+**Unregister:** `BehaviourRegistry.unregister('MyCustomBehaviour')` removes a registration. To restore a built-in after replacing it, unregister the custom name so the built-in is used again (built-ins are not in the registry by default).
+
 #### Life Behaviour
 Controls particle lifetime.
 
@@ -597,13 +651,20 @@ Defines where and how particles spawn. Supports multiple spawn types.
       // ... spawn type specific properties
     },
   ],
-  trailingEnabled: false,      // Enable trail effects
-  spawnAlongTrail: false,     // Spawn along entire trail
+  trailingEnabled: false,      // Enable trail effects (path types only)
+  spawnAlongTrail: false,      // true = uniform along trail; false = weighted toward leading edge
   trailSpeed: 1,              // Trail animation speed
+  trailRepeat: true,           // Loop the trail
+  trailStart: 0,               // Start position on path (0–1)
+  trailRangeSegments: 20,      // Sampling points along trail (higher = finer distribution)
+  trailRangeWeightFactor: 4,  // Weight toward leading edge when spawnAlongTrail is false
+  trailRangeLength: 1,        // Length of trail to spawn along (0–1); <1 avoids particles at path start
   name: 'SpawnBehaviour',
 }
 ```
 
+**Trailing:** When `trailingEnabled` is true (path types like Frame, Ring, Bezier only), particles spawn along a moving “head” on the path. **Spawn Along Trail** on = even spread along the trail; off = more particles near the leading edge (**trailRangeWeightFactor**). **Trail Range Segments** sets how many sample points are used (higher = smoother). **Trail Range Length** (0–1) limits where particles appear: `1` = from path start to head; e.g. `0.2` = only the last 20% of the path, so the path start (e.g. top-left of a Frame) stays clear. **Trail Speed**, **Trail Repeat**, and **Trail Start** (0–1) control motion. When the path loops, the tail at the end stays visible until the head moves on.
+
 **Available Spawn Types:**
 - `Rectangle` - Uniform distribution in a rectangular area
 - `Ring` - Circular particle arrangement

package/dist/index.d.ts

@@ -9,9 +9,12 @@ export type { IShatterEffectOptions, ShatterMode, IDissolveEffectOptions, Dissol
  * @param {ICustomPixiParticlesSettings} settings The settings for the renderer
  */
 declare const customPixiParticles: {
-    create(settings: ICustomPixiParticlesSettings): Renderer;
+    create(settings: ICustomPixiParticlesSettings): any;
 };
 declare const _customPixiParticlesEditorOnly: {
     create(settings: ICustomPixiParticlesSettings): TestRenderer;
 };
+export type { IBehaviour } from './lib/behaviour';
+export { Behaviour, BehaviourRegistry, EmitterBehaviours, SpawnBehaviour, LifeBehaviour, PositionBehaviour, ColorBehaviour, SizeBehaviour, AngularVelocityBehaviour, EmitDirectionBehaviour, RotationBehaviour, TurbulenceBehaviour, CollisionBehaviour, AttractionRepulsionBehaviour, NoiseBasedMotionBehaviour, ForceFieldsBehaviour, TimelineBehaviour, GroupingBehaviour, SoundReactiveBehaviour, LightEffectBehaviour, StretchBehaviour, TemperatureBehaviour, MoveToPointBehaviour, Wireframe3DBehaviour, BehaviourNames, } from './lib/behaviour';
+export { Application, Loader } from 'pixi.js';
 export { Renderer, customPixiParticles, _customPixiParticlesEditorOnly, ICustomPixiParticlesSettings, ShatterEffect, DissolveEffect, MagneticAssemblyEffect, GhostEffect, GlitchEffect, MeltEffect, };

package/dist/index.js

@@ -1,6 +1,7 @@
 import Renderer from './lib/pixi/Renderer';
 import TestRenderer from './lib/pixi/TestRenderer';
 import { ShatterEffect, DissolveEffect, MagneticAssemblyEffect, GhostEffect, GlitchEffect, MeltEffect } from './lib/effects';
+import { Container, Graphics } from 'pixi.js-legacy';
 /**
  * Constructs a renderer for custom pixi particles
  * @class Renderer
@@ -8,8 +9,10 @@ import { ShatterEffect, DissolveEffect, MagneticAssemblyEffect, GhostEffect, Gli
  */
 const customPixiParticles = {
     create(settings) {
+        var _a;
         const { textures, emitterConfig, animatedSpriteZeroPad = 2, animatedSpriteIndexToStart = 0, finishingTextures = [], vertices = true, position = true, rotation = true, uvs = true, tint = true, maxParticles = 10000, maxFPS = 60, minFPS = 30, tickerSpeed = 0.02, } = settings;
-        return new Renderer({
+        const hasWireframe = (_a = emitterConfig === null || emitterConfig === void 0 ? void 0 : emitterConfig.behaviours) === null || _a === void 0 ? void 0 : _a.some((b) => b.name === 'Wireframe3DBehaviour');
+        const renderer = new Renderer({
             textures,
             animatedSpriteZeroPad,
             animatedSpriteIndexToStart,
@@ -25,6 +28,31 @@ const customPixiParticles = {
             minFPS,
             tickerSpeed,
         });
+        if (hasWireframe) {
+            const graphics = new Graphics();
+            const container = new Container();
+            container.addChild(graphics);
+            container.addChild(renderer);
+            renderer.wireframeGraphics = graphics;
+            Object.defineProperty(container, 'emitter', { get: () => renderer.emitter });
+            container.updateConfig = (c) => renderer.updateConfig(c);
+            container.updatePosition = (p) => renderer.updatePosition(p);
+            container.play = () => renderer.play();
+            container.stop = () => renderer.stop();
+            container.stopImmediately = () => renderer.stopImmediately();
+            container.pause = (p) => renderer.pause(p);
+            container.resume = () => renderer.resume();
+            container.start = () => renderer.start();
+            container.setTickerSpeed = (s) => renderer.setTickerSpeed(s);
+            container.updateTexture = () => renderer.updateTexture();
+            const origDestroy = container.destroy.bind(container);
+            container.destroy = () => {
+                renderer.destroy();
+                origDestroy();
+            };
+            return container;
+        }
+        return renderer;
     },
 };
 const _customPixiParticlesEditorOnly = {
@@ -42,5 +70,8 @@ const _customPixiParticlesEditorOnly = {
         });
     },
 };
+export { Behaviour, BehaviourRegistry, EmitterBehaviours, SpawnBehaviour, LifeBehaviour, PositionBehaviour, ColorBehaviour, SizeBehaviour, AngularVelocityBehaviour, EmitDirectionBehaviour, RotationBehaviour, TurbulenceBehaviour, CollisionBehaviour, AttractionRepulsionBehaviour, NoiseBasedMotionBehaviour, ForceFieldsBehaviour, TimelineBehaviour, GroupingBehaviour, SoundReactiveBehaviour, LightEffectBehaviour, StretchBehaviour, TemperatureBehaviour, MoveToPointBehaviour, Wireframe3DBehaviour, BehaviourNames, } from './lib/behaviour';
+// Re-export so demos can use one import (avoids loading Pixi twice)
+export { Application, Loader } 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,EAAE,aAAa,EAAE,cAAc,EAAE,sBAAsB,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAI5H;;;;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,EAAE,aAAa,EAAE,cAAc,EAAE,sBAAsB,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC5H,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAIpD;;;;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,MAAM,YAAY,GAAG,MAAA,aAAa,aAAb,aAAa,uBAAb,aAAa,CAAE,UAAU,0CAAE,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,sBAAsB,CAAC,CAAA;QACnG,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC;YAC5B,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;QACF,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAA;YAC/B,MAAM,SAAS,GAAG,IAAI,SAAS,EAAS,CAAA;YACxC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;YAC5B,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;YAC5B,QAAQ,CAAC,iBAAiB,GAAG,QAAQ,CAAA;YACrC,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;YAC5E,SAAS,CAAC,YAAY,GAAG,CAAC,CAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;YAC7D,SAAS,CAAC,cAAc,GAAG,CAAC,CAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAA;YACjE,SAAS,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;YACtC,SAAS,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;YACtC,SAAS,CAAC,eAAe,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAA;YAC5D,SAAS,CAAC,KAAK,GAAG,CAAC,CAAW,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;YACpD,SAAS,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAA;YAC1C,SAAS,CAAC,KAAK,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;YACxC,SAAS,CAAC,cAAc,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAA;YACpE,SAAS,CAAC,aAAa,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAA;YACxD,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACrD,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE;gBACvB,QAAQ,CAAC,OAAO,EAAE,CAAA;gBAClB,WAAW,EAAE,CAAA;YACf,CAAC,CAAA;YACD,OAAO,SAAS,CAAA;QAClB,CAAC;QACD,OAAO,QAAQ,CAAA;IACjB,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,EACL,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,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,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,GACf,MAAM,iBAAiB,CAAA;AAExB,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/BehaviourNames.d.ts

@@ -19,5 +19,6 @@ declare const behaviourNames: {
     STRETCH_BEHAVIOUR: string;
     TEMPERATURE_BEHAVIOUR: string;
     MOVE_TO_POINT_BEHAVIOUR: string;
+    WIREFRAME_3D_BEHAVIOUR: string;
 };
 export default behaviourNames;

package/dist/lib/behaviour/BehaviourNames.js

@@ -19,6 +19,7 @@ const behaviourNames = {
     STRETCH_BEHAVIOUR: 'StretchBehaviour',
     TEMPERATURE_BEHAVIOUR: 'TemperatureBehaviour',
     MOVE_TO_POINT_BEHAVIOUR: 'MoveToPointBehaviour',
+    WIREFRAME_3D_BEHAVIOUR: 'Wireframe3DBehaviour',
 };
 export default behaviourNames;
 //# sourceMappingURL=BehaviourNames.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"BehaviourNames.js","sourceRoot":"","sources":["../../../src/lib/behaviour/BehaviourNames.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG;IACrB,iBAAiB,EAAE,0BAA0B;IAC7C,cAAc,EAAE,eAAe;IAC/B,eAAe,EAAE,gBAAgB;IACjC,kBAAkB,EAAE,mBAAmB;IACvC,cAAc,EAAE,eAAe;IAC/B,cAAc,EAAE,wBAAwB;IACxC,kBAAkB,EAAE,mBAAmB;IACvC,oBAAoB,EAAE,qBAAqB;IAC3C,mBAAmB,EAAE,oBAAoB;IACzC,8BAA8B,EAAE,8BAA8B;IAC9D,4BAA4B,EAAE,2BAA2B;IACzD,sBAAsB,EAAE,sBAAsB;IAC9C,eAAe,EAAE,gBAAgB;IACjC,kBAAkB,EAAE,mBAAmB;IACvC,kBAAkB,EAAE,mBAAmB;IACvC,wBAAwB,EAAE,wBAAwB;IAClD,sBAAsB,EAAE,sBAAsB;IAC9C,iBAAiB,EAAE,kBAAkB;IACrC,qBAAqB,EAAE,sBAAsB;IAC7C,uBAAuB,EAAE,sBAAsB;CAChD,CAAA;AAED,eAAe,cAAc,CAAA"}
+{"version":3,"file":"BehaviourNames.js","sourceRoot":"","sources":["../../../src/lib/behaviour/BehaviourNames.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG;IACrB,iBAAiB,EAAE,0BAA0B;IAC7C,cAAc,EAAE,eAAe;IAC/B,eAAe,EAAE,gBAAgB;IACjC,kBAAkB,EAAE,mBAAmB;IACvC,cAAc,EAAE,eAAe;IAC/B,cAAc,EAAE,wBAAwB;IACxC,kBAAkB,EAAE,mBAAmB;IACvC,oBAAoB,EAAE,qBAAqB;IAC3C,mBAAmB,EAAE,oBAAoB;IACzC,8BAA8B,EAAE,8BAA8B;IAC9D,4BAA4B,EAAE,2BAA2B;IACzD,sBAAsB,EAAE,sBAAsB;IAC9C,eAAe,EAAE,gBAAgB;IACjC,kBAAkB,EAAE,mBAAmB;IACvC,kBAAkB,EAAE,mBAAmB;IACvC,wBAAwB,EAAE,wBAAwB;IAClD,sBAAsB,EAAE,sBAAsB;IAC9C,iBAAiB,EAAE,kBAAkB;IACrC,qBAAqB,EAAE,sBAAsB;IAC7C,uBAAuB,EAAE,sBAAsB;IAC/C,sBAAsB,EAAE,sBAAsB;CAC/C,CAAA;AAED,eAAe,cAAc,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":"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"}
+{"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,43 @@
+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;
+    /** Optional: draw wireframe/Graphics (e.g. Wireframe3DBehaviour) */
+    draw?(graphics: any, deltaTime: number): 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/SpawnBehaviour.d.ts

@@ -12,7 +12,9 @@ export default class SpawnBehaviour extends Behaviour {
     trailStart: number;
     trailRangeSegments: number;
     trailRangeWeightFactor: number;
+    trailRangeLength: number;
     currentProgress: number;
+    trailJustWrapped: boolean;
     customPoints: any[];
     lastWordSettings: any;
     /**
@@ -21,12 +23,17 @@ export default class SpawnBehaviour extends Behaviour {
      */
     init: (particle: Particle) => void;
     apply: () => void;
+    /** Distance along path from progress p to head (end), going backward; path is 0..1 circular. */
+    private distanceFromHead;
     /**
-     * Calculate trail positions along the range from trailStart to currentProgress.
+     * Calculate trail positions along the range. Uses trailRangeLength so only the "tail" is sampled.
+     * When the head wraps to the start of the path, we still spawn along the end of the previous loop
+     * so the tail at the frame end doesn't disappear.
      * @param {Object} point - The custom point configuration.
-     * @returns {Point[]} List of positions along the trail.
+     * @param {boolean} uniformWeights - If true (spawnAlongTrail), equal probability.
+     * @returns {{ positions, probabilities }}
      */
-    calculateTrailRangePositions: (point: any) => {
+    calculateTrailRangePositions: (point: any, uniformWeights?: boolean) => {
         positions: any[];
         probabilities: number[];
     };
@@ -85,6 +92,7 @@ export default class SpawnBehaviour extends Behaviour {
         trailStart: number;
         trailRangeSegments: number;
         trailRangeWeightFactor: number;
+        trailRangeLength: number;
         customPoints: any[];
         name: string;
     };