tsparticles 1.42.3 → 1.43.1

package/Utils/Utils.js

@@ -1,269 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.rectBounce = exports.circleBounce = exports.circleBounceDataFromParticle = exports.divMode = exports.singleDivModeExecute = exports.divModeExecute = exports.isDivModeEnabled = exports.deepExtend = exports.calculateBounds = exports.areBoundsInside = exports.isPointInside = exports.itemFromArray = exports.arrayRandomIndex = exports.loadFont = exports.isInArray = exports.cancelAnimation = exports.animate = exports.isSsr = void 0;
-const NumberUtils_1 = require("./NumberUtils");
-const Core_1 = require("../Core");
-function rectSideBounce(pSide, pOtherSide, rectSide, rectOtherSide, velocity, factor) {
-    const res = { bounced: false };
-    if (pOtherSide.min >= rectOtherSide.min &&
-        pOtherSide.min <= rectOtherSide.max &&
-        pOtherSide.max >= rectOtherSide.min &&
-        pOtherSide.max <= rectOtherSide.max) {
-        if ((pSide.max >= rectSide.min && pSide.max <= (rectSide.max + rectSide.min) / 2 && velocity > 0) ||
-            (pSide.min <= rectSide.max && pSide.min > (rectSide.max + rectSide.min) / 2 && velocity < 0)) {
-            res.velocity = velocity * -factor;
-            res.bounced = true;
-        }
-    }
-    return res;
-}
-function checkSelector(element, selectors) {
-    if (selectors instanceof Array) {
-        for (const selector of selectors) {
-            if (element.matches(selector)) {
-                return true;
-            }
-        }
-        return false;
-    }
-    else {
-        return element.matches(selectors);
-    }
-}
-function isSsr() {
-    return typeof window === "undefined" || !window || typeof window.document === "undefined" || !window.document;
-}
-exports.isSsr = isSsr;
-function animate() {
-    return isSsr()
-        ? (callback) => setTimeout(callback)
-        : (callback) => (window.requestAnimationFrame ||
-            window.webkitRequestAnimationFrame ||
-            window.mozRequestAnimationFrame ||
-            window.oRequestAnimationFrame ||
-            window.msRequestAnimationFrame ||
-            window.setTimeout)(callback);
-}
-exports.animate = animate;
-function cancelAnimation() {
-    return isSsr()
-        ? (handle) => clearTimeout(handle)
-        : (handle) => (window.cancelAnimationFrame ||
-            window.webkitCancelRequestAnimationFrame ||
-            window.mozCancelRequestAnimationFrame ||
-            window.oCancelRequestAnimationFrame ||
-            window.msCancelRequestAnimationFrame ||
-            window.clearTimeout)(handle);
-}
-exports.cancelAnimation = cancelAnimation;
-function isInArray(value, array) {
-    return value === array || (array instanceof Array && array.indexOf(value) > -1);
-}
-exports.isInArray = isInArray;
-async function loadFont(character) {
-    var _a, _b;
-    try {
-        await document.fonts.load(`${(_a = character.weight) !== null && _a !== void 0 ? _a : "400"} 36px '${(_b = character.font) !== null && _b !== void 0 ? _b : "Verdana"}'`);
-    }
-    catch (_c) {
-    }
-}
-exports.loadFont = loadFont;
-function arrayRandomIndex(array) {
-    return Math.floor(Math.random() * array.length);
-}
-exports.arrayRandomIndex = arrayRandomIndex;
-function itemFromArray(array, index, useIndex = true) {
-    const fixedIndex = index !== undefined && useIndex ? index % array.length : arrayRandomIndex(array);
-    return array[fixedIndex];
-}
-exports.itemFromArray = itemFromArray;
-function isPointInside(point, size, radius, direction) {
-    return areBoundsInside(calculateBounds(point, radius !== null && radius !== void 0 ? radius : 0), size, direction);
-}
-exports.isPointInside = isPointInside;
-function areBoundsInside(bounds, size, direction) {
-    let inside = true;
-    if (!direction || direction === "bottom") {
-        inside = bounds.top < size.height;
-    }
-    if (inside && (!direction || direction === "left")) {
-        inside = bounds.right > 0;
-    }
-    if (inside && (!direction || direction === "right")) {
-        inside = bounds.left < size.width;
-    }
-    if (inside && (!direction || direction === "top")) {
-        inside = bounds.bottom > 0;
-    }
-    return inside;
-}
-exports.areBoundsInside = areBoundsInside;
-function calculateBounds(point, radius) {
-    return {
-        bottom: point.y + radius,
-        left: point.x - radius,
-        right: point.x + radius,
-        top: point.y - radius,
-    };
-}
-exports.calculateBounds = calculateBounds;
-function deepExtend(destination, ...sources) {
-    for (const source of sources) {
-        if (source === undefined || source === null) {
-            continue;
-        }
-        if (typeof source !== "object") {
-            destination = source;
-            continue;
-        }
-        const sourceIsArray = Array.isArray(source);
-        if (sourceIsArray && (typeof destination !== "object" || !destination || !Array.isArray(destination))) {
-            destination = [];
-        }
-        else if (!sourceIsArray && (typeof destination !== "object" || !destination || Array.isArray(destination))) {
-            destination = {};
-        }
-        for (const key in source) {
-            if (key === "__proto__") {
-                continue;
-            }
-            const sourceDict = source;
-            const value = sourceDict[key];
-            const isObject = typeof value === "object";
-            const destDict = destination;
-            destDict[key] =
-                isObject && Array.isArray(value)
-                    ? value.map((v) => deepExtend(destDict[key], v))
-                    : deepExtend(destDict[key], value);
-        }
-    }
-    return destination;
-}
-exports.deepExtend = deepExtend;
-function isDivModeEnabled(mode, divs) {
-    return divs instanceof Array ? !!divs.find((t) => t.enable && isInArray(mode, t.mode)) : isInArray(mode, divs.mode);
-}
-exports.isDivModeEnabled = isDivModeEnabled;
-function divModeExecute(mode, divs, callback) {
-    if (divs instanceof Array) {
-        for (const div of divs) {
-            const divMode = div.mode;
-            const divEnabled = div.enable;
-            if (divEnabled && isInArray(mode, divMode)) {
-                singleDivModeExecute(div, callback);
-            }
-        }
-    }
-    else {
-        const divMode = divs.mode;
-        const divEnabled = divs.enable;
-        if (divEnabled && isInArray(mode, divMode)) {
-            singleDivModeExecute(divs, callback);
-        }
-    }
-}
-exports.divModeExecute = divModeExecute;
-function singleDivModeExecute(div, callback) {
-    const selectors = div.selectors;
-    if (selectors instanceof Array) {
-        for (const selector of selectors) {
-            callback(selector, div);
-        }
-    }
-    else {
-        callback(selectors, div);
-    }
-}
-exports.singleDivModeExecute = singleDivModeExecute;
-function divMode(divs, element) {
-    if (!element || !divs) {
-        return;
-    }
-    if (divs instanceof Array) {
-        return divs.find((d) => checkSelector(element, d.selectors));
-    }
-    else if (checkSelector(element, divs.selectors)) {
-        return divs;
-    }
-}
-exports.divMode = divMode;
-function circleBounceDataFromParticle(p) {
-    return {
-        position: p.getPosition(),
-        radius: p.getRadius(),
-        mass: p.getMass(),
-        velocity: p.velocity,
-        factor: Core_1.Vector.create((0, NumberUtils_1.getValue)(p.options.bounce.horizontal), (0, NumberUtils_1.getValue)(p.options.bounce.vertical)),
-    };
-}
-exports.circleBounceDataFromParticle = circleBounceDataFromParticle;
-function circleBounce(p1, p2) {
-    const { x: xVelocityDiff, y: yVelocityDiff } = p1.velocity.sub(p2.velocity);
-    const [pos1, pos2] = [p1.position, p2.position];
-    const { dx: xDist, dy: yDist } = (0, NumberUtils_1.getDistances)(pos2, pos1);
-    if (xVelocityDiff * xDist + yVelocityDiff * yDist >= 0) {
-        const angle = -Math.atan2(yDist, xDist);
-        const m1 = p1.mass;
-        const m2 = p2.mass;
-        const u1 = p1.velocity.rotate(angle);
-        const u2 = p2.velocity.rotate(angle);
-        const v1 = (0, NumberUtils_1.collisionVelocity)(u1, u2, m1, m2);
-        const v2 = (0, NumberUtils_1.collisionVelocity)(u2, u1, m1, m2);
-        const vFinal1 = v1.rotate(-angle);
-        const vFinal2 = v2.rotate(-angle);
-        p1.velocity.x = vFinal1.x * p1.factor.x;
-        p1.velocity.y = vFinal1.y * p1.factor.y;
-        p2.velocity.x = vFinal2.x * p2.factor.x;
-        p2.velocity.y = vFinal2.y * p2.factor.y;
-    }
-}
-exports.circleBounce = circleBounce;
-function rectBounce(particle, divBounds) {
-    const pPos = particle.getPosition();
-    const size = particle.getRadius();
-    const bounds = calculateBounds(pPos, size);
-    const resH = rectSideBounce({
-        min: bounds.left,
-        max: bounds.right,
-    }, {
-        min: bounds.top,
-        max: bounds.bottom,
-    }, {
-        min: divBounds.left,
-        max: divBounds.right,
-    }, {
-        min: divBounds.top,
-        max: divBounds.bottom,
-    }, particle.velocity.x, (0, NumberUtils_1.getValue)(particle.options.bounce.horizontal));
-    if (resH.bounced) {
-        if (resH.velocity !== undefined) {
-            particle.velocity.x = resH.velocity;
-        }
-        if (resH.position !== undefined) {
-            particle.position.x = resH.position;
-        }
-    }
-    const resV = rectSideBounce({
-        min: bounds.top,
-        max: bounds.bottom,
-    }, {
-        min: bounds.left,
-        max: bounds.right,
-    }, {
-        min: divBounds.top,
-        max: divBounds.bottom,
-    }, {
-        min: divBounds.left,
-        max: divBounds.right,
-    }, particle.velocity.y, (0, NumberUtils_1.getValue)(particle.options.bounce.vertical));
-    if (resV.bounced) {
-        if (resV.velocity !== undefined) {
-            particle.velocity.y = resV.velocity;
-        }
-        if (resV.position !== undefined) {
-            particle.position.y = resV.position;
-        }
-    }
-}
-exports.rectBounce = rectBounce;

package/Utils/index.d.ts

@@ -1,4 +0,0 @@
-export * from "./CanvasUtils";
-export * from "./ColorUtils";
-export * from "./NumberUtils";
-export * from "./Utils";

package/Utils/index.js

@@ -1,16 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./CanvasUtils"), exports);
-__exportStar(require("./ColorUtils"), exports);
-__exportStar(require("./NumberUtils"), exports);
-__exportStar(require("./Utils"), exports);

package/browser/Core/Canvas.d.ts

@@ -1,64 +0,0 @@
-import type { IContainerPlugin, ICoordinates, IDelta, IDimension, IParticle, IRgb } from "./Interfaces";
-import type { Container } from "./Container";
-import type { Particle } from "./Particle";
-/**
- * Canvas manager
- * @category Core
- */
-export declare class Canvas {
-    private readonly container;
-    /**
-     * The particles canvas
-     */
-    element?: HTMLCanvasElement;
-    /**
-     * The particles canvas dimension
-     */
-    readonly size: IDimension;
-    resizeFactor?: IDimension;
-    /**
-     * The particles canvas context
-     */
-    private context;
-    private generatedCanvas;
-    private coverColorStyle?;
-    private trailFillColor?;
-    private originalStyle?;
-    /**
-     * Constructor of canvas manager
-     * @param container the parent container
-     */
-    constructor(container: Container);
-    /**
-     * Initializes the canvas element
-     */
-    init(): void;
-    loadCanvas(canvas: HTMLCanvasElement): void;
-    destroy(): void;
-    /**
-     * Paints the canvas background
-     */
-    paint(): void;
-    /**
-     * Clears the canvas content
-     */
-    clear(): void;
-    windowResize(): Promise<void>;
-    /**
-     * Calculates the size of the canvas
-     */
-    resize(): void;
-    drawConnectLine(p1: IParticle, p2: IParticle): void;
-    drawGrabLine(particle: IParticle, lineColor: IRgb, opacity: number, mousePos: ICoordinates): void;
-    drawParticle(particle: Particle, delta: IDelta): void;
-    drawPlugin(plugin: IContainerPlugin, delta: IDelta): void;
-    drawParticlePlugin(plugin: IContainerPlugin, particle: Particle, delta: IDelta): void;
-    initBackground(): void;
-    draw<T>(cb: (context: CanvasRenderingContext2D) => T): T | undefined;
-    private initCover;
-    private initTrail;
-    private getPluginParticleColors;
-    private initStyle;
-    private paintBase;
-    private lineStyle;
-}

package/browser/Core/Container.d.ts

@@ -1,163 +0,0 @@
-/**
- * [[include:Container.md]]
- * @packageDocumentation
- */
-import { FrameManager, Vector } from "./Utils";
-import type { IAttract, IBubble, IContainerInteractivity, IContainerPlugin, IMovePathGenerator, IRepulse, IShapeDrawer } from "./Interfaces";
-import { Canvas } from "./Canvas";
-import type { Engine } from "../engine";
-import type { IOptions } from "../Options/Interfaces/IOptions";
-import { Options } from "../Options/Classes/Options";
-import { Particle } from "./Particle";
-import { Particles } from "./Particles";
-import type { RecursivePartial } from "../Types";
-import { Retina } from "./Retina";
-/**
- * The object loaded into an HTML element, it'll contain options loaded and all data to let everything working
- * [[include:Container.md]]
- * @category Core
- */
-export declare class Container {
-    #private;
-    readonly id: string;
-    /**
-     * Check if the particles container is started
-     */
-    started: boolean;
-    /**
-     * Check if the particles container is destroyed, if so it's not recommended using it
-     */
-    destroyed: boolean;
-    density: number;
-    duration: number;
-    pageHidden: boolean;
-    lastFrameTime?: number;
-    lifeTime: number;
-    fpsLimit: number;
-    interactivity: IContainerInteractivity;
-    bubble: IBubble;
-    repulse: IRepulse;
-    attract: IAttract;
-    zLayers: number;
-    responsiveMaxWidth?: number;
-    /**
-     * The options used by the container, it's a full [[Options]] object
-     */
-    get options(): Options;
-    get sourceOptions(): RecursivePartial<IOptions> | undefined;
-    /**
-     * The options loaded by the container, it's a full [[Options]] object
-     */
-    actualOptions: Options;
-    readonly retina: Retina;
-    readonly canvas: Canvas;
-    /**
-     * The particles manager
-     */
-    readonly particles: Particles;
-    readonly drawer: FrameManager;
-    /**
-     * All the shape drawers used by the container
-     */
-    readonly drawers: Map<string, IShapeDrawer>;
-    /**
-     * All the plugins used by the container
-     */
-    readonly plugins: Map<string, IContainerPlugin>;
-    pathGenerator: IMovePathGenerator;
-    private _options;
-    private _sourceOptions;
-    private readonly _initialSourceOptions;
-    private paused;
-    private firstStart;
-    private currentTheme?;
-    private drawAnimationFrame?;
-    private readonly presets;
-    private readonly eventListeners;
-    private readonly intersectionObserver?;
-    /**
-     * This is the core class, create an instance to have a new working particles manager
-     * @constructor
-     * @param engine the engine used by container
-     * @param id the id to identify this instance
-     * @param sourceOptions the options to load
-     * @param presets all the presets to load with options
-     */
-    constructor(engine: Engine, id: string, sourceOptions?: RecursivePartial<IOptions>, ...presets: string[]);
-    /**
-     * Starts animations and resume from pause
-     * @param force
-     */
-    play(force?: boolean): void;
-    /**
-     * Pauses animations
-     */
-    pause(): void;
-    /**
-     * Draws a frame
-     */
-    draw(force: boolean): void;
-    /**
-     * Gets the animation status
-     * @returns `true` is playing, `false` is paused
-     */
-    getAnimationStatus(): boolean;
-    /**
-     * Customise path generation
-     * @deprecated Use the new setPath
-     * @param noiseOrGenerator the [[IMovePathGenerator]] object or a function that generates a [[Vector]] object from [[Particle]]
-     * @param init the [[IMovePathGenerator]] init function, if the first parameter is a generator function
-     * @param update the [[IMovePathGenerator]] update function, if the first parameter is a generator function
-     */
-    setNoise(noiseOrGenerator?: IMovePathGenerator | ((particle: Particle) => Vector), init?: () => void, update?: () => void): void;
-    /**
-     * Customise path generation
-     * @param pathOrGenerator the [[IMovePathGenerator]] object or a function that generates a [[Vector]] object from [[Particle]]
-     * @param init the [[IMovePathGenerator]] init function, if the first parameter is a generator function
-     * @param update the [[IMovePathGenerator]] update function, if the first parameter is a generator function
-     */
-    setPath(pathOrGenerator?: IMovePathGenerator | ((particle: Particle) => Vector), init?: () => void, update?: () => void): void;
-    /**
-     * Destroys the current container, invalidating it
-     */
-    destroy(): void;
-    /**
-     * @deprecated this method is deprecated, please use the exportImage method
-     * @param callback The callback to handle the image
-     */
-    exportImg(callback: BlobCallback): void;
-    /**
-     * Exports the current canvas image, `background` property of `options` won't be rendered because it's css related
-     * @param callback The callback to handle the image
-     * @param type The exported image type
-     * @param quality The exported image quality
-     */
-    exportImage(callback: BlobCallback, type?: string, quality?: number): void;
-    /**
-     * Exports the current configuration using `options` property
-     * @returns a JSON string created from `options` property
-     */
-    exportConfiguration(): string;
-    /**
-     * Restarts the container, just a [[stop]]/[[start]] alias
-     */
-    refresh(): Promise<void>;
-    reset(): Promise<void>;
-    /**
-     * Stops the container, opposite to `start`. Clears some resources and stops events.
-     */
-    stop(): void;
-    /**
-     * Loads the given theme, overriding the options
-     * @param name the theme name, if `undefined` resets the default options or the default theme
-     */
-    loadTheme(name?: string): Promise<void>;
-    /**
-     * Starts the container, initializes what are needed to create animations and event handling
-     */
-    start(): Promise<void>;
-    addClickHandler(callback: (evt: Event, particles?: Particle[]) => void): void;
-    updateActualOptions(): boolean;
-    init(): Promise<void>;
-    private intersectionManager;
-}

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

@@ -1,56 +0,0 @@
-import type { SingleOrMultiple } from "../../Types";
-export interface IAlphaColor {
-    a: number;
-}
-/**
- * Color
- * [[include:Color.md]]
- * @category Interfaces
- */
-export interface IColor {
-    /**
-     * Color value, can be a single or an array of [[IValueColor]], [[IRgb]], [[IHsl]] or string
-     */
-    value: SingleOrMultiple<IValueColor | IRgb | IHsl | IHsv | SingleOrMultiple<string>>;
-}
-/**
- * @category Interfaces
- */
-export interface IHsl {
-    h: number;
-    s: number;
-    l: number;
-}
-/**
- * @category Interfaces
- */
-export interface IHsla extends IHsl, IAlphaColor {
-}
-export interface IHsv {
-    h: number;
-    s: number;
-    v: number;
-}
-export interface IHsva extends IHsv, IAlphaColor {
-}
-/**
- * @category Interfaces
- */
-export interface IRgb {
-    r: number;
-    g: number;
-    b: number;
-}
-/**
- * @category Interfaces
- */
-export interface IRgba extends IRgb, IAlphaColor {
-}
-/**
- * @category Interfaces
- */
-export interface IValueColor {
-    rgb?: IRgb;
-    hsl?: IHsl;
-    hsv?: IHsv;
-}

package/browser/Core/Interfaces/Gradients.d.ts

@@ -1,21 +0,0 @@
-import type { GradientType, RotateDirectionAlt } from "../../Enums";
-import type { IColor } from "./Colors";
-import type { RangeValue } from "../../Types";
-import type { RotateDirection } from "../../Enums";
-export interface IGradientColorOpacity {
-    value: RangeValue;
-}
-export interface IGradientColor {
-    value: IColor;
-    stop: number;
-    opacity?: IGradientColorOpacity | number;
-}
-export interface IGradientAngle {
-    value: number;
-    direction: RotateDirection | keyof typeof RotateDirection | RotateDirectionAlt;
-}
-export interface IGradient {
-    angle?: IGradientAngle;
-    type: GradientType;
-    colors: IGradientColor[];
-}

package/browser/Core/Interfaces/IAttract.d.ts

@@ -1,10 +0,0 @@
-import type { IParticle } from "./IParticle";
-/**
- * @category Interfaces
- */
-export interface IAttract {
-    particles: IParticle[];
-    finish?: boolean;
-    count?: number;
-    clicking?: boolean;
-}

package/browser/Core/Interfaces/IBounds.d.ts

@@ -1,9 +0,0 @@
-/**
- * @category Interfaces
- */
-export interface IBounds {
-    bottom: number;
-    left: number;
-    right: number;
-    top: number;
-}

package/browser/Core/Interfaces/IBubble.d.ts

@@ -1,7 +0,0 @@
-/**
- * @category Interfaces
- */
-export interface IBubble {
-    clicking?: boolean;
-    durationEnd?: boolean;
-}

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

@@ -1,12 +0,0 @@
-import type { IHsl } from "./Colors";
-/**
- * @category Interfaces
- */
-export interface IBubbleParticleData {
-    inRange: boolean;
-    opacity?: number;
-    radius?: number;
-    color?: IHsl;
-    finalColor?: IHsl;
-    div?: HTMLElement;
-}

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

@@ -1,9 +0,0 @@
-import type { ICoordinates } from "./ICoordinates";
-import type { Vector } from "../Utils";
-export interface ICircleBouncer {
-    position: ICoordinates;
-    velocity: Vector;
-    radius: number;
-    mass: number;
-    factor: Vector;
-}

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

@@ -1,9 +0,0 @@
-import type { IMouseData } from "./IMouseData";
-/**
- * @category Interfaces
- */
-export interface IContainerInteractivity {
-    element?: HTMLElement | Window | Node | null;
-    status?: string;
-    mouse: IMouseData;
-}