@tsparticles/engine 3.9.1 → 4.0.0-alpha.1

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

@@ -3,7 +3,8 @@ import type { IShapeDrawData } from "./IShapeDrawData.js";
 import type { Particle } from "../Particle.js";
 export interface IEffectDrawer<TParticle extends Particle = Particle> {
     destroy?: (container: Container) => void;
-    draw: (data: IShapeDrawData<TParticle>) => void;
+    drawAfter?: (data: IShapeDrawData<TParticle>) => void;
+    drawBefore?: (data: IShapeDrawData<TParticle>) => void;
     init?: (container: Container) => Promise<void>;
     loadEffect?: (particle: TParticle) => void;
     particleInit?: (container: Container, particle: TParticle) => void;

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

@@ -3,10 +3,12 @@ import type { Particle } from "../Particle.js";
 export interface IShapeDrawData<TParticle extends Particle = Particle> {
     context: CanvasRenderingContext2D;
     delta: IDelta;
+    fill: boolean;
     opacity: number;
     particle: TParticle;
     pixelRatio: number;
     radius: number;
+    stroke: boolean;
     transformData: {
         a: number;
         b: number;

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

@@ -3,6 +3,7 @@ import type { IShapeDrawData } from "./IShapeDrawData.js";
 import type { Particle } from "../Particle.js";
 export interface IShapeDrawer<TParticle extends Particle = Particle> {
     afterDraw?: (data: IShapeDrawData<TParticle>) => void;
+    beforeDraw?: (data: IShapeDrawData<TParticle>) => void;
     destroy?: (container: Container) => void;
     draw: (data: IShapeDrawData<TParticle>) => void;
     getSidesCount?: (particle: TParticle) => number;

package/types/Core/Particle.d.ts

@@ -1,10 +1,10 @@
 import type { ICenterCoordinates, ICoordinates, ICoordinates3d } from "./Interfaces/ICoordinates.js";
-import type { IHsl, IRgb } from "./Interfaces/Colors.js";
 import { Vector, Vector3d } from "./Utils/Vectors.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 { IHsl } from "./Interfaces/Colors.js";
 import type { IMovePathGenerator } from "./Interfaces/IMovePathGenerator.js";
 import type { IParticleHslAnimation } from "./Interfaces/IParticleHslAnimation.js";
 import type { IParticleNumericValueAnimation } from "./Interfaces/IParticleValueAnimation.js";
@@ -24,7 +24,7 @@ export declare class Particle {
     color?: IParticleHslAnimation;
     destroyed: boolean;
     direction: number;
-    effect: string;
+    effect?: string;
     effectClose: boolean;
     effectData?: IShapeValues;
     effectFill: boolean;
@@ -51,8 +51,7 @@ export declare class Particle {
     retina: IParticleRetinaProps;
     roll?: IParticleRoll;
     rotation: number;
-    shadowColor?: IRgb;
-    shape: string;
+    shape?: string;
     shapeClose: boolean;
     shapeData?: IShapeValues;
     shapeFill: boolean;
@@ -70,6 +69,7 @@ export declare class Particle {
     constructor(engine: Engine, container: Container);
     destroy(override?: boolean): void;
     draw(delta: IDelta): void;
+    getAngle(): number;
     getFillColor(): IHsl | undefined;
     getMass(): number;
     getPosition(): ICoordinates3d;
@@ -81,7 +81,6 @@ export declare class Particle {
     reset(): void;
     private readonly _calcPosition;
     private readonly _calculateVelocity;
-    private readonly _checkOverlap;
     private readonly _getRollColor;
     private readonly _initPosition;
 }

package/types/Core/Particles.d.ts

@@ -33,7 +33,7 @@ export declare class Particles {
     addParticle(position?: ICoordinates, overrideOptions?: RecursivePartial<IParticlesOptions>, group?: string, initializer?: (particle: Particle) => boolean): Particle | undefined;
     clear(): void;
     destroy(): void;
-    draw(delta: IDelta): void;
+    drawParticles(delta: IDelta): void;
     filter(condition: (particle: Particle) => boolean): Particle[];
     find(condition: (particle: Particle) => boolean): Particle | undefined;
     get(index: number): Particle | undefined;

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

@@ -1,7 +1,7 @@
 import type { ICoordinates3d } from "../Interfaces/ICoordinates.js";
-export declare const generatedAttribute = "generated", mouseDownEvent = "pointerdown", mouseUpEvent = "pointerup", mouseLeaveEvent = "pointerleave", mouseOutEvent = "pointerout", mouseMoveEvent = "pointermove", touchStartEvent = "touchstart", touchEndEvent = "touchend", touchMoveEvent = "touchmove", touchCancelEvent = "touchcancel", resizeEvent = "resize", visibilityChangeEvent = "visibilitychange", errorPrefix = "tsParticles - Error", percentDenominator = 100, half = 0.5, millisecondsToSeconds = 1000, originPoint: ICoordinates3d, defaultTransform: {
+export declare const generatedAttribute = "generated", mouseDownEvent = "pointerdown", mouseUpEvent = "pointerup", mouseLeaveEvent = "pointerleave", mouseOutEvent = "pointerout", mouseMoveEvent = "pointermove", touchStartEvent = "touchstart", touchEndEvent = "touchend", touchMoveEvent = "touchmove", touchCancelEvent = "touchcancel", resizeEvent = "resize", visibilityChangeEvent = "visibilitychange", percentDenominator = 100, half = 0.5, millisecondsToSeconds = 1000, originPoint: ICoordinates3d, defaultTransform: {
     a: number;
     b: number;
     c: number;
     d: number;
-}, randomColorValue = "random", midColorValue = "mid", double = 2, doublePI: number, defaultFps = 60, defaultAlpha = 1, generatedTrue = "true", generatedFalse = "false", canvasTag = "canvas", defaultRetryCount = 0, squareExp = 2, qTreeCapacity = 4, defaultRemoveQuantity = 1, defaultRatio = 1, defaultReduceFactor = 1, subdivideCount = 4, inverseFactorNumerator = 1, rgbMax = 255, hMax = 360, sMax = 100, lMax = 100, hMin = 0, sMin = 0, hPhase = 60, empty = 0, quarter = 0.25, threeQuarter: number, minVelocity = 0, defaultTransformValue = 1, minimumSize = 0, minimumLength = 0, zIndexFactorOffset = 1, defaultOpacity = 1, clickRadius = 1, touchEndLengthOffset = 1, minCoordinate = 0, removeDeleteCount = 1, removeMinIndex = 0, defaultFpsLimit = 120, minFpsLimit = 0, canvasFirstIndex = 0, loadRandomFactor = 10000, loadMinIndex = 0, one = 1, none = 0, decayOffset = 1, tryCountIncrement = 1, minRetries = 0, rollFactor = 1, minZ = 0, defaultRadius = 0, posOffset: number, sizeFactor = 1.5, minLimit = 0, countOffset = 1, minCount = 0, minIndex = 0, manualCount = 0, lengthOffset = 1, defaultDensityFactor = 1, deleteCount = 1, touchDelay = 500, manualDefaultPosition = 50, defaultAngle = 0, identity = 1, minStrokeWidth = 0, lFactor = 1, lMin = 0, rgbFactor = 255, triple = 3, sextuple = 6, sNormalizedOffset = 1, phaseNumerator = 1, defaultRgbMin = 0, defaultVelocity = 0, defaultLoops = 0, defaultTime = 0;
+}, randomColorValue = "random", midColorValue = "mid", double = 2, doublePI: number, defaultFps = 60, defaultAlpha = 1, generatedTrue = "true", generatedFalse = "false", canvasTag = "canvas", defaultRetryCount = 0, squareExp = 2, qTreeCapacity = 4, defaultRemoveQuantity = 1, defaultRatio = 1, defaultReduceFactor = 1, subdivideCount = 4, inverseFactorNumerator = 1, rgbMax = 255, hMax = 360, sMax = 100, lMax = 100, hMin = 0, sMin = 0, hPhase = 60, empty = 0, quarter = 0.25, threeQuarter: number, minVelocity = 0, defaultTransformValue = 1, minimumSize = 0, minimumLength = 0, zIndexFactorOffset = 1, defaultOpacity = 1, clickRadius = 1, touchEndLengthOffset = 1, minCoordinate = 0, removeDeleteCount = 1, removeMinIndex = 0, defaultFpsLimit = 120, minFpsLimit = 0, canvasFirstIndex = 0, loadRandomFactor = 10000, loadMinIndex = 0, one = 1, none = 0, decayOffset = 1, tryCountIncrement = 1, minRetries = 0, rollFactor = 1, minZ = 0, defaultRadius = 0, posOffset: number, sizeFactor = 1.5, minLimit = 0, countOffset = 1, minCount = 0, minIndex = 0, manualCount = 0, lengthOffset = 1, defaultDensityFactor = 1, deleteCount = 1, touchDelay = 500, manualDefaultPosition = 50, defaultAngle = 0, identity = 1, minStrokeWidth = 0, lFactor = 1, lMin = 0, triple = 3, sextuple = 6, sNormalizedOffset = 1, phaseNumerator = 1, defaultRgbMin = 0, defaultVelocity = 0, defaultLoops = 0, defaultTime = 0;

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

@@ -3,6 +3,7 @@ export declare class EventListeners {
     private readonly container;
     private _canPush;
     private readonly _handlers;
+    private readonly _matchMedia;
     private _resizeObserver?;
     private _resizeTimeout?;
     private readonly _touches;

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

@@ -3,14 +3,14 @@ export declare class Vector3d implements ICoordinates3d {
     x: number;
     y: number;
     z: number;
-    protected constructor(xOrCoords: number | ICoordinates3d | ICoordinates, y?: number, z?: number);
+    protected constructor(x?: number, y?: number, z?: number);
     static get origin(): Vector3d;
     get angle(): number;
     set angle(angle: number);
     get length(): number;
     set length(length: number);
     static clone(source: Vector3d): Vector3d;
-    static create(x: number | ICoordinates3d, y?: number, z?: number): Vector3d;
+    static create(x: number | ICoordinates | ICoordinates3d, y?: number, z?: number): Vector3d;
     add(v: Vector3d): Vector3d;
     addTo(v: Vector3d): void;
     copy(): Vector3d;
@@ -29,7 +29,7 @@ export declare class Vector3d implements ICoordinates3d {
     private readonly _updateFromAngle;
 }
 export declare class Vector extends Vector3d {
-    protected constructor(xOrCoords: number | ICoordinates, y?: number);
+    protected constructor(x?: number, y?: number);
     static get origin(): Vector;
     static clone(source: Vector): Vector;
     static create(x: number | ICoordinates, y?: number): Vector;

package/types/Options/Classes/Options.d.ts

@@ -1,5 +1,4 @@
 import { Background } from "./Background/Background.js";
-import { BackgroundMask } from "./BackgroundMask/BackgroundMask.js";
 import type { Container } from "../../Core/Container.js";
 import type { Engine } from "../../Core/Engine.js";
 import { FullScreen } from "./FullScreen/FullScreen.js";
@@ -21,7 +20,6 @@ export declare class Options implements IOptions, IOptionLoader<IOptions> {
     [name: string]: unknown;
     autoPlay: boolean;
     readonly background: Background;
-    readonly backgroundMask: BackgroundMask;
     clear: boolean;
     defaultThemes: DefaultThemes;
     delay: RangeValue;
@@ -29,6 +27,7 @@ export declare class Options implements IOptions, IOptionLoader<IOptions> {
     duration: RangeValue;
     fpsLimit: number;
     readonly fullScreen: FullScreen;
+    hdr: boolean;
     readonly interactivity: Interactivity;
     key?: string;
     manualParticles: ManualParticle[];

package/types/Options/Classes/OptionsColor.d.ts

@@ -1,10 +1,10 @@
-import type { IRangeHsl, IRangeHsv, IRangeRgb, IRangeValueColor } from "../../Core/Interfaces/Colors.js";
+import type { IRangeHsl, IRangeHsv, IRangeHwb, IRangeLab, IRangeLch, IRangeOklab, IRangeOklch, IRangeRgb, IRangeValueColor } from "../../Core/Interfaces/Colors.js";
 import type { IOptionLoader } from "../Interfaces/IOptionLoader.js";
 import type { IOptionsColor } from "../Interfaces/IOptionsColor.js";
 import type { RecursivePartial } from "../../Types/RecursivePartial.js";
 import type { SingleOrMultiple } from "../../Types/SingleOrMultiple.js";
 export declare class OptionsColor implements IOptionsColor, IOptionLoader<IOptionsColor> {
-    value: SingleOrMultiple<SingleOrMultiple<string> | IRangeValueColor | IRangeRgb | IRangeHsl | IRangeHsv>;
+    value: SingleOrMultiple<SingleOrMultiple<string> | IRangeValueColor | IRangeRgb | IRangeHsl | IRangeHsv | IRangeHwb | IRangeLab | IRangeLch | IRangeOklab | IRangeOklch>;
     constructor();
     static create(source?: OptionsColor, data?: SingleOrMultiple<string> | RecursivePartial<IOptionsColor>): OptionsColor;
     load(data?: RecursivePartial<IOptionsColor>): void;

package/types/Options/Classes/Particles/Move/Move.d.ts

@@ -7,7 +7,6 @@ import { MoveAttract } from "./MoveAttract.js";
 import { MoveCenter } from "./MoveCenter.js";
 import { MoveGravity } from "./MoveGravity.js";
 import { MovePath } from "./Path/MovePath.js";
-import { MoveTrail } from "./MoveTrail.js";
 import { OutModes } from "./OutModes.js";
 import type { RangeValue } from "../../../../Types/RangeValue.js";
 import type { RecursivePartial } from "../../../../Types/RecursivePartial.js";
@@ -29,7 +28,6 @@ export declare class Move implements IMove, IOptionLoader<IMove> {
     speed: RangeValue;
     readonly spin: Spin;
     straight: boolean;
-    readonly trail: MoveTrail;
     vibrate: boolean;
     warp: boolean;
     constructor();

package/types/Options/Classes/Particles/ParticlesOptions.d.ts

@@ -1,5 +1,4 @@
 import { AnimatableColor } from "../AnimatableColor.js";
-import { Collisions } from "./Collisions/Collisions.js";
 import type { Container } from "../../../Core/Container.js";
 import { Effect } from "./Effect/Effect.js";
 import type { Engine } from "../../../Core/Engine.js";
@@ -12,7 +11,6 @@ import { ParticlesBounce } from "./Bounce/ParticlesBounce.js";
 import type { ParticlesGroups } from "../../../Types/ParticlesGroups.js";
 import { ParticlesNumber } from "./Number/ParticlesNumber.js";
 import type { RecursivePartial } from "../../../Types/RecursivePartial.js";
-import { Shadow } from "./Shadow.js";
 import { Shape } from "./Shape/Shape.js";
 import type { SingleOrMultiple } from "../../../Types/SingleOrMultiple.js";
 import { Size } from "./Size/Size.js";
@@ -21,7 +19,6 @@ import { ZIndex } from "./ZIndex/ZIndex.js";
 export declare class ParticlesOptions implements IParticlesOptions, IOptionLoader<IParticlesOptions> {
     [name: string]: unknown;
     readonly bounce: ParticlesBounce;
-    readonly collisions: Collisions;
     color: AnimatableColor;
     readonly effect: Effect;
     readonly groups: ParticlesGroups;
@@ -30,7 +27,6 @@ export declare class ParticlesOptions implements IParticlesOptions, IOptionLoade
     readonly number: ParticlesNumber;
     readonly opacity: Opacity;
     reduceDuplicates: boolean;
-    readonly shadow: Shadow;
     readonly shape: Shape;
     readonly size: Size;
     stroke: SingleOrMultiple<Stroke>;

package/types/Options/Interfaces/IOptions.d.ts

@@ -1,5 +1,4 @@
 import type { IBackground } from "./Background/IBackground.js";
-import type { IBackgroundMask } from "./BackgroundMask/IBackgroundMask.js";
 import type { IFullScreen } from "./FullScreen/IFullScreen.js";
 import type { IInteractivity } from "./Interactivity/IInteractivity.js";
 import type { IManualParticle } from "./IManualParticle.js";
@@ -13,13 +12,13 @@ export interface IOptions {
     [name: string]: unknown;
     autoPlay: boolean;
     background: IBackground;
-    backgroundMask: IBackgroundMask;
     clear: boolean;
     delay: RangeValue;
     detectRetina: boolean;
     duration: RangeValue;
     fpsLimit: number;
     fullScreen: RecursivePartial<IFullScreen> | boolean;
+    hdr: boolean;
     interactivity: IInteractivity;
     key?: string;
     manualParticles: IManualParticle[];

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

@@ -1,12 +1,10 @@
 import type { IAnimatableColor } from "../IAnimatableColor.js";
-import type { ICollisions } from "./Collisions/ICollisions.js";
 import type { IEffect } from "./Effect/IEffect.js";
 import type { IInteractivity } from "../Interactivity/IInteractivity.js";
 import type { IMove } from "./Move/IMove.js";
 import type { IOpacity } from "./Opacity/IOpacity.js";
 import type { IParticlesBounce } from "./Bounce/IParticlesBounce.js";
 import type { IParticlesNumber } from "./Number/IParticlesNumber.js";
-import type { IShadow } from "./IShadow.js";
 import type { IShape } from "./Shape/IShape.js";
 import type { ISize } from "./Size/ISize.js";
 import type { IStroke } from "./IStroke.js";
@@ -17,7 +15,6 @@ import type { SingleOrMultiple } from "../../../Types/SingleOrMultiple.js";
 export interface IParticlesOptions {
     [name: string]: unknown;
     bounce: IParticlesBounce;
-    collisions: ICollisions;
     color: IAnimatableColor;
     effect: IEffect;
     groups: ParticlesGroups;
@@ -26,7 +23,6 @@ export interface IParticlesOptions {
     number: IParticlesNumber;
     opacity: IOpacity;
     reduceDuplicates: boolean;
-    shadow: IShadow;
     shape: IShape;
     size: ISize;
     stroke: SingleOrMultiple<IStroke>;

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

@@ -5,7 +5,6 @@ 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";
-import type { IMoveTrail } from "./IMoveTrail.js";
 import type { IOutModes } from "./IOutModes.js";
 import type { ISpin } from "./ISpin.js";
 import type { OutMode } from "../../../../Enums/Modes/OutMode.js";
@@ -27,7 +26,6 @@ export interface IMove {
     speed: RangeValue;
     spin: ISpin;
     straight: boolean;
-    trail: IMoveTrail;
     vibrate: boolean;
     warp: boolean;
 }

package/types/Utils/CanvasUtils.d.ts

@@ -7,6 +7,7 @@ import type { IDimension } from "../Core/Interfaces/IDimension.js";
 import type { IDrawParticleParams } from "../Core/Interfaces/IDrawParticleParams.js";
 import type { IHsl } from "../Core/Interfaces/Colors.js";
 import type { Particle } from "../Core/Particle.js";
+export declare function clearDrawPlugin(context: CanvasRenderingContext2D, plugin: IContainerPlugin, delta: IDelta): void;
 export declare function drawLine(context: CanvasRenderingContext2D, begin: ICoordinates, end: ICoordinates): void;
 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;
@@ -27,9 +28,11 @@ interface DrawShapeData {
         d: number;
     };
 }
-export declare function drawEffect(data: DrawShapeData): void;
+export declare function drawAfterEffect(data: DrawShapeData): void;
+export declare function drawBeforeEffect(data: DrawShapeData): void;
 export declare function drawShape(data: DrawShapeData): void;
 export declare function drawShapeAfterDraw(data: DrawShapeData): void;
+export declare function drawShapeBeforeDraw(data: DrawShapeData): void;
 export declare function drawPlugin(context: CanvasRenderingContext2D, plugin: IContainerPlugin, delta: IDelta): void;
 export declare function drawParticlePlugin(context: CanvasRenderingContext2D, plugin: IContainerPlugin, particle: Particle, delta: IDelta): void;
 export declare function alterHsl(color: IHsl, type: AlterType, value: number): IHsl;

package/types/Utils/ColorUtils.d.ts

@@ -17,8 +17,8 @@ export declare function stringToRgb(engine: Engine, input: string): IRgb | undef
 export declare function hslToRgb(hsl: IHsl): IRgb;
 export declare function hslaToRgba(hsla: IHsla): IRgba;
 export declare function getRandomRgbColor(min?: number): IRgb;
-export declare function getStyleFromRgb(color: IRgb, opacity?: number): string;
-export declare function getStyleFromHsl(color: IHsl, opacity?: number): string;
+export declare function getStyleFromRgb(color: IRgb, hdr: boolean, opacity?: number): string;
+export declare function getStyleFromHsl(color: IHsl, hdr: boolean, opacity?: number): string;
 export declare function colorMix(color1: IRgb | IHsl, color2: IRgb | IHsl, size1: number, size2: number): IRgb;
 export declare function getLinkColor(p1: Particle, p2?: Particle, linkColor?: string | IRgb): IRgb | undefined;
 export declare function getLinkRandomColor(engine: Engine, optColor: string | IOptionsColor, blink: boolean, consent: boolean): IRgb | string | undefined;

package/types/Utils/LogUtils.d.ts

@@ -0,0 +1,11 @@
+interface ILogger {
+    debug(this: void, message?: unknown, ...optionalParams: unknown[]): void;
+    error(this: void, message?: unknown, ...optionalParams: unknown[]): void;
+    info(this: void, message?: unknown, ...optionalParams: unknown[]): void;
+    log(this: void, message?: unknown, ...optionalParams: unknown[]): void;
+    verbose(this: void, message?: unknown, ...optionalParams: unknown[]): void;
+    warning(this: void, message?: unknown, ...optionalParams: unknown[]): void;
+}
+export declare function setLogger(logger: ILogger): void;
+export declare function getLogger(): ILogger;
+export {};

package/types/Utils/{NumberUtils.d.ts → MathUtils.d.ts}

@@ -5,12 +5,13 @@ import type { RangeValue } from "../Types/RangeValue.js";
 import { Vector } from "../Core/Utils/Vectors.js";
 export declare function setRandom(rnd?: () => number): void;
 export declare function getRandom(): number;
+export declare function getRandomInRange(min: number, max: number): number;
 export declare function setAnimationFunctions(nextFrame: (callback: FrameRequestCallback) => number, cancel: (handle: number) => void): void;
 export declare function animate(fn: FrameRequestCallback): number;
 export declare function cancelAnimation(handle: number): void;
 export declare function clamp(num: number, min: number, max: number): number;
 export declare function mix(comp1: number, comp2: number, weight1: number, weight2: number): number;
-export declare function randomInRange(r: RangeValue): number;
+export declare function randomInRangeValue(r: RangeValue): number;
 export declare function getRangeValue(value: RangeValue): number;
 export declare function getRangeMin(value: RangeValue): number;
 export declare function getRangeMax(value: RangeValue): number;

package/types/Utils/TypeUtils.d.ts

@@ -1,7 +1,7 @@
 export declare function isBoolean(arg: unknown): arg is boolean;
 export declare function isString(arg: unknown): arg is string;
 export declare function isNumber(arg: unknown): arg is number;
-export declare function isFunction(arg: unknown): arg is Function;
-export declare function isObject<T extends object>(arg: unknown): arg is T;
+export declare function isFunction(arg: unknown): arg is (...args: unknown[]) => unknown;
+export declare function isObject(arg: unknown): arg is object;
 export declare function isArray<T>(arg: unknown): arg is T[];
 export declare function isNull(arg: unknown): arg is null | undefined;

package/types/Utils/Utils.d.ts

@@ -11,25 +11,15 @@ 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 ILogger {
-    debug(this: void, message?: unknown, ...optionalParams: unknown[]): void;
-    error(this: void, message?: unknown, ...optionalParams: unknown[]): void;
-    info(this: void, message?: unknown, ...optionalParams: unknown[]): void;
-    log(this: void, message?: unknown, ...optionalParams: unknown[]): void;
-    verbose(this: void, message?: unknown, ...optionalParams: unknown[]): void;
-    warning(this: void, message?: unknown, ...optionalParams: unknown[]): void;
-}
-export declare function setLogger(logger: ILogger): void;
-export declare function getLogger(): ILogger;
-export declare function isSsr(): boolean;
 export declare function hasMatchMedia(): boolean;
+export declare function safeDocument(): Document;
 export declare function safeMatchMedia(query: string): MediaQueryList | undefined;
 export declare function safeIntersectionObserver(callback: (records: IntersectionObserverEntry[]) => void): IntersectionObserver | undefined;
 export declare function safeMutationObserver(callback: (records: MutationRecord[]) => void): MutationObserver | undefined;
 export declare function isInArray<T>(value: T, array: SingleOrMultiple<T>): boolean;
 export declare function loadFont(font?: string, weight?: string): Promise<void>;
-export declare function arrayRandomIndex<T>(array: T[]): number;
-export declare function itemFromArray<T>(array: T[], index?: number, useIndex?: boolean): T;
+export declare function arrayRandomIndex(array: unknown[]): number;
+export declare function itemFromArray<T>(array: T[], index?: number, useIndex?: boolean): T | undefined;
 export declare function isPointInside(point: ICoordinates, size: IDimension, offset: ICoordinates, radius?: number, direction?: OutModeDirection): boolean;
 export declare function areBoundsInside(bounds: IBounds, size: IDimension, offset: ICoordinates, direction?: OutModeDirection): boolean;
 export declare function calculateBounds(point: ICoordinates, radius: number): IBounds;
@@ -40,9 +30,8 @@ export declare function singleDivModeExecute(div: DivEvent, callback: (selector:
 export declare function divMode<T extends IModeDiv>(divs?: SingleOrMultiple<T>, element?: HTMLElement): T | undefined;
 export declare function circleBounceDataFromParticle(p: Particle): ICircleBouncer;
 export declare function circleBounce(p1: ICircleBouncer, p2: ICircleBouncer): void;
-export declare function rectBounce(particle: Particle, divBounds: IBounds): void;
 export declare function executeOnSingleOrMultiple<T, U = void>(obj: SingleOrMultiple<T>, callback: (obj: T, index: number) => U): SingleOrMultiple<U>;
-export declare function itemFromSingleOrMultiple<T>(obj: SingleOrMultiple<T>, index?: number, useIndex?: boolean): T;
+export declare function itemFromSingleOrMultiple<T>(obj: SingleOrMultiple<T>, index?: number, useIndex?: boolean): T | undefined;
 export declare function findItemFromSingleOrMultiple<T>(obj: SingleOrMultiple<T>, callback: (obj: T, index: number) => boolean): T | undefined;
 export declare function initParticleNumericAnimationValue(options: RangedAnimationValueWithRandom, pxRatio: number): IParticleNumericValueAnimation;
 export declare function getPosition(position: ICoordinatesWithMode, canvasSize: IDimension): ICoordinates;
@@ -50,4 +39,3 @@ export declare function getSize(size: IDimensionWithMode, canvasSize: IDimension
 export declare function updateAnimation(particle: Particle, data: IParticleNumericValueAnimation, changeDirection: boolean, destroyType: DestroyType | keyof typeof DestroyType, delta: IDelta): void;
 export declare function cloneStyle(style: Partial<CSSStyleDeclaration>): CSSStyleDeclaration;
 export declare const getFullScreenStyle: (zIndex: number) => CSSStyleDeclaration;
-export {};