custom-pixi-particles 8.1.1 → 8.1.2

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

@@ -0,0 +1,61 @@
+import Behaviour from './Behaviour';
+import Particle from '../Particle';
+export default class AngularVelocityBehaviour extends Behaviour {
+    protected priority: number;
+    private enabled;
+    private degrees;
+    private degreesVariance;
+    private maxRadius;
+    private maxRadiusVariance;
+    private minRadius;
+    private minRadiusVariance;
+    private oscillate;
+    private oscillationSpeed;
+    private oscillationAmplitude;
+    private linearRadiusReduction;
+    private dynamicRadius;
+    /**
+     * Initializes particle properties of the behaviour
+     *
+     * @param {Particle} particle - The current particle
+     * @memberof AngularVelocityBehaviour
+     */
+    init: (particle: Particle) => void;
+    /**
+     * Applies the behaviour to the particle
+     *
+     * @param {Particle} particle - The current particle
+     * @param {number} deltaTime - Time elapsed since the last frame
+     * @memberof AngularVelocityBehaviour
+     */
+    apply: (particle: Particle, deltaTime: number) => void;
+    /**
+     * Returns the name of the behaviour
+     *
+     * @returns {string} Name of the behaviour
+     * @memberof AngularVelocityBehaviour
+     */
+    getName(): string;
+    /**
+     * Returns the properties of the behaviour
+     *
+     * @returns {object} Properties of the behaviour
+     * @memberof AngularVelocityBehaviour
+     */
+    getProps(): {
+        enabled: boolean;
+        degrees: number;
+        degreesVariance: number;
+        maxRadius: number;
+        maxRadiusVariance: number;
+        minRadius: number;
+        minRadiusVariance: number;
+        oscillate: boolean;
+        oscillationSpeed: number;
+        oscillationAmplitude: number;
+        linearRadiusReduction: boolean;
+        dynamicRadius: boolean;
+        priority: number;
+        name: string;
+    };
+}

package/dist/lib/behaviour/AngularVelocityBehaviour.js

@@ -0,0 +1,118 @@
+import Behaviour from './Behaviour';
+import math from '../util/maths';
+import BehaviourNames from './BehaviourNames';
+export default class AngularVelocityBehaviour extends Behaviour {
+    constructor() {
+        super(...arguments);
+        this.priority = 100;
+        this.enabled = false;
+        this.degrees = 0;
+        this.degreesVariance = 0;
+        this.maxRadius = 0;
+        this.maxRadiusVariance = 0;
+        this.minRadius = 0;
+        this.minRadiusVariance = 0;
+        this.oscillate = false; // Oscillate angular velocity
+        this.oscillationSpeed = 1; // Speed of oscillation
+        this.oscillationAmplitude = 10; // Amplitude of oscillation in degrees
+        this.linearRadiusReduction = true; // Linear or exponential radius reduction
+        this.dynamicRadius = false; // Allow dynamic radius changes during lifetime
+        /**
+         * Initializes particle properties of the behaviour
+         *
+         * @param {Particle} particle - The current particle
+         * @memberof AngularVelocityBehaviour
+         */
+        this.init = (particle) => {
+            if (!this.enabled)
+                return;
+            particle.radiansPerSecond = math.degreesToRadians(this.degrees + this.varianceFrom(this.degreesVariance));
+            const radiusStart = this.maxRadius + this.varianceFrom(this.maxRadiusVariance);
+            const radiusEnd = this.minRadius + this.varianceFrom(this.minRadiusVariance);
+            particle.radiusStart = radiusStart;
+            particle.radiusEnd = radiusEnd;
+            particle.velocityAngle = 0;
+            particle.x = 0;
+            particle.y = 0;
+            particle.radius = radiusStart;
+            particle.angle = 0;
+        };
+        /**
+         * Applies the behaviour to the particle
+         *
+         * @param {Particle} particle - The current particle
+         * @param {number} deltaTime - Time elapsed since the last frame
+         * @memberof AngularVelocityBehaviour
+         */
+        this.apply = (particle, deltaTime) => {
+            if (!this.enabled)
+                return;
+            if (particle.skipAngularVelocityBehaviour)
+                return;
+            const { radiusStart, radiusEnd, radiansPerSecond, lifeProgress, velocityAngle } = particle;
+            let angleVelocity = radiansPerSecond;
+            // Oscillation logic
+            if (this.oscillate) {
+                const oscillationFactor = Math.sin(particle.lifeTime * this.oscillationSpeed) * this.oscillationAmplitude;
+                angleVelocity += math.degreesToRadians(oscillationFactor);
+            }
+            // Update angle
+            const newVelocityAngle = velocityAngle + angleVelocity * deltaTime;
+            // Radius calculation
+            let newRadius;
+            if (this.linearRadiusReduction) {
+                newRadius = radiusStart + (radiusEnd - radiusStart) * lifeProgress;
+            }
+            else {
+                // Exponential radius reduction
+                const progressFactor = Math.pow(lifeProgress, 2);
+                newRadius = radiusStart + (radiusEnd - radiusStart) * progressFactor;
+            }
+            if (this.dynamicRadius) {
+                newRadius += Math.sin(particle.lifeTime * 2 * Math.PI) * 5; // Example dynamic change
+            }
+            const movementX = Math.cos(newVelocityAngle) * newRadius;
+            const movementY = Math.sin(newVelocityAngle) * newRadius;
+            particle.velocityAngle = newVelocityAngle;
+            particle.radius = newRadius;
+            particle.movement.x = movementX;
+            particle.movement.y = movementY;
+            particle.x = movementX;
+            particle.y = movementY;
+        };
+    }
+    /**
+     * Returns the name of the behaviour
+     *
+     * @returns {string} Name of the behaviour
+     * @memberof AngularVelocityBehaviour
+     */
+    getName() {
+        return BehaviourNames.ANGULAR_BEHAVIOUR;
+    }
+    /**
+     * Returns the properties of the behaviour
+     *
+     * @returns {object} Properties of the behaviour
+     * @memberof AngularVelocityBehaviour
+     */
+    getProps() {
+        return {
+            enabled: this.enabled,
+            degrees: this.degrees,
+            degreesVariance: this.degreesVariance,
+            maxRadius: this.maxRadius,
+            maxRadiusVariance: this.maxRadiusVariance,
+            minRadius: this.minRadius,
+            minRadiusVariance: this.minRadiusVariance,
+            oscillate: this.oscillate,
+            oscillationSpeed: this.oscillationSpeed,
+            oscillationAmplitude: this.oscillationAmplitude,
+            linearRadiusReduction: this.linearRadiusReduction,
+            dynamicRadius: this.dynamicRadius,
+            priority: this.priority,
+            name: this.getName(),
+        };
+    }
+}
+//# sourceMappingURL=AngularVelocityBehaviour.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AngularVelocityBehaviour.js","sourceRoot":"","sources":["../../../src/lib/behaviour/AngularVelocityBehaviour.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,42 @@
+import { Behaviour } from './index';
+import Particle from '../Particle';
+/**
+ * AttractionRepulsionBehaviour applies attraction or repulsion forces to particles
+ * without overriding other position-related behaviors.
+ * @extends Behaviour
+ */
+export default class AttractionRepulsionBehaviour extends Behaviour {
+    enabled: boolean;
+    priority: number;
+    /**
+     * List of influence points affecting particles.
+     * Each point: { point: Point, strength: number, range: number }
+     */
+    influencePoints: never[];
+    /**
+     * Initializes the particle, but does not modify position directly.
+     * @param {Particle} particle - The particle to initialize.
+     */
+    init: (particle: Particle) => void;
+    /**
+     * Applies attraction or repulsion forces to the particle additively.
+     * @param {Particle} particle - The particle to apply the behavior to.
+     * @param {number} deltaTime - Time elapsed since the last frame.
+     */
+    apply: (particle: Particle, deltaTime: number) => void;
+    /**
+     * Gets the name of the behavior.
+     * @returns {string} - The name of the behavior.
+     */
+    getName(): string;
+    /**
+     * Gets the properties of the behavior.
+     * @returns {object} - The properties of the behavior.
+     */
+    getProps(): {
+        enabled: boolean;
+        priority: number;
+        influencePoints: never[];
+        name: string;
+    };
+}

package/dist/lib/behaviour/AttractionRepulsionBehaviour.js

@@ -0,0 +1,78 @@
+import { Behaviour, BehaviourNames } from './index';
+/**
+ * AttractionRepulsionBehaviour applies attraction or repulsion forces to particles
+ * without overriding other position-related behaviors.
+ * @extends Behaviour
+ */
+export default class AttractionRepulsionBehaviour extends Behaviour {
+    constructor() {
+        super(...arguments);
+        this.enabled = true;
+        this.priority = 200; // Ensure this runs after PositionBehaviour if needed
+        /**
+         * List of influence points affecting particles.
+         * Each point: { point: Point, strength: number, range: number }
+         */
+        this.influencePoints = [];
+        /**
+         * Initializes the particle, but does not modify position directly.
+         * @param {Particle} particle - The particle to initialize.
+         */
+        this.init = (particle) => {
+            // Initialization logic if needed.
+        };
+        /**
+         * Applies attraction or repulsion forces to the particle additively.
+         * @param {Particle} particle - The particle to apply the behavior to.
+         * @param {number} deltaTime - Time elapsed since the last frame.
+         */
+        this.apply = (particle, deltaTime) => {
+            if (!this.enabled || particle.skipPositionBehaviour || particle.skipAttractionRepulsionBehaviour)
+                return;
+            // Accumulate influence forces
+            let totalForceX = 0;
+            let totalForceY = 0;
+            this.influencePoints.forEach(({ point, strength, range }) => {
+                // @ts-ignore
+                const dx = point.x - particle.x;
+                // @ts-ignore
+                const dy = point.y - particle.y;
+                const distanceSquared = dx * dx + dy * dy;
+                if (distanceSquared > range * range || distanceSquared === 0)
+                    return;
+                const distance = Math.sqrt(distanceSquared);
+                const force = strength * (1 - distance / range) * deltaTime;
+                const normalizedDx = dx / distance;
+                const normalizedDy = dy / distance;
+                totalForceX += normalizedDx * force;
+                totalForceY += normalizedDy * force;
+            });
+            // Add forces to particle velocity (or acceleration for smoother effects)
+            particle.velocity.x += totalForceX;
+            particle.velocity.y += totalForceY;
+            // Apply updated velocity to position additively
+            particle.x += particle.velocity.x * deltaTime;
+            particle.y += particle.velocity.y * deltaTime;
+        };
+    }
+    /**
+     * Gets the name of the behavior.
+     * @returns {string} - The name of the behavior.
+     */
+    getName() {
+        return BehaviourNames.ATTRACTION_REPULSION_BEHAVIOUR;
+    }
+    /**
+     * Gets the properties of the behavior.
+     * @returns {object} - The properties of the behavior.
+     */
+    getProps() {
+        return {
+            enabled: this.enabled,
+            priority: this.priority,
+            influencePoints: this.influencePoints,
+            name: this.getName(),
+        };
+    }
+}
+//# sourceMappingURL=AttractionRepulsionBehaviour.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AttractionRepulsionBehaviour.js","sourceRoot":"","sources":["../../../src/lib/behaviour/AttractionRepulsionBehaviour.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAGnD;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,4BAA6B,SAAQ,SAAS;IAAnE;;QACE,YAAO,GAAG,IAAI,CAAA;QACd,aAAQ,GAAG,GAAG,CAAA,CAAC,qDAAqD;QAEpE;;;WAGG;QACH,oBAAe,GAAG,EAAE,CAAA;QAEpB;;;WAGG;QACH,SAAI,GAAG,CAAC,QAAkB,EAAE,EAAE;YAC5B,kCAAkC;QACpC,CAAC,CAAA;QAED;;;;WAIG;QACH,UAAK,GAAG,CAAC,QAAkB,EAAE,SAAiB,EAAE,EAAE;YAChD,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,qBAAqB,IAAI,QAAQ,CAAC,gCAAgC;gBAAE,OAAM;YAExG,8BAA8B;YAC9B,IAAI,WAAW,GAAG,CAAC,CAAA;YACnB,IAAI,WAAW,GAAG,CAAC,CAAA;YAEnB,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE;gBAC1D,aAAa;gBACb,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAA;gBAC/B,aAAa;gBACb,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAA;gBAC/B,MAAM,eAAe,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;gBAEzC,IAAI,eAAe,GAAG,KAAK,GAAG,KAAK,IAAI,eAAe,KAAK,CAAC;oBAAE,OAAM;gBAEpE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA;gBAC3C,MAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,QAAQ,GAAG,KAAK,CAAC,GAAG,SAAS,CAAA;gBAE3D,MAAM,YAAY,GAAG,EAAE,GAAG,QAAQ,CAAA;gBAClC,MAAM,YAAY,GAAG,EAAE,GAAG,QAAQ,CAAA;gBAElC,WAAW,IAAI,YAAY,GAAG,KAAK,CAAA;gBACnC,WAAW,IAAI,YAAY,GAAG,KAAK,CAAA;YACrC,CAAC,CAAC,CAAA;YAEF,yEAAyE;YACzE,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,WAAW,CAAA;YAClC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,WAAW,CAAA;YAElC,gDAAgD;YAChD,QAAQ,CAAC,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAA;YAC7C,QAAQ,CAAC,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAA;QAC/C,CAAC,CAAA;IAsBH,CAAC;IApBC;;;OAGG;IACH,OAAO;QACL,OAAO,cAAc,CAAC,8BAA8B,CAAA;IACtD,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;SACrB,CAAA;IACH,CAAC;CACF"}

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

@@ -0,0 +1,33 @@
+import BehaviourParser from '../parser/BehaviourParser';
+/**
+ * Creates a new Behaviour
+ *
+ * @class
+ */
+export default class Behaviour {
+    /**
+     * A protected property used to store the priority of the behaviour
+     *
+     * @protected
+     */
+    protected priority: number;
+    /**
+     * Calculates the variance from a given value
+     *
+     * @param {number} value - a given value
+     * @returns {number} the variance based on the given value
+     */
+    varianceFrom: (value: number) => number;
+    /**
+     * Gets the name of the behaviour
+     *
+     * @returns {string} The name of the behaviour
+     */
+    getName(): void;
+    /**
+     * Gets the parser for the behaviour
+     *
+     * @returns {BehaviourParser} The parser for the behaviour
+     */
+    getParser: () => BehaviourParser;
+}

package/dist/lib/behaviour/Behaviour.js

@@ -0,0 +1,45 @@
+import BehaviourParser from '../parser/BehaviourParser';
+import { Random } from '../util';
+/**
+ * Creates a new Behaviour
+ *
+ * @class
+ */
+export default class Behaviour {
+    constructor() {
+        /**
+         * A protected property used to store the priority of the behaviour
+         *
+         * @protected
+         */
+        this.priority = 0;
+        /**
+         * Calculates the variance from a given value
+         *
+         * @param {number} value - a given value
+         * @returns {number} the variance based on the given value
+         */
+        this.varianceFrom = (value) => {
+            if (value === 0)
+                return 0;
+            return Random.uniform(-1.0, 1.0) * value;
+        };
+        /**
+         * Gets the parser for the behaviour
+         *
+         * @returns {BehaviourParser} The parser for the behaviour
+         */
+        this.getParser = () => {
+            return new BehaviourParser(this);
+        };
+    }
+    /**
+     * Gets the name of the behaviour
+     *
+     * @returns {string} The name of the behaviour
+     */
+    getName() {
+        throw new Error('This method has to be overridden in subclass');
+    }
+}
+//# sourceMappingURL=Behaviour.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Behaviour.js","sourceRoot":"","sources":["../../../src/lib/behaviour/Behaviour.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAEhC;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,SAAS;IAA9B;QACE;;;;WAIG;QACO,aAAQ,GAAG,CAAC,CAAA;QAEtB;;;;;WAKG;QACH,iBAAY,GAAG,CAAC,KAAa,EAAE,EAAE;YAC/B,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAA;YACzB,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,CAAA;QAC1C,CAAC,CAAA;QAWD;;;;WAIG;QACH,cAAS,GAAG,GAAG,EAAE;YACf,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,CAAA;QAClC,CAAC,CAAA;IACH,CAAC;IAjBC;;;;OAIG;IACH,OAAO;QACL,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACjE,CAAC;CAUF"}

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

@@ -0,0 +1,22 @@
+declare const behaviourNames: {
+    ANGULAR_BEHAVIOUR: string;
+    LIFE_BEHAVIOUR: string;
+    COLOR_BEHAVIOUR: string;
+    POSITION_BEHAVIOUR: string;
+    SIZE_BEHAVIOUR: string;
+    EMIT_DIRECTION: string;
+    ROTATION_BEHAVIOUR: string;
+    TURBULENCE_BEHAVIOUR: string;
+    COLLISION_BEHAVIOUR: string;
+    ATTRACTION_REPULSION_BEHAVIOUR: string;
+    NOISE_BASED_MOTION_BEHAVIOUR: string;
+    FORCE_FIELDS_BEHAVIOUR: string;
+    SPAWN_BEHAVIOUR: string;
+    TIMELINE_BEHAVIOUR: string;
+    GROUPING_BEHAVIOUR: string;
+    SOUND_REACTIVE_BEHAVIOUR: string;
+    LIGHT_EFFECT_BEHAVIOUR: string;
+    STRETCH_BEHAVIOUR: string;
+    TEMPERATURE_BEHAVIOUR: string;
+};
+export default behaviourNames;

package/dist/lib/behaviour/BehaviourNames.js

@@ -0,0 +1,23 @@
+const behaviourNames = {
+    ANGULAR_BEHAVIOUR: 'AngularVelocityBehaviour',
+    LIFE_BEHAVIOUR: 'LifeBehaviour',
+    COLOR_BEHAVIOUR: 'ColorBehaviour',
+    POSITION_BEHAVIOUR: 'PositionBehaviour',
+    SIZE_BEHAVIOUR: 'SizeBehaviour',
+    EMIT_DIRECTION: 'EmitDirectionBehaviour',
+    ROTATION_BEHAVIOUR: 'RotationBehaviour',
+    TURBULENCE_BEHAVIOUR: 'TurbulenceBehaviour',
+    COLLISION_BEHAVIOUR: 'CollisionBehaviour',
+    ATTRACTION_REPULSION_BEHAVIOUR: 'AttractionRepulsionBehaviour',
+    NOISE_BASED_MOTION_BEHAVIOUR: 'NoiseBasedMotionBehaviour',
+    FORCE_FIELDS_BEHAVIOUR: 'ForceFieldsBehaviour',
+    SPAWN_BEHAVIOUR: 'SpawnBehaviour',
+    TIMELINE_BEHAVIOUR: 'TimelineBehaviour',
+    GROUPING_BEHAVIOUR: 'GroupingBehaviour',
+    SOUND_REACTIVE_BEHAVIOUR: 'SoundReactiveBehaviour',
+    LIGHT_EFFECT_BEHAVIOUR: 'LightEffectBehaviour',
+    STRETCH_BEHAVIOUR: 'StretchBehaviour',
+    TEMPERATURE_BEHAVIOUR: 'TemperatureBehaviour',
+};
+export default behaviourNames;
+//# sourceMappingURL=BehaviourNames.js.map

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

@@ -0,0 +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;CAC9C,CAAA;AAED,eAAe,cAAc,CAAA"}

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

@@ -0,0 +1,86 @@
+import { Behaviour } from './index';
+import Particle from '../Particle';
+import Model from '../Model';
+export default class CollisionBehaviour extends Behaviour {
+    enabled: boolean;
+    skipPositionBehaviourOnCollision: boolean;
+    skipAngularVelocityBehaviourOnCollision: boolean;
+    skipColorBehaviourOnCollision: boolean;
+    skipAttractionRepulsionBehaviourOnCollision: boolean;
+    skipEmitDirectionBehaviourOnCollision: boolean;
+    skipRotationBehaviourOnCollision: boolean;
+    skipSizeBehaviourOnCollision: boolean;
+    priority: number;
+    distance: number;
+    lines: {
+        point1: {
+            x: number;
+            y: number;
+        };
+        point2: {
+            x: number;
+            y: number;
+        };
+    }[];
+    /**
+     * Function that initializes a particle
+     * @param {Particle} particle - The particle to be initialized
+     * @param {Model} model - The model of the particle
+     */
+    init: (particle: Particle, model: Model) => void;
+    /**
+     * Applies the particle's velocity and acceleration to move it and calculate its size, rotation, and position.
+     * @param {Particle} particle - The particle to be moved
+     * @param {number} deltaTime - The time delta for the movement calculation
+     * @param {Model} model - The model containing information about the particle's movement
+     */
+    apply: (particle: Particle, deltaTime: number, model: Model) => void;
+    reflectVelocity: (particle: Particle, normal: {
+        x: number;
+        y: number;
+    }) => void;
+    checkCollisionAndReflect: (particle: Particle) => boolean;
+    calculateNormal: (point1: {
+        x: number;
+        y: number;
+    }, point2: {
+        x: number;
+        y: number;
+    }) => {
+        x: number;
+        y: number;
+    };
+    pointToLineDistance: (x: number, y: number, x1: number, y1: number, x2: number, y2: number) => number;
+    /**
+     * Gets the name of the behaviour
+     * @return {BehaviourNames} The name of the behaviour
+     */
+    getName(): string;
+    /**
+     * @description Retrieves the properties of the object.
+     * @returns {Object} The properties of the object.
+     */
+    getProps(): {
+        enabled: boolean;
+        skipPositionBehaviourOnCollision: boolean;
+        skipAngularVelocityBehaviourOnCollision: boolean;
+        skipColorBehaviourOnCollision: boolean;
+        skipAttractionRepulsionBehaviourOnCollision: boolean;
+        skipEmitDirectionBehaviourOnCollision: boolean;
+        skipRotationBehaviourOnCollision: boolean;
+        skipSizeBehaviourOnCollision: boolean;
+        priority: number;
+        lines: {
+            point1: {
+                x: number;
+                y: number;
+            };
+            point2: {
+                x: number;
+                y: number;
+            };
+        }[];
+        distance: number;
+        name: string;
+    };
+}

package/dist/lib/behaviour/CollisionBehaviour.js

@@ -0,0 +1,140 @@
+import { Behaviour, BehaviourNames } from './index';
+export default class CollisionBehaviour extends Behaviour {
+    constructor() {
+        super(...arguments);
+        this.enabled = false;
+        this.skipPositionBehaviourOnCollision = false;
+        this.skipAngularVelocityBehaviourOnCollision = false;
+        this.skipColorBehaviourOnCollision = false;
+        this.skipAttractionRepulsionBehaviourOnCollision = false;
+        this.skipEmitDirectionBehaviourOnCollision = false;
+        this.skipRotationBehaviourOnCollision = false;
+        this.skipSizeBehaviourOnCollision = false;
+        this.priority = 10000;
+        this.distance = 10;
+        this.lines = [
+            { point1: { x: 0, y: 0 }, point2: { x: 0, y: 0 } },
+        ];
+        /**
+         * Function that initializes a particle
+         * @param {Particle} particle - The particle to be initialized
+         * @param {Model} model - The model of the particle
+         */
+        this.init = (particle, model) => {
+            // do nothing
+        };
+        /**
+         * Applies the particle's velocity and acceleration to move it and calculate its size, rotation, and position.
+         * @param {Particle} particle - The particle to be moved
+         * @param {number} deltaTime - The time delta for the movement calculation
+         * @param {Model} model - The model containing information about the particle's movement
+         */
+        this.apply = (particle, deltaTime, model) => {
+            if (!this.enabled)
+                return;
+            this.checkCollisionAndReflect(particle);
+        };
+        this.reflectVelocity = (particle, normal) => {
+            const dotProduct = particle.velocity.x * normal.x + particle.velocity.y * normal.y;
+            particle.velocity.x = particle.velocity.x - 2 * dotProduct * normal.x;
+            particle.velocity.y = particle.velocity.y - 2 * dotProduct * normal.y;
+            if (this.skipPositionBehaviourOnCollision) {
+                particle.skipPositionBehaviour = true;
+            }
+            if (this.skipAngularVelocityBehaviourOnCollision) {
+                particle.skipAngularVelocityBehaviour = true;
+            }
+            if (this.skipColorBehaviourOnCollision) {
+                particle.skipColorBehaviour = true;
+            }
+            if (this.skipAttractionRepulsionBehaviourOnCollision) {
+                particle.skipAttractionRepulsionBehaviour = true;
+            }
+            if (this.skipEmitDirectionBehaviourOnCollision) {
+                particle.skipEmitDirectionBehaviour = true;
+            }
+            if (this.skipRotationBehaviourOnCollision) {
+                particle.skipRotationBehaviour = true;
+            }
+            if (this.skipSizeBehaviourOnCollision) {
+                particle.skipSizeBehaviour = true;
+            }
+        };
+        this.checkCollisionAndReflect = (particle) => {
+            if (this.lines.length === 0)
+                return false; // No lines to check collision
+            for (const line of this.lines) {
+                const { point1, point2 } = line;
+                // Check if the particle is near the line segment (using point-line distance)
+                const dist = this.pointToLineDistance(particle.x, particle.y, point1.x, point1.y, point2.x, point2.y);
+                if (dist <= this.distance) {
+                    // Reflect velocity based on the line's normal
+                    const normal = this.calculateNormal(point1, point2);
+                    this.reflectVelocity(particle, normal);
+                    return true; // Stop further checks after first collision
+                }
+            }
+            return false;
+        };
+        this.calculateNormal = (point1, point2) => {
+            const dx = point2.x - point1.x;
+            const dy = point2.y - point1.y;
+            const length = Math.sqrt(dx * dx + dy * dy);
+            return { x: -dy / length, y: dx / length }; // Perpendicular vector (normalized)
+        };
+        this.pointToLineDistance = (x, y, x1, y1, x2, y2) => {
+            const A = x - x1;
+            const B = y - y1;
+            const C = x2 - x1;
+            const D = y2 - y1;
+            const dot = A * C + B * D;
+            const lenSq = C * C + D * D;
+            const param = lenSq !== 0 ? dot / lenSq : -1;
+            let xx;
+            let yy;
+            if (param < 0) {
+                xx = x1;
+                yy = y1;
+            }
+            else if (param > 1) {
+                xx = x2;
+                yy = y2;
+            }
+            else {
+                xx = x1 + param * C;
+                yy = y1 + param * D;
+            }
+            const dx = x - xx;
+            const dy = y - yy;
+            return Math.sqrt(dx * dx + dy * dy);
+        };
+    }
+    /**
+     * Gets the name of the behaviour
+     * @return {BehaviourNames} The name of the behaviour
+     */
+    getName() {
+        return BehaviourNames.COLLISION_BEHAVIOUR;
+    }
+    /**
+     * @description Retrieves the properties of the object.
+     * @returns {Object} The properties of the object.
+     */
+    getProps() {
+        return {
+            enabled: this.enabled,
+            skipPositionBehaviourOnCollision: this.skipPositionBehaviourOnCollision,
+            skipAngularVelocityBehaviourOnCollision: this.skipAngularVelocityBehaviourOnCollision,
+            skipColorBehaviourOnCollision: this.skipColorBehaviourOnCollision,
+            skipAttractionRepulsionBehaviourOnCollision: this.skipAttractionRepulsionBehaviourOnCollision,
+            skipEmitDirectionBehaviourOnCollision: this.skipEmitDirectionBehaviourOnCollision,
+            skipRotationBehaviourOnCollision: this.skipRotationBehaviourOnCollision,
+            skipSizeBehaviourOnCollision: this.skipSizeBehaviourOnCollision,
+            priority: this.priority,
+            lines: this.lines,
+            distance: this.distance,
+            name: this.getName(),
+        };
+    }
+}
+//# sourceMappingURL=CollisionBehaviour.js.map