@tsparticles/engine 3.0.0-alpha.1 → 3.0.0-beta.1

package/types/Core/Engine.d.ts

@@ -0,0 +1,71 @@
+import type { ShapeDrawerAfterEffectFunction, ShapeDrawerDestroyFunction, ShapeDrawerDrawFunction, ShapeDrawerInitFunction } from "../Types/ShapeDrawerFunctions.js";
+import { Container } from "./Container.js";
+import type { CustomEventArgs } from "../Types/CustomEventArgs.js";
+import type { CustomEventListener } from "../Types/CustomEventListener.js";
+import type { IContainerPlugin } from "./Interfaces/IContainerPlugin.js";
+import type { IInteractor } from "./Interfaces/IInteractor.js";
+import type { ILoadParams } from "./Interfaces/ILoadParams.js";
+import type { IMovePathGenerator } from "./Interfaces/IMovePathGenerator.js";
+import type { IOptions } from "../Options/Interfaces/IOptions.js";
+import type { IParticleMover } from "./Interfaces/IParticleMover.js";
+import type { IParticleUpdater } from "./Interfaces/IParticleUpdater.js";
+import type { IParticlesOptions } from "../Options/Interfaces/Particles/IParticlesOptions.js";
+import type { IPlugin } from "./Interfaces/IPlugin.js";
+import type { IShapeDrawer } from "./Interfaces/IShapeDrawer.js";
+import type { ISourceOptions } from "../Types/ISourceOptions.js";
+import type { Options } from "../Options/Classes/Options.js";
+import type { Particle } from "./Particle.js";
+import type { ParticlesOptions } from "../Options/Classes/Particles/ParticlesOptions.js";
+import type { RecursivePartial } from "../Types/RecursivePartial.js";
+import type { SingleOrMultiple } from "../Types/SingleOrMultiple.js";
+declare global {
+    interface Window {
+        tsParticles: Engine;
+    }
+}
+export declare class Engine {
+    readonly drawers: Map<string, IShapeDrawer>;
+    readonly interactors: Map<Container, IInteractor[]>;
+    readonly movers: Map<Container, IParticleMover[]>;
+    readonly pathGenerators: Map<string, IMovePathGenerator>;
+    readonly plugins: IPlugin[];
+    readonly presets: Map<string, RecursivePartial<IOptions>>;
+    readonly updaters: Map<Container, IParticleUpdater[]>;
+    private readonly _configs;
+    private readonly _domArray;
+    private readonly _eventDispatcher;
+    private _initialized;
+    private readonly _initializers;
+    constructor();
+    get configs(): Record<string, ISourceOptions>;
+    get version(): string;
+    addConfig(nameOrConfig: string | ISourceOptions, config?: ISourceOptions): void;
+    addEventListener(type: string, listener: CustomEventListener): void;
+    addInteractor(name: string, interactorInitializer: (container: Container) => IInteractor, refresh?: boolean): Promise<void>;
+    addMover(name: string, moverInitializer: (container: Container) => IParticleMover, refresh?: boolean): Promise<void>;
+    addParticleUpdater(name: string, updaterInitializer: (container: Container) => IParticleUpdater, refresh?: boolean): Promise<void>;
+    addPathGenerator(name: string, generator: IMovePathGenerator, refresh?: boolean): Promise<void>;
+    addPlugin(plugin: IPlugin, refresh?: boolean): Promise<void>;
+    addPreset(preset: string, options: RecursivePartial<IOptions>, override?: boolean, refresh?: boolean): Promise<void>;
+    addShape(shape: SingleOrMultiple<string>, drawer: IShapeDrawer | ShapeDrawerDrawFunction, initOrRefresh?: ShapeDrawerInitFunction | boolean, afterEffectOrRefresh?: ShapeDrawerAfterEffectFunction | boolean, destroyOrRefresh?: ShapeDrawerDestroyFunction | boolean, refresh?: boolean): Promise<void>;
+    clearPlugins(container: Container): void;
+    dispatchEvent(type: string, args: CustomEventArgs): void;
+    dom(): Container[];
+    domItem(index: number): Container | undefined;
+    getAvailablePlugins(container: Container): Map<string, IContainerPlugin>;
+    getInteractors(container: Container, force?: boolean): IInteractor[];
+    getMovers(container: Container, force?: boolean): IParticleMover[];
+    getPathGenerator(type: string): IMovePathGenerator | undefined;
+    getPlugin(plugin: string): IPlugin | undefined;
+    getPreset(preset: string): ISourceOptions | undefined;
+    getShapeDrawer(type: string): IShapeDrawer | undefined;
+    getSupportedShapes(): IterableIterator<string>;
+    getUpdaters(container: Container, force?: boolean): IParticleUpdater[];
+    init(): void;
+    load(params: ILoadParams): Promise<Container | undefined>;
+    loadOptions(options: Options, sourceOptions: ISourceOptions): void;
+    loadParticlesOptions(container: Container, options: ParticlesOptions, ...sourceOptions: (RecursivePartial<IParticlesOptions> | undefined)[]): void;
+    refresh(refresh?: boolean): Promise<void>;
+    removeEventListener(type: string, listener: CustomEventListener): void;
+    setOnClickHandler(callback: (e: Event, particles?: Particle[]) => void): void;
+}

package/types/Core/Interfaces/Colors.d.ts

@@ -1,5 +1,5 @@
-import type { RangeValue } from "../../Types/RangeValue";
-import type { SingleOrMultiple } from "../../Types/SingleOrMultiple";
+import type { RangeValue } from "../../Types/RangeValue.js";
+import type { SingleOrMultiple } from "../../Types/SingleOrMultiple.js";
 export interface IAlphaColor {
     a: number;
 }

package/types/Core/Interfaces/IBubbleParticleData.d.ts

@@ -1,4 +1,4 @@
-import type { IHsl } from "./Colors";
+import type { IHsl } from "./Colors.js";
 export interface IBubbleParticleData {
     color?: IHsl;
     div?: HTMLElement;

package/types/Core/Interfaces/ICircleBouncer.d.ts

@@ -1,5 +1,5 @@
-import type { ICoordinates } from "./ICoordinates";
-import type { Vector } from "../Utils/Vector";
+import type { ICoordinates } from "./ICoordinates.js";
+import type { Vector } from "../Utils/Vector.js";
 export interface ICircleBouncer {
     factor: Vector;
     mass: number;

package/types/Core/Interfaces/IColorManager.d.ts

@@ -1,4 +1,4 @@
-import type { IColor, IRangeColor, IRgb, IRgba } from "./Colors";
+import type { IColor, IRangeColor, IRgb, IRgba } from "./Colors.js";
 export interface IColorManager {
     readonly key: string;
     readonly stringPrefix: string;

package/types/Core/Interfaces/IContainerInteractivity.d.ts

@@ -1,4 +1,4 @@
-import type { IMouseData } from "./IMouseData";
+import type { IMouseData } from "./IMouseData.js";
 export interface IContainerInteractivity {
     element?: HTMLElement | Window | Node | null;
     mouse: IMouseData;

package/types/Core/Interfaces/IContainerPlugin.d.ts

@@ -1,13 +1,15 @@
-import type { ClickMode } from "../../Enums/Modes/ClickMode";
-import type { ICoordinates } from "./ICoordinates";
-import type { IDelta } from "./IDelta";
-import type { IOptionsColor } from "../../Options/Interfaces/IOptionsColor";
-import type { OutModeDirection } from "../../Enums/Directions/OutModeDirection";
-import type { Particle } from "../Particle";
+import type { ClickMode } from "../../Enums/Modes/ClickMode.js";
+import type { ExportResult } from "../../Types/ExportResult.js";
+import type { ICoordinates } from "./ICoordinates.js";
+import type { IDelta } from "./IDelta.js";
+import type { IOptionsColor } from "../../Options/Interfaces/IOptionsColor.js";
+import type { OutModeDirection } from "../../Enums/Directions/OutModeDirection.js";
+import type { Particle } from "../Particle.js";
 export interface IContainerPlugin {
     clickPositionValid?: (position: ICoordinates) => boolean;
     draw?: (context: CanvasRenderingContext2D, delta: IDelta) => void;
     drawParticle?: (context: CanvasRenderingContext2D, particle: Particle, delta: IDelta) => void;
+    export?: (type: string, data: Record<string, unknown>) => Promise<ExportResult>;
     handleClickMode?: (mode: ClickMode | string) => void;
     init?: () => Promise<void>;
     particleBounce?: (particle: Particle, delta: IDelta, direction: OutModeDirection) => boolean;

package/types/Core/Interfaces/ICoordinates.d.ts

@@ -1,5 +1,5 @@
-import type { RangeValue } from "../../Types/RangeValue";
-import type { SizeMode } from "../../Enums/Modes/SizeMode";
+import type { PixelMode } from "../../Enums/Modes/PixelMode.js";
+import type { RangeValue } from "../../Types/RangeValue.js";
 export interface ICoordinates {
     x: number;
     y: number;
@@ -15,7 +15,7 @@ export interface IRangedCoordinates3d extends IRangedCoordinates {
     z: RangeValue;
 }
 export interface ICoordinatesWithMode extends ICoordinates {
-    mode: SizeMode;
+    mode: PixelMode | keyof typeof PixelMode;
 }
 export interface ICenterCoordinates extends ICoordinatesWithMode {
     radius: number;

package/types/Core/Interfaces/IDimension.d.ts

@@ -1,8 +1,8 @@
-import type { SizeMode } from "../../Enums/Modes/SizeMode";
+import type { PixelMode } from "../../Enums/Modes/PixelMode.js";
 export interface IDimension {
     height: number;
     width: number;
 }
 export interface IDimensionWithMode extends IDimension {
-    mode: SizeMode;
+    mode: PixelMode | keyof typeof PixelMode;
 }

package/types/Core/Interfaces/IDrawParticleParams.d.ts

@@ -1,9 +1,9 @@
-import type { Container } from "../Container";
-import type { IDelta } from "./IDelta";
-import type { IParticleColorStyle } from "./IParticleColorStyle";
-import type { IParticleTransformValues } from "./IParticleTransformValues";
-import type { IShadow } from "../../Options/Interfaces/Particles/IShadow";
-import type { Particle } from "../Particle";
+import type { Container } from "../Container.js";
+import type { IDelta } from "./IDelta.js";
+import type { IParticleColorStyle } from "./IParticleColorStyle.js";
+import type { IParticleTransformValues } from "./IParticleTransformValues.js";
+import type { IShadow } from "../../Options/Interfaces/Particles/IShadow.js";
+import type { Particle } from "../Particle.js";
 export interface IDrawParticleParams {
     backgroundMask: boolean;
     colorStyles: IParticleColorStyle;

package/types/Core/Interfaces/IExternalInteractor.d.ts

@@ -1,10 +1,10 @@
-import type { ClickMode } from "../../Enums/Modes/ClickMode";
-import type { IDelta } from "./IDelta";
-import type { IInteractor } from "./IInteractor";
-import type { IModes } from "../../Options/Interfaces/Interactivity/Modes/IModes";
-import type { Modes } from "../../Options/Classes/Interactivity/Modes/Modes";
-import type { Particle } from "../Particle";
-import type { RecursivePartial } from "../../Types/RecursivePartial";
+import type { ClickMode } from "../../Enums/Modes/ClickMode.js";
+import type { IDelta } from "./IDelta.js";
+import type { IInteractor } from "./IInteractor.js";
+import type { IModes } from "../../Options/Interfaces/Interactivity/Modes/IModes.js";
+import type { Modes } from "../../Options/Classes/Interactivity/Modes/Modes.js";
+import type { Particle } from "../Particle.js";
+import type { RecursivePartial } from "../../Types/RecursivePartial.js";
 export interface IExternalInteractor extends IInteractor {
     handleClickMode?: (mode: ClickMode | string) => void;
     loadModeOptions?: (options: Modes, ...sources: RecursivePartial<IModes | undefined>[]) => void;

package/types/Core/Interfaces/IInteractor.d.ts

@@ -1,11 +1,11 @@
-import type { IDelta } from "./IDelta";
-import type { IParticlesOptions } from "../../Options/Interfaces/Particles/IParticlesOptions";
-import type { ISourceOptions } from "../../Types/ISourceOptions";
-import type { InteractorType } from "../../Enums/Types/InteractorType";
-import type { Options } from "../../Options/Classes/Options";
-import type { Particle } from "../Particle";
-import type { ParticlesOptions } from "../../Options/Classes/Particles/ParticlesOptions";
-import type { RecursivePartial } from "../../Types/RecursivePartial";
+import type { IDelta } from "./IDelta.js";
+import type { IParticlesOptions } from "../../Options/Interfaces/Particles/IParticlesOptions.js";
+import type { ISourceOptions } from "../../Types/ISourceOptions.js";
+import type { InteractorType } from "../../Enums/Types/InteractorType.js";
+import type { Options } from "../../Options/Classes/Options.js";
+import type { Particle } from "../Particle.js";
+import type { ParticlesOptions } from "../../Options/Classes/Particles/ParticlesOptions.js";
+import type { RecursivePartial } from "../../Types/RecursivePartial.js";
 export interface IInteractor {
     loadOptions?: (options: Options, ...sources: (ISourceOptions | undefined)[]) => void;
     loadParticlesOptions?: (options: ParticlesOptions, ...sources: (RecursivePartial<IParticlesOptions> | undefined)[]) => void;

package/types/Core/Interfaces/ILoadParams.d.ts

@@ -1,5 +1,5 @@
-import type { ISourceOptions } from "../../Types/ISourceOptions";
-import type { SingleOrMultiple } from "../../Types/SingleOrMultiple";
+import type { ISourceOptions } from "../../Types/ISourceOptions.js";
+import type { SingleOrMultiple } from "../../Types/SingleOrMultiple.js";
 export interface ILoadParams {
     element?: HTMLElement;
     id?: string;

package/types/Core/Interfaces/IMouseData.d.ts

@@ -1,4 +1,4 @@
-import type { ICoordinates } from "./ICoordinates";
+import type { ICoordinates } from "./ICoordinates.js";
 export interface IMouseData {
     clickPosition?: ICoordinates;
     clickTime?: number;

package/types/Core/Interfaces/IMovePathGenerator.d.ts

@@ -1,8 +1,9 @@
-import type { Container } from "../Container";
-import type { Particle } from "../Particle";
-import type { Vector } from "../Utils/Vector";
+import type { Container } from "../Container.js";
+import type { IDelta } from "./IDelta.js";
+import type { Particle } from "../Particle.js";
+import type { Vector } from "../Utils/Vector.js";
 export interface IMovePathGenerator {
-    generate: (particle: Particle) => Vector;
+    generate: (particle: Particle, delta: IDelta) => Vector;
     init: (container: Container) => void;
     reset: (particle: Particle) => void;
     update: () => void;

package/types/Core/Interfaces/IParticle.d.ts

@@ -1,14 +1,14 @@
-import type { IHsl, IRgb } from "./Colors";
-import type { IBubbleParticleData } from "./IBubbleParticleData";
-import type { ICoordinates3d } from "./ICoordinates";
-import type { IParticleHslAnimation } from "./IParticleHslAnimation";
-import type { IParticleNumericValueAnimation } from "./IParticleValueAnimation";
-import type { IParticleRetinaProps } from "./IParticleRetinaProps";
-import type { IParticleRoll } from "./IParticleRoll";
-import type { IParticlesOptions } from "../../Options/Interfaces/Particles/IParticlesOptions";
-import type { IShapeValues } from "./IShapeValues";
-import type { Interactivity } from "../../Options/Classes/Interactivity/Interactivity";
-import type { Vector } from "../Utils/Vector";
+import type { IHsl, IRgb } from "./Colors.js";
+import type { IBubbleParticleData } from "./IBubbleParticleData.js";
+import type { ICoordinates3d } from "./ICoordinates.js";
+import type { IParticleHslAnimation } from "./IParticleHslAnimation.js";
+import type { IParticleNumericValueAnimation } from "./IParticleValueAnimation.js";
+import type { IParticleRetinaProps } from "./IParticleRetinaProps.js";
+import type { IParticleRoll } from "./IParticleRoll.js";
+import type { IParticlesOptions } from "../../Options/Interfaces/Particles/IParticlesOptions.js";
+import type { IShapeValues } from "./IShapeValues.js";
+import type { Interactivity } from "../../Options/Classes/Interactivity/Interactivity.js";
+import type { Vector } from "../Utils/Vector.js";
 export interface IParticle {
     readonly backColor?: IHsl;
     readonly bubble: IBubbleParticleData;

package/types/Core/Interfaces/IParticleHslAnimation.d.ts

@@ -1,4 +1,4 @@
-import type { IParticleValueAnimation } from "./IParticleValueAnimation";
+import type { IParticleValueAnimation } from "./IParticleValueAnimation.js";
 export interface IParticleHslAnimation {
     h: IParticleValueAnimation<number>;
     l: IParticleValueAnimation<number>;

package/types/Core/Interfaces/IParticleMover.d.ts

@@ -1,5 +1,5 @@
-import type { IDelta } from "./IDelta";
-import type { Particle } from "../Particle";
+import type { IDelta } from "./IDelta.js";
+import type { Particle } from "../Particle.js";
 export interface IParticleMover {
     init(particle: Particle): void;
     isEnabled(particle: Particle): boolean;

package/types/Core/Interfaces/IParticleRetinaProps.d.ts

@@ -1,4 +1,4 @@
-import type { IDistance } from "./IDistance";
+import type { IDistance } from "./IDistance.js";
 export interface IParticleRetinaProps {
     attractDistance?: number;
     maxDistance: Partial<IDistance>;

package/types/Core/Interfaces/IParticleRoll.d.ts

@@ -1,4 +1,4 @@
-import type { AlterType } from "../../Enums/Types/AlterType";
+import type { AlterType } from "../../Enums/Types/AlterType.js";
 export interface IParticleRoll {
     alter?: {
         type: AlterType;

package/types/Core/Interfaces/IParticleUpdater.d.ts

@@ -1,16 +1,14 @@
-import type { IDelta } from "./IDelta";
-import type { IParticleColorStyle } from "./IParticleColorStyle";
-import type { IParticleOverride } from "./IParticleOverride";
-import type { IParticleTransformValues } from "./IParticleTransformValues";
-import type { IParticlesOptions } from "../../Options/Interfaces/Particles/IParticlesOptions";
-import type { Particle } from "../Particle";
-import type { ParticlesOptions } from "../../Options/Classes/Particles/ParticlesOptions";
-import type { RecursivePartial } from "../../Types/RecursivePartial";
+import type { IDelta } from "./IDelta.js";
+import type { IParticleColorStyle } from "./IParticleColorStyle.js";
+import type { IParticleTransformValues } from "./IParticleTransformValues.js";
+import type { IParticlesOptions } from "../../Options/Interfaces/Particles/IParticlesOptions.js";
+import type { Particle } from "../Particle.js";
+import type { ParticlesOptions } from "../../Options/Classes/Particles/ParticlesOptions.js";
+import type { RecursivePartial } from "../../Types/RecursivePartial.js";
 export interface IParticleUpdater {
     afterDraw?: (particle: Particle) => void;
     beforeDraw?: (particle: Particle) => void;
     getColorStyles?: (particle: Particle, context: CanvasRenderingContext2D, radius: number, opacity: number) => IParticleColorStyle;
-    getOverrides?: (particle: Particle, context: CanvasRenderingContext2D, radius: number, opacity: number) => IParticleOverride;
     getTransformValues?: (particle: Particle) => IParticleTransformValues;
     loadOptions?: (options: ParticlesOptions, ...sources: (RecursivePartial<IParticlesOptions> | undefined)[]) => void;
     particleDestroyed?: (particle: Particle, override?: boolean) => void;

package/types/Core/Interfaces/IParticleValueAnimation.d.ts

@@ -1,11 +1,13 @@
-import type { AnimationStatus } from "../../Enums/AnimationStatus";
+import type { AnimationStatus } from "../../Enums/AnimationStatus.js";
 export interface IParticleValueAnimation<T> {
     decay?: number;
+    delayTime?: number;
     enable: boolean;
     initialValue?: number;
     loops?: number;
     maxLoops?: number;
     status?: AnimationStatus;
+    time?: number;
     value: T;
     velocity?: number;
 }

package/types/Core/Interfaces/IParticlesInteractor.d.ts

@@ -1,6 +1,6 @@
-import type { IDelta } from "./IDelta";
-import type { IInteractor } from "./IInteractor";
-import type { Particle } from "../Particle";
+import type { IDelta } from "./IDelta.js";
+import type { IInteractor } from "./IInteractor.js";
+import type { Particle } from "../Particle.js";
 export interface IParticlesInteractor extends IInteractor {
     interact(particle: Particle, delta: IDelta): Promise<void>;
     isEnabled(particle: Particle): boolean;

package/types/Core/Interfaces/IPlugin.d.ts

@@ -1,10 +1,11 @@
-import type { Container } from "../Container";
-import type { IContainerPlugin } from "./IContainerPlugin";
-import type { ISourceOptions } from "../../Types/ISourceOptions";
-import type { Options } from "../../Options/Classes/Options";
+import type { Container } from "../Container.js";
+import type { IContainerPlugin } from "./IContainerPlugin.js";
+import type { IOptions } from "../../Options/Interfaces/IOptions.js";
+import type { Options } from "../../Options/Classes/Options.js";
+import type { RecursivePartial } from "../../Types/RecursivePartial.js";
 export interface IPlugin {
     readonly id: string;
     getPlugin(container: Container): IContainerPlugin;
-    loadOptions(options: Options, source?: ISourceOptions): void;
-    needsPlugin(options?: ISourceOptions): boolean;
+    loadOptions(options: Options, source?: RecursivePartial<IOptions>): void;
+    needsPlugin(options?: RecursivePartial<IOptions>): boolean;
 }

package/types/Core/Interfaces/IPositionFromSizeParams.d.ts

@@ -1,5 +1,5 @@
-import type { ICoordinates, IRangedCoordinates } from "./ICoordinates";
-import type { IDimension } from "./IDimension";
+import type { ICoordinates, IRangedCoordinates } from "./ICoordinates.js";
+import type { IDimension } from "./IDimension.js";
 export interface IPositionFromSizeParams {
     position?: Partial<ICoordinates>;
     size: IDimension;

package/types/Core/Interfaces/IShapeDrawer.d.ts

@@ -1,4 +1,4 @@
-import type { ShapeDrawerAfterEffectFunction, ShapeDrawerDestroyFunction, ShapeDrawerDrawFunction, ShapeDrawerInitFunction, ShapeDrawerLoadFunction, ShapeDrawerParticleInitFunction, ShapeDrawerSidesCountFunction } from "../../Types/ShapeDrawerFunctions";
+import type { ShapeDrawerAfterEffectFunction, ShapeDrawerDestroyFunction, ShapeDrawerDrawFunction, ShapeDrawerInitFunction, ShapeDrawerLoadFunction, ShapeDrawerParticleInitFunction, ShapeDrawerSidesCountFunction } from "../../Types/ShapeDrawerFunctions.js";
 export interface IShapeDrawer {
     afterEffect?: ShapeDrawerAfterEffectFunction;
     destroy?: ShapeDrawerDestroyFunction;

package/types/Core/Interfaces/IShapeValues.d.ts

@@ -1,5 +1,5 @@
-import type { IParticlesOptions } from "../../Options/Interfaces/Particles/IParticlesOptions";
-import type { RecursivePartial } from "../../Types/RecursivePartial";
+import type { IParticlesOptions } from "../../Options/Interfaces/Particles/IParticlesOptions.js";
+import type { RecursivePartial } from "../../Types/RecursivePartial.js";
 export interface IShapeValues {
     [key: string]: unknown;
     close?: boolean;

package/types/Core/Interfaces/ITrailFillData.d.ts

@@ -1,4 +1,4 @@
-import type { IRgb } from "./Colors";
+import type { IRgb } from "./Colors.js";
 export interface ITrailFillData {
     color?: IRgb;
     image?: HTMLImageElement;

package/types/Core/Particle.d.ts

@@ -1,24 +1,24 @@
-import type { ICenterCoordinates, ICoordinates, ICoordinates3d } from "./Interfaces/ICoordinates";
-import type { IHsl, IRgb } from "./Interfaces/Colors";
-import type { Container } from "./Container";
-import type { Engine } from "../engine";
-import type { IBubbleParticleData } from "./Interfaces/IBubbleParticleData";
-import type { IDelta } from "./Interfaces/IDelta";
-import type { IMovePathGenerator } from "./Interfaces/IMovePathGenerator";
-import type { IParticle } from "./Interfaces/IParticle";
-import type { IParticleHslAnimation } from "./Interfaces/IParticleHslAnimation";
-import type { IParticleNumericValueAnimation } from "./Interfaces/IParticleValueAnimation";
-import type { IParticleRetinaProps } from "./Interfaces/IParticleRetinaProps";
-import type { IParticleRoll } from "./Interfaces/IParticleRoll";
-import type { IParticlesOptions } from "../Options/Interfaces/Particles/IParticlesOptions";
-import type { IShapeValues } from "./Interfaces/IShapeValues";
-import type { ISlowParticleData } from "./Interfaces/ISlowParticleData";
-import { Interactivity } from "../Options/Classes/Interactivity/Interactivity";
-import { ParticleOutType } from "../Enums/Types/ParticleOutType";
-import type { ParticlesOptions } from "../Options/Classes/Particles/ParticlesOptions";
-import type { RecursivePartial } from "../Types/RecursivePartial";
-import { Vector } from "./Utils/Vector";
-import { Vector3d } from "./Utils/Vector3d";
+import type { ICenterCoordinates, ICoordinates, ICoordinates3d } from "./Interfaces/ICoordinates.js";
+import type { IHsl, IRgb } from "./Interfaces/Colors.js";
+import type { Container } from "./Container.js";
+import type { Engine } from "./Engine.js";
+import type { IBubbleParticleData } from "./Interfaces/IBubbleParticleData.js";
+import type { IDelta } from "./Interfaces/IDelta.js";
+import type { IMovePathGenerator } from "./Interfaces/IMovePathGenerator.js";
+import type { IParticle } from "./Interfaces/IParticle.js";
+import type { IParticleHslAnimation } from "./Interfaces/IParticleHslAnimation.js";
+import type { IParticleNumericValueAnimation } from "./Interfaces/IParticleValueAnimation.js";
+import type { IParticleRetinaProps } from "./Interfaces/IParticleRetinaProps.js";
+import type { IParticleRoll } from "./Interfaces/IParticleRoll.js";
+import type { IParticlesOptions } from "../Options/Interfaces/Particles/IParticlesOptions.js";
+import type { IShapeValues } from "./Interfaces/IShapeValues.js";
+import type { ISlowParticleData } from "./Interfaces/ISlowParticleData.js";
+import { Interactivity } from "../Options/Classes/Interactivity/Interactivity.js";
+import { ParticleOutType } from "../Enums/Types/ParticleOutType.js";
+import type { ParticlesOptions } from "../Options/Classes/Particles/ParticlesOptions.js";
+import type { RecursivePartial } from "../Types/RecursivePartial.js";
+import { Vector } from "./Utils/Vector.js";
+import { Vector3d } from "./Utils/Vector3d.js";
 export declare class Particle implements IParticle {
     readonly container: Container;
     backColor?: IHsl;
@@ -76,10 +76,10 @@ export declare class Particle implements IParticle {
     isInsideCanvas(): boolean;
     isVisible(): boolean;
     reset(): void;
-    private _calcPosition;
-    private _calculateVelocity;
-    private _checkOverlap;
-    private _getRollColor;
-    private _initPosition;
-    private _loadShapeData;
+    private readonly _calcPosition;
+    private readonly _calculateVelocity;
+    private readonly _checkOverlap;
+    private readonly _getRollColor;
+    private readonly _initPosition;
+    private readonly _loadShapeData;
 }

package/types/Core/Particles.d.ts

@@ -1,28 +1,28 @@
-import type { ClickMode } from "../Enums/Modes/ClickMode";
-import type { Container } from "./Container";
-import type { Engine } from "../engine";
-import type { ICoordinates } from "./Interfaces/ICoordinates";
-import type { IDelta } from "./Interfaces/IDelta";
-import type { IMouseData } from "./Interfaces/IMouseData";
-import type { IParticlesOptions } from "../Options/Interfaces/Particles/IParticlesOptions";
-import { Particle } from "./Particle";
-import { QuadTree } from "./Utils/QuadTree";
-import type { RecursivePartial } from "../Types/RecursivePartial";
+import type { ClickMode } from "../Enums/Modes/ClickMode.js";
+import type { Container } from "./Container.js";
+import type { Engine } from "./Engine.js";
+import type { ICoordinates } from "./Interfaces/ICoordinates.js";
+import type { IDelta } from "./Interfaces/IDelta.js";
+import type { IMouseData } from "./Interfaces/IMouseData.js";
+import type { IParticlesOptions } from "../Options/Interfaces/Particles/IParticlesOptions.js";
+import { Particle } from "./Particle.js";
+import { QuadTree } from "./Utils/QuadTree.js";
+import type { RecursivePartial } from "../Types/RecursivePartial.js";
 export declare class Particles {
-    private readonly container;
-    array: Particle[];
     lastZIndex: number;
     limit: number;
-    movers: import("./Interfaces/IParticleMover").IParticleMover[];
+    movers: import("./Interfaces/IParticleMover.js").IParticleMover[];
     needsSort: boolean;
     pool: Particle[];
     pushing?: boolean;
     quadTree: QuadTree;
-    updaters: import("..").IParticleUpdater[];
-    zArray: Particle[];
+    updaters: import("./Interfaces/IParticleUpdater.js").IParticleUpdater[];
+    private _array;
+    private readonly _container;
     private readonly _engine;
-    private readonly interactionManager;
-    private nextId;
+    private readonly _interactionManager;
+    private _nextId;
+    private _zArray;
     constructor(engine: Engine, container: Container);
     get count(): number;
     addManualParticles(): void;
@@ -30,6 +30,9 @@ export declare class Particles {
     clear(): void;
     destroy(): void;
     draw(delta: IDelta): Promise<void>;
+    filter(condition: (particle: Particle) => boolean): Particle[];
+    find(condition: (particle: Particle) => boolean): Particle | undefined;
+    get(index: number): Particle | undefined;
     handleClickMode(mode: ClickMode | string): void;
     init(): void;
     push(nb: number, mouse?: IMouseData, overrideOptions?: RecursivePartial<IParticlesOptions>, group?: string): void;
@@ -39,8 +42,8 @@ export declare class Particles {
     removeQuantity(quantity: number, group?: string): void;
     setDensity(): void;
     update(delta: IDelta): Promise<void>;
-    private _applyDensity;
-    private _initDensityFactor;
-    private _pushParticle;
-    private _removeParticle;
+    private readonly _applyDensity;
+    private readonly _initDensityFactor;
+    private readonly _pushParticle;
+    private readonly _removeParticle;
 }

package/types/Core/Retina.d.ts

@@ -1,5 +1,5 @@
-import type { Container } from "./Container";
-import type { Particle } from "./Particle";
+import type { Container } from "./Container.js";
+import type { Particle } from "./Particle.js";
 export declare class Retina {
     private readonly container;
     attractDistance: number;

package/types/Core/Utils/Circle.d.ts

@@ -1,5 +1,5 @@
-import type { ICoordinates } from "../Interfaces/ICoordinates";
-import { Range } from "./Range";
+import type { ICoordinates } from "../Interfaces/ICoordinates.js";
+import { Range } from "./Range.js";
 export declare class Circle extends Range {
     readonly radius: number;
     constructor(x: number, y: number, radius: number);

package/types/Core/Utils/Constants.d.ts

@@ -1,12 +1,13 @@
 export declare const generatedAttribute = "generated";
-export declare const touchEndEvent = "touchend";
 export declare const mouseDownEvent = "pointerdown";
 export declare const mouseUpEvent = "pointerup";
+export declare const mouseLeaveEvent = "pointerleave";
+export declare const mouseOutEvent = "pointerout";
 export declare const mouseMoveEvent = "pointermove";
 export declare const touchStartEvent = "touchstart";
+export declare const touchEndEvent = "touchend";
 export declare const touchMoveEvent = "touchmove";
-export declare const mouseLeaveEvent = "pointerleave";
-export declare const mouseOutEvent = "pointerout";
 export declare const touchCancelEvent = "touchcancel";
 export declare const resizeEvent = "resize";
 export declare const visibilityChangeEvent = "visibilitychange";
+export declare const errorPrefix = "tsParticles - Error";