@tsparticles/engine 4.0.0-alpha.25 → 4.0.0-alpha.27

package/types/Options/Interfaces/Particles/IStroke.d.ts

@@ -1,9 +1,9 @@
 import type { IAnimatableColor } from "../IAnimatableColor.js";
-import type { IColor } from "../../../Core/Interfaces/Colors.js";
+import type { IRangeColor } from "../../../Core/Interfaces/Colors.js";
 import type { RangeValue } from "../../../Types/RangeValue.js";
 import type { RecursivePartial } from "../../../Types/RecursivePartial.js";
 export interface IStroke {
-    color?: string | RecursivePartial<IAnimatableColor> | RecursivePartial<IColor>;
+    color?: RecursivePartial<IAnimatableColor> | RecursivePartial<IRangeColor>;
     opacity?: RangeValue;
     width: RangeValue;
 }

package/types/Options/Interfaces/Particles/Move/IMove.d.ts

@@ -1,7 +1,6 @@
 import type { MoveDirection, MoveDirectionAlt } from "../../../../Enums/Directions/MoveDirection.js";
 import type { IDistance } from "../../../../Core/Interfaces/IDistance.js";
 import type { IMoveAngle } from "./IMoveAngle.js";
-import type { IMoveAttract } from "./IMoveAttract.js";
 import type { IMoveCenter } from "./IMoveCenter.js";
 import type { IMoveGravity } from "./IMoveGravity.js";
 import type { IMovePath } from "./Path/IMovePath.js";
@@ -11,7 +10,6 @@ import type { OutMode } from "../../../../Enums/Modes/OutMode.js";
 import type { RangeValue } from "../../../../Types/RangeValue.js";
 export interface IMove {
     angle: number | IMoveAngle;
-    attract: IMoveAttract;
     center: IMoveCenter;
     decay: RangeValue;
     direction: MoveDirection | keyof typeof MoveDirection | MoveDirectionAlt | number;

package/types/Options/Interfaces/Particles/Shape/IShape.d.ts

@@ -2,7 +2,6 @@ import type { ShapeData } from "../../../../Types/ShapeData.js";
 import type { SingleOrMultiple } from "../../../../Types/SingleOrMultiple.js";
 export interface IShape {
     close: boolean;
-    fill: boolean;
     options: ShapeData;
     type: SingleOrMultiple<string>;
 }

package/types/Types/EngineInitializers.d.ts

@@ -1,19 +1,13 @@
 import type { Container } from "../Core/Container.js";
 import type { IEffectDrawer } from "../Core/Interfaces/IEffectDrawer.js";
-import type { IMovePathGenerator } from "../Core/Interfaces/IMovePathGenerator.js";
-import type { IParticleMover } from "../Core/Interfaces/IParticleMover.js";
 import type { IParticleUpdater } from "../Core/Interfaces/IParticleUpdater.js";
 import type { IShapeDrawer } from "../Core/Interfaces/IShapeDrawer.js";
 export type GenericInitializer<T> = (container: Container) => Promise<T>;
 export type EffectInitializer = GenericInitializer<IEffectDrawer>;
-export type MoverInitializer = GenericInitializer<IParticleMover>;
-export type PathGeneratorInitializer = GenericInitializer<IMovePathGenerator>;
 export type ShapeInitializer = GenericInitializer<IShapeDrawer>;
 export type UpdaterInitializer = GenericInitializer<IParticleUpdater>;
 export interface Initializers {
     effects: Map<string, EffectInitializer>;
-    movers: Map<string, MoverInitializer>;
-    pathGenerators: Map<string, PathGeneratorInitializer>;
     shapes: Map<string, ShapeInitializer>;
     updaters: Map<string, UpdaterInitializer>;
 }

package/types/Utils/CanvasUtils.d.ts

@@ -1,17 +1,16 @@
-import type { Container } from "../Core/Container.js";
+import type { IEffectDrawer, IShapeDrawData, IShapeDrawer } from "../export-types.js";
 import type { IContainerPlugin } from "../Core/Interfaces/IContainerPlugin.js";
 import type { IDelta } from "../Core/Interfaces/IDelta.js";
 import type { IDimension } from "../Core/Interfaces/IDimension.js";
 import type { IDrawParticleParams } from "../Core/Interfaces/IDrawParticleParams.js";
-import type { IShapeDrawData } from "../export-types.js";
 import type { Particle } from "../Core/Particle.js";
 export declare function paintBase(context: CanvasRenderingContext2D, dimension: IDimension, baseColor?: string): void;
 export declare function paintImage(context: CanvasRenderingContext2D, dimension: IDimension, image: HTMLImageElement | undefined, opacity: number): void;
 export declare function clear(context: CanvasRenderingContext2D, dimension: IDimension): void;
 export declare function drawParticle(data: IDrawParticleParams): void;
-export declare function drawAfterEffect(container: Container, data: IShapeDrawData): void;
-export declare function drawBeforeEffect(container: Container, data: IShapeDrawData): void;
-export declare function drawShape(container: Container, data: IShapeDrawData): void;
-export declare function drawShapeAfterDraw(container: Container, data: IShapeDrawData): void;
-export declare function drawShapeBeforeDraw(container: Container, data: IShapeDrawData): void;
+export declare function drawAfterEffect(drawer: IEffectDrawer | undefined, data: IShapeDrawData): void;
+export declare function drawBeforeEffect(drawer: IEffectDrawer | undefined, data: IShapeDrawData): void;
+export declare function drawShape(drawer: IShapeDrawer | undefined, data: IShapeDrawData): void;
+export declare function drawShapeAfterDraw(drawer: IShapeDrawer | undefined, data: IShapeDrawData): void;
+export declare function drawShapeBeforeDraw(drawer: IShapeDrawer | undefined, data: IShapeDrawData): void;
 export declare function drawParticlePlugin(context: CanvasRenderingContext2D, plugin: IContainerPlugin, particle: Particle, delta: IDelta): void;

package/types/Utils/ColorUtils.d.ts

@@ -6,7 +6,6 @@ import type { IDelta } from "../Core/Interfaces/IDelta.js";
 import type { IOptionsColor } from "../Options/Interfaces/IOptionsColor.js";
 import type { IParticleColorAnimation } from "../Core/Interfaces/IParticleValueAnimation.js";
 import type { IParticleHslAnimation } from "../Core/Interfaces/IParticleHslAnimation.js";
-import type { IRangeValue } from "../Core/Interfaces/IRangeValue.js";
 import type { Particle } from "../Core/Particle.js";
 export declare function rangeColorToRgb(engine: Engine, input?: string | IRangeColor, index?: number, useIndex?: boolean): IRgb | undefined;
 export declare function colorToRgb(engine: Engine, input?: string | IColor, index?: number, useIndex?: boolean): IRgb | undefined;
@@ -25,6 +24,6 @@ export declare function getLinkColor(p1: Particle, p2?: Particle, linkColor?: st
 export declare function getLinkRandomColor(engine: Engine, optColor: string | IOptionsColor, blink: boolean, consent: boolean): IRgb | string | undefined;
 export declare function getHslFromAnimation(animation?: IParticleHslAnimation): IHsl | undefined;
 export declare function getHslAnimationFromHsl(hsl: IHsl, animationOptions: HslAnimation | undefined, reduceFactor: number): IParticleHslAnimation;
-export declare function updateColorValue(data: IParticleColorAnimation, range: IRangeValue, decrease: boolean, delta: IDelta): void;
+export declare function updateColorValue(data: IParticleColorAnimation, decrease: boolean, delta: IDelta): void;
 export declare function updateColor(color: IParticleHslAnimation | undefined, delta: IDelta): void;
 export declare function alterHsl(color: IHsl, type: AlterType, value: number): IHsl;

package/types/Utils/MathUtils.d.ts

@@ -21,7 +21,9 @@ export declare function getDistances(pointA: ICoordinates, pointB: ICoordinates)
     dx: number;
     dy: number;
 };
+export declare function getDistanceSq(pointA: ICoordinates, pointB: ICoordinates): number;
 export declare function getDistance(pointA: ICoordinates, pointB: ICoordinates): number;
+export declare function checkDistance(pointA: ICoordinates, pointB: ICoordinates, distance: number): boolean;
 export declare function degToRad(degrees: number): number;
 export declare function getParticleDirectionAngle(direction: MoveDirection | keyof typeof MoveDirection | MoveDirectionAlt | number, position: ICoordinates, center: ICoordinates): number;
 export declare function getParticleBaseVelocity(direction: number): Vector;

package/types/Utils/Utils.d.ts

@@ -11,6 +11,12 @@ import { OutModeDirection } from "../Enums/Directions/OutModeDirection.js";
 import type { Particle } from "../Core/Particle.js";
 import type { RangedAnimationValueWithRandom } from "../Options/Classes/ValueWithRandom.js";
 import type { SingleOrMultiple } from "../Types/SingleOrMultiple.js";
+interface MemoizeOptions<TArgs> {
+    keyFn?: (args: TArgs) => string;
+    maxSize?: number;
+    ttlMs?: number;
+}
+export declare function memoize<TArgs extends unknown[], Result>(fn: (...args: TArgs) => Result, options?: MemoizeOptions<TArgs>): (...args: TArgs) => Result;
 export declare function hasMatchMedia(): boolean;
 export declare function safeDocument(): Document;
 export declare function safeMatchMedia(query: string): MediaQueryList | undefined;
@@ -37,3 +43,4 @@ export declare const getFullScreenStyle: (zIndex: number) => CSSStyleDeclaration
 export declare function manageListener(element: HTMLElement | Node | Window | MediaQueryList | typeof globalThis, event: string, handler: EventListenerOrEventListenerObject, add: boolean, options?: boolean | AddEventListenerOptions | EventListenerObject): void;
 export declare function getItemsFromInitializer<TItem, TInitializer extends GenericInitializer<TItem>>(container: Container, map: Map<Container, TItem[]>, initializers: Map<string, TInitializer>, force?: boolean): Promise<TItem[]>;
 export declare function getItemMapFromInitializer<TItem, TInitializer extends GenericInitializer<TItem>>(container: Container, map: Map<Container, Map<string, TItem>>, initializers: Map<string, TInitializer>, force?: boolean): Promise<Map<string, TItem>>;
+export {};

package/types/export-types.d.ts

@@ -11,11 +11,10 @@ export type * from "./Core/Interfaces/IDistance.js";
 export type * from "./Core/Interfaces/IDrawParticleParams.js";
 export type * from "./Core/Interfaces/IEffectDrawer.js";
 export type * from "./Core/Interfaces/ILoadParams.js";
-export type * from "./Core/Interfaces/IMovePathGenerator.js";
+export type * from "./Core/Interfaces/IPalette.js";
 export type * from "./Core/Interfaces/IParticleColorStyle.js";
 export type * from "./Core/Interfaces/IParticleHslAnimation.js";
 export type * from "./Core/Interfaces/IParticleLife.js";
-export type * from "./Core/Interfaces/IParticleMover.js";
 export type * from "./Core/Interfaces/IParticleRetinaProps.js";
 export type * from "./Core/Interfaces/IParticleRoll.js";
 export type * from "./Core/Interfaces/IParticleTransformValues.js";
@@ -43,8 +42,8 @@ export type * from "./Options/Interfaces/IValueWithRandom.js";
 export type * from "./Options/Interfaces/Particles/Bounce/IParticlesBounce.js";
 export type * from "./Options/Interfaces/Particles/Effect/IEffect.js";
 export type * from "./Options/Interfaces/Particles/IParticlesOptions.js";
+export type * from "./Options/Interfaces/Particles/IFill.js";
 export type * from "./Options/Interfaces/Particles/IStroke.js";
-export type * from "./Options/Interfaces/Particles/Move/IMoveAttract.js";
 export type * from "./Options/Interfaces/Particles/Move/IMove.js";
 export type * from "./Options/Interfaces/Particles/Move/IMoveAngle.js";
 export type * from "./Options/Interfaces/Particles/Move/IMoveCenter.js";
@@ -81,4 +80,3 @@ export type { Particle } from "./Core/Particle.js";
 export type { Particles } from "./Core/Particles.js";
 export type { Retina } from "./Core/Retina.js";
 export type { Engine } from "./Core/Engine.js";
-export type { IParticlesNumberLimit } from "./Options/Interfaces/Particles/Number/IParticlesNumberLimit.js";

package/types/exports.d.ts

@@ -27,8 +27,8 @@ export * from "./Options/Classes/OptionsColor.js";
 export * from "./Options/Classes/Particles/Bounce/ParticlesBounce.js";
 export * from "./Options/Classes/Particles/Bounce/ParticlesBounceFactor.js";
 export * from "./Options/Classes/Particles/ParticlesOptions.js";
+export * from "./Options/Classes/Particles/Fill.js";
 export * from "./Options/Classes/Particles/Stroke.js";
-export * from "./Options/Classes/Particles/Move/MoveAttract.js";
 export * from "./Options/Classes/Particles/Move/Move.js";
 export * from "./Options/Classes/Particles/Move/MoveAngle.js";
 export * from "./Options/Classes/Particles/Move/MoveCenter.js";

package/umd/Core/Canvas.js

@@ -175,14 +175,14 @@
             if (radius <= Constants_js_1.minimumSize) {
                 return;
             }
-            const pfColor = particle.getFillColor(), psColor = particle.getStrokeColor() ?? pfColor;
+            const pfColor = particle.getFillColor(), psColor = particle.getStrokeColor();
             let [fColor, sColor] = this._getPluginParticleColors(particle);
             fColor ??= pfColor;
             sColor ??= psColor;
             if (!fColor && !sColor) {
                 return;
             }
-            const container = this.container, zIndexOptions = particle.options.zIndex, zIndexFactor = Constants_js_1.zIndexFactorOffset - particle.zIndexFactor, { opacity, strokeOpacity } = particle.getOpacity(), transform = this._reusableTransform, colorStyles = this._reusableColorStyles, fill = fColor ? (0, ColorUtils_js_1.getStyleFromHsl)(fColor, container.hdr, opacity) : undefined, stroke = sColor ? (0, ColorUtils_js_1.getStyleFromHsl)(sColor, container.hdr, strokeOpacity) : fill;
+            const container = this.container, zIndexOptions = particle.options.zIndex, zIndexFactor = Constants_js_1.zIndexFactorOffset - particle.zIndexFactor, { fillOpacity, opacity, strokeOpacity } = particle.getOpacity(), transform = this._reusableTransform, colorStyles = this._reusableColorStyles, fill = fColor ? (0, ColorUtils_js_1.getStyleFromHsl)(fColor, container.hdr, fillOpacity * opacity) : undefined, stroke = sColor ? (0, ColorUtils_js_1.getStyleFromHsl)(sColor, container.hdr, strokeOpacity * opacity) : fill;
             transform.a = transform.b = transform.c = transform.d = undefined;
             colorStyles.fill = fill;
             colorStyles.stroke = stroke;
@@ -369,6 +369,9 @@
                 willReadFrequently: false,
             };
             this._context = this.element.getContext("2d", this._canvasSettings);
+            if (this._context) {
+                this._context.globalCompositeOperation = Constants_js_1.defaultCompositeValue;
+            }
             this._safeMutationObserver(obs => {
                 obs.disconnect();
             });
@@ -526,7 +529,7 @@
                 this._resetOriginalStyle();
             }
             for (const key in options.style) {
-                if (!key || !Object.hasOwn(options.style, key)) {
+                if (!key || !(key in options.style)) {
                     continue;
                 }
                 const value = options.style[key];

package/umd/Core/Engine.js

@@ -103,13 +103,10 @@ var __importStar = (this && this.__importStar) || (function () {
         effectDrawers = new Map();
         initializers = {
             effects: new Map(),
-            movers: new Map(),
-            pathGenerators: new Map(),
             shapes: new Map(),
             updaters: new Map(),
         };
-        movers = new Map();
-        pathGenerators = new Map();
+        palettes = new Map();
         plugins = [];
         presets = new Map();
         shapeDrawers = new Map();
@@ -133,7 +130,7 @@ var __importStar = (this && this.__importStar) || (function () {
             return this._domArray;
         }
         get version() {
-            return "4.0.0-alpha.25";
+            return "4.0.0-alpha.27";
         }
         addColorManager(name, manager) {
             this.colorManagers.set(name, manager);
@@ -155,15 +152,12 @@ var __importStar = (this && this.__importStar) || (function () {
         addEventListener(type, listener) {
             this._eventDispatcher.addEventListener(type, listener);
         }
-        addMover(name, moverInitializer) {
-            this.initializers.movers.set(name, moverInitializer);
+        addPalette(name, palette) {
+            this.palettes.set(name, palette);
         }
         addParticleUpdater(name, updaterInitializer) {
             this.initializers.updaters.set(name, updaterInitializer);
         }
-        addPathGenerator(name, generator) {
-            this.initializers.pathGenerators.set(name, generator);
-        }
         addPlugin(plugin) {
             if (this.getPlugin(plugin.id)) {
                 return;
@@ -189,7 +183,6 @@ var __importStar = (this && this.__importStar) || (function () {
         }
         clearPlugins(container) {
             this.effectDrawers.delete(container);
-            this.movers.delete(container);
             this.shapeDrawers.delete(container);
             this.updaters.delete(container);
         }
@@ -202,11 +195,8 @@ var __importStar = (this && this.__importStar) || (function () {
         getEffectDrawers(container, force = false) {
             return (0, Utils_js_1.getItemMapFromInitializer)(container, this.effectDrawers, this.initializers.effects, force);
         }
-        getMovers(container, force = false) {
-            return (0, Utils_js_1.getItemsFromInitializer)(container, this.movers, this.initializers.movers, force);
-        }
-        getPathGenerators(container, force = false) {
-            return (0, Utils_js_1.getItemMapFromInitializer)(container, this.pathGenerators, this.initializers.pathGenerators, force);
+        getPalette(name) {
+            return this.palettes.get(name);
         }
         getPlugin(plugin) {
             return this.plugins.find(t => t.id === plugin);

package/umd/Core/Particle.js

@@ -4,7 +4,7 @@
         if (v !== undefined) module.exports = v;
     }
     else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./Utils/Vectors.js", "../Utils/ColorUtils.js", "../Utils/MathUtils.js", "./Utils/Constants.js", "../Utils/Utils.js", "../Enums/Types/EventType.js", "../Enums/Directions/MoveDirection.js", "../Enums/Modes/OutMode.js", "../Enums/Types/ParticleOutType.js", "../Utils/OptionsUtils.js"], factory);
+        define(["require", "exports", "./Utils/Vectors.js", "../Utils/ColorUtils.js", "../Utils/MathUtils.js", "../Utils/Utils.js", "./Utils/Constants.js", "../Enums/Types/EventType.js", "../Enums/Directions/MoveDirection.js", "../Enums/Modes/OutMode.js", "../Enums/Types/ParticleOutType.js", "../Utils/OptionsUtils.js"], factory);
     }
 })(function (require, exports) {
     "use strict";
@@ -13,8 +13,8 @@
     const Vectors_js_1 = require("./Utils/Vectors.js");
     const ColorUtils_js_1 = require("../Utils/ColorUtils.js");
     const MathUtils_js_1 = require("../Utils/MathUtils.js");
-    const Constants_js_1 = require("./Utils/Constants.js");
     const Utils_js_1 = require("../Utils/Utils.js");
+    const Constants_js_1 = require("./Utils/Constants.js");
     const EventType_js_1 = require("../Enums/Types/EventType.js");
     const MoveDirection_js_1 = require("../Enums/Directions/MoveDirection.js");
     const OutMode_js_1 = require("../Enums/Modes/OutMode.js");
@@ -24,14 +24,12 @@
         const effectData = effectOptions.options[effect];
         return (0, Utils_js_1.deepExtend)({
             close: effectOptions.close,
-            fill: effectOptions.fill,
         }, (0, Utils_js_1.itemFromSingleOrMultiple)(effectData, id, reduceDuplicates));
     }
     function loadShapeData(shape, shapeOptions, id, reduceDuplicates) {
         const shapeData = shapeOptions.options[shape];
         return (0, Utils_js_1.deepExtend)({
             close: shapeOptions.close,
-            fill: shapeOptions.fill,
         }, (0, Utils_js_1.itemFromSingleOrMultiple)(shapeData, id, reduceDuplicates));
     }
     function fixOutMode(data) {
@@ -50,13 +48,14 @@
         container;
         backColor;
         bubble;
-        color;
         destroyed;
         direction;
         effect;
         effectClose;
         effectData;
-        effectFill;
+        fillColor;
+        fillEnabled;
+        fillOpacity;
         group;
         id;
         ignoresResizeRatio;
@@ -66,13 +65,10 @@
         lastPathTime;
         misplaced;
         moveCenter;
-        moveDecay;
         offset;
         opacity;
         options;
         outType;
-        pathDelay;
-        pathGenerator;
         pathRotation;
         position;
         randomIndexData;
@@ -82,7 +78,6 @@
         shape;
         shapeClose;
         shapeData;
-        shapeFill;
         sides;
         size;
         slow;
@@ -94,6 +89,7 @@
         velocity;
         zIndexFactor;
         _cachedOpacityData = {
+            fillOpacity: Constants_js_1.defaultOpacity,
             opacity: Constants_js_1.defaultOpacity,
             strokeOpacity: Constants_js_1.defaultOpacity,
         };
@@ -117,7 +113,7 @@
             this.destroyed = true;
             this.bubble.inRange = false;
             this.slow.inRange = false;
-            const container = this.container, pathGenerator = this.pathGenerator, shapeDrawer = this.shape ? container.particles.shapeDrawers.get(this.shape) : undefined;
+            const container = this.container, shapeDrawer = this.shape ? container.particles.shapeDrawers.get(this.shape) : undefined;
             shapeDrawer?.particleDestroy?.(this);
             for (const plugin of container.particleDestroyedPlugins) {
                 plugin.particleDestroyed?.(this, override);
@@ -125,7 +121,6 @@
             for (const updater of container.particles.updaters) {
                 updater.particleDestroyed?.(this, override);
             }
-            pathGenerator?.reset(this);
             this._engine.dispatchEvent(EventType_js_1.EventType.particleDestroyed, {
                 container: this.container,
                 data: {
@@ -142,15 +137,16 @@
             return this.rotation + (this.pathRotation ? this.velocity.angle : Constants_js_1.defaultAngle);
         }
         getFillColor() {
-            return this._getRollColor(this.bubble.color ?? (0, ColorUtils_js_1.getHslFromAnimation)(this.color));
+            return this._getRollColor(this.bubble.color ?? (0, ColorUtils_js_1.getHslFromAnimation)(this.fillColor));
         }
         getMass() {
             return this.getRadius() ** Constants_js_1.squareExp * Math.PI * Constants_js_1.half;
         }
         getOpacity() {
-            const zIndexOptions = this.options.zIndex, zIndexFactor = Constants_js_1.zIndexFactorOffset - this.zIndexFactor, zOpacityFactor = zIndexFactor ** zIndexOptions.opacityRate, opacity = this.bubble.opacity ?? (0, MathUtils_js_1.getRangeValue)(this.opacity?.value ?? Constants_js_1.defaultOpacity), strokeOpacity = this.strokeOpacity ?? opacity;
+            const zIndexOptions = this.options.zIndex, zIndexFactor = Constants_js_1.zIndexFactorOffset - this.zIndexFactor, zOpacityFactor = zIndexFactor ** zIndexOptions.opacityRate, opacity = this.bubble.opacity ?? (0, MathUtils_js_1.getRangeValue)(this.opacity?.value ?? Constants_js_1.defaultOpacity), fillOpacity = this.fillOpacity ?? Constants_js_1.defaultOpacity, strokeOpacity = this.strokeOpacity ?? Constants_js_1.defaultOpacity;
+            this._cachedOpacityData.fillOpacity = opacity * fillOpacity * zOpacityFactor;
             this._cachedOpacityData.opacity = opacity * zOpacityFactor;
-            this._cachedOpacityData.strokeOpacity = strokeOpacity * zOpacityFactor;
+            this._cachedOpacityData.strokeOpacity = opacity * strokeOpacity * zOpacityFactor;
             return this._cachedOpacityData;
         }
         getPosition() {
@@ -188,9 +184,7 @@
             this.id = id;
             this.group = group;
             this.effectClose = true;
-            this.effectFill = true;
             this.shapeClose = true;
-            this.shapeFill = true;
             this.pathRotation = false;
             this.lastPathTime = 0;
             this.destroyed = false;
@@ -242,24 +236,9 @@
             if (shapeData) {
                 particlesOptions.load(shapeData.particles);
             }
-            this.effectFill = effectData?.fill ?? particlesOptions.effect.fill;
             this.effectClose = effectData?.close ?? particlesOptions.effect.close;
-            this.shapeFill = shapeData?.fill ?? particlesOptions.shape.fill;
             this.shapeClose = shapeData?.close ?? particlesOptions.shape.close;
             this.options = particlesOptions;
-            const pathOptions = this.options.move.path;
-            this.pathDelay = (0, MathUtils_js_1.getRangeValue)(pathOptions.delay.value) * Constants_js_1.millisecondsToSeconds;
-            if (pathOptions.generator) {
-                let pathGenerator = this.container.particles.pathGenerators.get(pathOptions.generator);
-                if (!pathGenerator) {
-                    pathGenerator = this.container.particles.availablePathGenerators.get(pathOptions.generator);
-                    if (pathGenerator) {
-                        this.container.particles.pathGenerators.set(pathOptions.generator, pathGenerator);
-                        pathGenerator.init();
-                    }
-                }
-                this.pathGenerator = pathGenerator;
-            }
             container.retina.initParticle(this);
             this.size = (0, Utils_js_1.initParticleNumericAnimationValue)(this.options.size, pxRatio);
             this.bubble = {
@@ -272,7 +251,6 @@
             this._initPosition(position);
             this.initialVelocity = this._calculateVelocity();
             this.velocity = this.initialVelocity.copy();
-            this.moveDecay = Constants_js_1.decayOffset - (0, MathUtils_js_1.getRangeValue)(this.options.move.decay);
             const particles = container.particles;
             particles.setLastZIndex(this.position.z);
             this.zIndexFactor = this.position.z / container.zLayers;
@@ -298,9 +276,6 @@
             for (const updater of particles.updaters) {
                 updater.init(this);
             }
-            for (const mover of particles.movers) {
-                mover.init(this);
-            }
             effectDrawer?.particleInit?.(container, this);
             shapeDrawer?.particleInit?.(container, this);
             for (const plugin of container.particleCreatedPlugins) {

package/umd/Core/Particles.js

@@ -18,12 +18,9 @@
     const LogUtils_js_1 = require("../Utils/LogUtils.js");
     const OptionsUtils_js_1 = require("../Utils/OptionsUtils.js");
     class Particles {
-        availablePathGenerators;
         checkParticlePositionPlugins;
         effectDrawers;
         grid;
-        movers;
-        pathGenerators;
         shapeDrawers;
         updaters;
         _array;
@@ -57,9 +54,6 @@
             this._maxZIndex = 0;
             this.grid = new SpatialHashGrid_js_1.SpatialHashGrid(Constants_js_1.spatialHashGridCellSize);
             this.effectDrawers = new Map();
-            this.movers = [];
-            this.availablePathGenerators = new Map();
-            this.pathGenerators = new Map();
             this.shapeDrawers = new Map();
             this.updaters = [];
             this.checkParticlePositionPlugins = [];
@@ -135,9 +129,6 @@
             this._pool.length = 0;
             this._zArray = [];
             this.effectDrawers = new Map();
-            this.movers = [];
-            this.availablePathGenerators = new Map();
-            this.pathGenerators = new Map();
             this.shapeDrawers = new Map();
             this.updaters = [];
             this.checkParticlePositionPlugins = [];
@@ -229,14 +220,8 @@
         async initPlugins() {
             const container = this._container;
             this.effectDrawers = await this._engine.getEffectDrawers(container, true);
-            this.movers = await this._engine.getMovers(container, true);
-            this.availablePathGenerators = await this._engine.getPathGenerators(container, true);
-            this.pathGenerators = new Map();
             this.shapeDrawers = await this._engine.getShapeDrawers(container, true);
             this.updaters = await this._engine.getUpdaters(container, true);
-            for (const pathGenerator of this.pathGenerators.values()) {
-                pathGenerator.init();
-            }
         }
         push(nb, position, overrideOptions, group) {
             for (let i = 0; i < nb; i++) {
@@ -293,9 +278,6 @@
         update(delta) {
             const particlesToDelete = new Set();
             this.grid.clear();
-            for (const pathGenerator of this.pathGenerators.values()) {
-                pathGenerator.update();
-            }
             for (const plugin of this._updatePlugins) {
                 plugin.update?.(delta);
             }
@@ -317,11 +299,6 @@
                     }
                     plugin.particleUpdate?.(particle, delta);
                 }
-                for (const mover of this.movers) {
-                    if (mover.isEnabled(particle)) {
-                        mover.move(particle, delta);
-                    }
-                }
                 if (particle.destroyed) {
                     particlesToDelete.add(particle);
                     continue;

package/umd/Core/Utils/Constants.js

@@ -9,8 +9,8 @@
 })(function (require, exports) {
     "use strict";
     Object.defineProperty(exports, "__esModule", { value: true });
-    exports.defaultZoom = exports.defaultTime = exports.defaultLoops = exports.defaultVelocity = exports.defaultRgbMin = exports.phaseNumerator = exports.sNormalizedOffset = exports.sextuple = exports.triple = exports.lMin = exports.lFactor = exports.minStrokeWidth = exports.identity = exports.defaultAngle = exports.manualDefaultPosition = exports.touchDelay = exports.deleteCount = exports.defaultDensityFactor = exports.lengthOffset = exports.minIndex = exports.minCount = exports.countOffset = exports.minLimit = exports.sizeFactor = exports.posOffset = exports.defaultRadius = exports.minZ = exports.minRetries = exports.tryCountIncrement = exports.decayOffset = exports.none = exports.one = exports.loadMinIndex = exports.loadRandomFactor = exports.canvasFirstIndex = exports.minFpsLimit = exports.defaultFpsLimit = exports.removeMinIndex = exports.removeDeleteCount = exports.minCoordinate = exports.touchEndLengthOffset = exports.clickRadius = exports.defaultOpacity = exports.zIndexFactorOffset = exports.minimumLength = exports.minimumSize = exports.defaultTransformValue = exports.minVelocity = exports.threeQuarter = exports.quarter = exports.empty = exports.hPhase = exports.sMin = exports.hMin = exports.lMax = exports.sMax = exports.hMax = exports.rgbMax = exports.inverseFactorNumerator = exports.subdivideCount = exports.defaultReduceFactor = exports.defaultRatio = exports.defaultRemoveQuantity = exports.spatialHashGridCellSize = exports.qTreeCapacity = exports.squareExp = exports.defaultRetryCount = exports.canvasTag = exports.generatedFalse = exports.generatedTrue = exports.defaultAlpha = exports.defaultFps = exports.doublePI = exports.double = exports.midColorValue = exports.randomColorValue = exports.defaultTransform = exports.originPoint = exports.millisecondsToSeconds = exports.half = exports.percentDenominator = exports.visibilityChangeEvent = exports.resizeEvent = exports.generatedAttribute = void 0;
-    exports.generatedAttribute = "generated", exports.resizeEvent = "resize", exports.visibilityChangeEvent = "visibilitychange", exports.percentDenominator = 100, exports.half = 0.5, exports.millisecondsToSeconds = 1000, exports.originPoint = {
+    exports.defaultZoom = exports.defaultTime = exports.defaultLoops = exports.defaultVelocity = exports.defaultRgbMin = exports.phaseNumerator = exports.sNormalizedOffset = exports.sextuple = exports.triple = exports.lMin = exports.lFactor = exports.minStrokeWidth = exports.identity = exports.defaultAngle = exports.manualDefaultPosition = exports.touchDelay = exports.deleteCount = exports.defaultDensityFactor = exports.lengthOffset = exports.minIndex = exports.minCount = exports.countOffset = exports.minLimit = exports.sizeFactor = exports.posOffset = exports.defaultRadius = exports.minZ = exports.minRetries = exports.tryCountIncrement = exports.decayOffset = exports.none = exports.one = exports.loadMinIndex = exports.loadRandomFactor = exports.canvasFirstIndex = exports.minFpsLimit = exports.defaultFpsLimit = exports.removeMinIndex = exports.removeDeleteCount = exports.minCoordinate = exports.touchEndLengthOffset = exports.clickRadius = exports.defaultOpacity = exports.zIndexFactorOffset = exports.minimumLength = exports.minimumSize = exports.defaultTransformValue = exports.minVelocity = exports.threeQuarter = exports.quarter = exports.empty = exports.hPhase = exports.sMin = exports.hMin = exports.lMax = exports.sMax = exports.hMax = exports.rgbMax = exports.inverseFactorNumerator = exports.subdivideCount = exports.defaultReduceFactor = exports.defaultRatio = exports.defaultRemoveQuantity = exports.spatialHashGridCellSize = exports.qTreeCapacity = exports.squareExp = exports.defaultRetryCount = exports.canvasTag = exports.generatedFalse = exports.generatedTrue = exports.defaultAlpha = exports.defaultFps = exports.doublePI = exports.double = exports.midColorValue = exports.randomColorValue = exports.defaultTransform = exports.originPoint = exports.millisecondsToSeconds = exports.half = exports.percentDenominator = exports.visibilityChangeEvent = exports.resizeEvent = exports.defaultCompositeValue = exports.generatedAttribute = void 0;
+    exports.generatedAttribute = "generated", exports.defaultCompositeValue = "source-over", exports.resizeEvent = "resize", exports.visibilityChangeEvent = "visibilitychange", exports.percentDenominator = 100, exports.half = 0.5, exports.millisecondsToSeconds = 1000, exports.originPoint = {
         x: 0,
         y: 0,
         z: 0,

package/umd/Core/Utils/Ranges.js

@@ -32,7 +32,7 @@
             this.radius = radius;
         }
         contains(point) {
-            return (0, MathUtils_js_1.getDistance)(point, this.position) <= this.radius;
+            return (0, MathUtils_js_1.checkDistance)(point, this.position, this.radius);
         }
         intersects(range) {
             const pos1 = this.position, pos2 = range.position, distPos = { x: Math.abs(pos2.x - pos1.x), y: Math.abs(pos2.y - pos1.y) }, r = this.radius;

package/umd/Core/Utils/Vectors.js

@@ -11,6 +11,9 @@
     Object.defineProperty(exports, "__esModule", { value: true });
     exports.Vector = exports.Vector3d = void 0;
     const Constants_js_1 = require("./Constants.js");
+    function getZ(source) {
+        return "z" in source ? source.z : Constants_js_1.originPoint.z;
+    }
     class Vector3d {
         x;
         y;
@@ -36,21 +39,21 @@
             this._updateFromAngle(this.angle, length);
         }
         static clone(source) {
-            return Vector3d.create(source.x, source.y, source.z);
+            return Vector3d.create(source.x, source.y, getZ(source));
         }
         static create(x, y, z) {
             if (typeof x === "number") {
                 return new Vector3d(x, y ?? Constants_js_1.originPoint.y, z ?? Constants_js_1.originPoint.z);
             }
-            return new Vector3d(x.x, x.y, Object.hasOwn(x, "z") ? x.z : Constants_js_1.originPoint.z);
+            return new Vector3d(x.x, x.y, getZ(x));
         }
         add(v) {
-            return Vector3d.create(this.x + v.x, this.y + v.y, this.z + v.z);
+            return Vector3d.create(this.x + v.x, this.y + v.y, this.z + getZ(v));
         }
         addTo(v) {
             this.x += v.x;
             this.y += v.y;
-            this.z += v.z;
+            this.z += getZ(v);
         }
         copy() {
             return Vector3d.clone(this);
@@ -86,15 +89,15 @@
         setTo(c) {
             this.x = c.x;
             this.y = c.y;
-            this.z = "z" in c ? c.z : Constants_js_1.originPoint.z;
+            this.z = getZ(c);
         }
         sub(v) {
-            return Vector3d.create(this.x - v.x, this.y - v.y, this.z - v.z);
+            return Vector3d.create(this.x - v.x, this.y - v.y, this.z - getZ(v));
         }
         subFrom(v) {
             this.x -= v.x;
             this.y -= v.y;
-            this.z -= v.z;
+            this.z -= getZ(v);
         }
         _updateFromAngle(angle, length) {
             this.x = Math.cos(angle) * length;

package/umd/Options/Classes/ColorAnimation.js

@@ -14,9 +14,13 @@
     const TypeUtils_js_1 = require("../../Utils/TypeUtils.js");
     const MathUtils_js_1 = require("../../Utils/MathUtils.js");
     class ColorAnimation extends AnimationOptions_js_1.AnimationOptions {
+        max;
+        min;
         offset;
-        constructor() {
+        constructor(min, max) {
             super();
+            this.min = min;
+            this.max = max;
             this.offset = 0;
             this.sync = true;
         }
@@ -25,6 +29,12 @@
             if ((0, TypeUtils_js_1.isNull)(data)) {
                 return;
             }
+            if (data.max !== undefined) {
+                this.max = data.max;
+            }
+            if (data.min !== undefined) {
+                this.min = data.min;
+            }
             if (data.offset !== undefined) {
                 this.offset = (0, MathUtils_js_1.setRangeValue)(data.offset);
             }