@tsparticles/canvas-utils 4.0.0-beta.1 → 4.0.0-beta.10

package/README.md

@@ -8,6 +8,12 @@
 
 [tsParticles](https://github.com/tsparticles/tsparticles) canvas utils.
 
+## Quick checklist
+
+1. Install `@tsparticles/engine` (or use the CDN bundle below)
+2. Call the package loader function(s) before `tsParticles.load(...)`
+3. Apply the package options in your `tsParticles.load(...)` config
+
 ## How to use it
 
 ### CDN / Vanilla JS / jQuery
@@ -72,3 +78,14 @@ import { loadCanvasUtilsPath } from "@tsparticles/canvas-utils";
   await loadCanvasUtilsPath(tsParticles);
 })();
 ```
+
+## Common pitfalls
+
+- Calling `tsParticles.load(...)` before `loadCanvasUtilsPath(...)`
+- Verify required peer packages before enabling advanced options
+- Change one option group at a time to isolate regressions quickly
+
+## Related docs
+
+- All packages catalog: <https://github.com/tsparticles/tsparticles>
+- Main docs: <https://particles.js.org/docs/>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/canvas-utils",
-  "version": "4.0.0-beta.1",
+  "version": "4.0.0-beta.10",
   "description": "tsParticles canvas utils library",
   "homepage": "https://particles.js.org",
   "repository": {
@@ -97,13 +97,12 @@
       "browser": "./browser/index.js",
       "import": "./esm/index.js",
       "require": "./cjs/index.js",
-      "umd": "./umd/index.js",
-      "default": "./cjs/index.js"
+      "default": "./esm/index.js"
     },
     "./package.json": "./package.json"
   },
-  "dependencies": {
-    "@tsparticles/engine": "4.0.0-beta.1"
+  "peerDependencies": {
+    "@tsparticles/engine": "4.0.0-beta.10"
   },
   "type": "module"
 }

package/report.html

@@ -3,7 +3,7 @@
       <head>
         <meta charset="UTF-8" />
         <meta name="viewport" content="width=device-width, initial-scale=1" />
-        <title>@tsparticles/canvas-utils [31 Mar 2026 at 08:45]</title>
+        <title>@tsparticles/canvas-utils [8 Apr 2026 at 15:55]</title>
         <link
           rel="shortcut icon"
           href="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAABrVBMVEUAAAD///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////+O1foceMD///+J0/qK1Pr7/v8Xdr/9///W8P4UdL7L7P0Scr2r4Pyj3vwad8D5/f/2/f+55f3E6f34+/2H0/ojfMKpzOd0rNgQcb3F3O/j9f7c8v6g3Pz0/P/w+v/q+P7n9v6T1/uQ1vuE0vqLut/y+v+Z2fvt+f+15Pzv9fuc2/vR7v2V2Pvd6/bg9P7I6/285/2y4/yp3/zp8vk8i8kqgMT7/P31+fyv4vxGkcz6/P6/6P3j7vfS5PNnpNUxhcbO7f7F6v3O4vHK3/DA2u631Ouy0eqXweKJud5wqthfoNMMbLvY8f73+v2dxeR8sNtTmdDx9/zX6PSjyeaCtd1YnNGX2PuQveCGt95Nls42h8dLlM3F4vBtAAAAM3RSTlMAAyOx0/sKBvik8opWGBMOAe3l1snDm2E9LSb06eHcu5JpHbarfHZCN9CBb08zzkdNS0kYaptYAAAFV0lEQVRYw92X51/aYBDHHS2O2qqttVbrqNq9m+TJIAYIShBkWwqIiCgoWvfeq7Z2/s29hyQNyUcR7LveGwVyXy6XH8/9rqxglLfUPLxVduUor3h0rfp2TYvpivk37929TkG037hffoX0+peVtZQc1589rigVUdXS/ABSAyEmGIO/1XfvldSK8vs3OqB6u3m0nxmIrvgB0dj7rr7Y9IbuF68hnfFaiHA/sxqm0wciIG43P60qKv9WXWc1RXGh/mFESFABTSBi0sNAKzqet17eCtOb3kZIDwxEEU0oAIJGYxNBDhBND29e0rtXXbcpuPmED9IhEAAQ/AXEaF8EPmnrrKsv0LvWR3fg5sWDNAFZOgAgaKvZDogHNU9MFwnnYROkc56RD5CjAbQX9Ow4g7upCsvYu55aSI/Nj0H1akgKQEUM94dwK65hYRmFU9MIcH/fqJYOZYcnuJSU/waKDgTOEVaVKhwrTRP5XzgSpAITYzom7UvkhFX5VutmxeNnWDjjswTKTyfgluNDGbUpWissXhF3s7mlSml+czWkg3D0l1nNjGNjz3myOQOa1KM/jOS6ebdbAVTCi4gljHSFrviza7tOgRWcS0MOUX9zdNgag5w7rRqA44Lzw0hr1WqES36dFliSJFlh2rXIae3FFcDDgKdxrUIDePr8jGcSClV1u7A9xeN0ModY/pHMxmR1EzRh8TJiwqsHmKW0l4FCEZI+jHio+JdPPE9qwQtTRxku2D8sIeRL2LnxWSllANCQGOIiqVHAz2ye2JR0DcH+HoxDkaADLjgxjKQ+AwCX/g0+DNgdG0ukYCONAe+dbc2IAc6fwt1ARoDSezNHxV2Cmzwv3O6lDMV55edBGwGK9n1+x2F8EDfAGCxug8MhpsMEcTEAWf3rx2vZhe/LAmtIn/6apE6PN0ULKgywD9mmdxbmFl3OvD5AS5fW5zLbv/YHmcsBTjf/afDz3MaZTVCfAP9z6/Bw6ycv8EUBWJIn9zYcoAWWlW9+OzO3vkTy8H+RANLmdrpOuYWdZYEXpo+TlCJrW5EARb7fF+bWdqf3hhyZI1nWJQHgznErZhbjoEsWqi8dQNoE294aldzFurwSABL2XXMf9+H1VQGke9exw5P/AnA5Pv5ngMul7LOvO922iwACu8WkCwLCafvM4CeWPxfA8lNHcWZSoi8EwMAIciKX2Z4SWCMAa3snCZ/G4EA8D6CMLNFsGQhkkz/gQNEBbPCbWsxGUpYVu3z8IyNAknwJkfPMEhLyrdi5RTyUVACkw4GSFRNWJNEW+fgPGwHD8/JxnRuLabN4CGNRkAE23na2+VmEAUmrYymSGjMAYqH84YUIyzgzs3XC7gNgH36Vcc4zKY9o9fgPBXUAiHHwVboBHGLiX6Zcjp1f2wu4tvzZKo0ecPnDtQYDQvJXaBeNzce45Fp28ZQLrEZVuFqgBwOalArKXnW1UzlnSusQKJqKYNuz4tOnI6sZG4zanpemv+7ySU2jbA9h6uhcgpfy6G2PahirDZ6zvq6zDduMVFTKvzw8wgyEdelwY9in3XkEPs3osJuwRQ4qTkfzifndg9Gfc4pdsu82+tTnHZTBa2EAMrqr2t43pguc8tNm7JQVQ2S0ukj2d22dhXYP0/veWtwKrCkNoNimAN5+Xr/oLrxswKbVJjteWrX7eR63o4j9q0GxnaBdWgGA5VStpanIjQmEhV0/nVt5VOFUvix6awJhPcAaTEShgrG+iGyvb5a0Ndb1YGHFPEwoqAinoaykaID1o1pdPNu7XsnCKQ3R+hwWIIhGvORcJUBYXe3Xa3vq/mF/N9V13ugufMkfXn+KHsRD0B8AAAAASUVORK5CYII="

package/tsparticles.canvas.utils.js

@@ -4,7 +4,7 @@
  * Demo / Generator : https://particles.js.org/
  * GitHub : https://www.github.com/matteobruni/tsparticles
  * How to use? : Check the GitHub README
- * v4.0.0-beta.1
+ * v4.0.0-beta.10
  */
 /*
  * ATTENTION: The "eval" devtool has been used (maybe by default in mode: "development").

package/umd/Utils.js

@@ -1,123 +0,0 @@
-(function (factory) {
-    if (typeof module === "object" && typeof module.exports === "object") {
-        var v = factory(require, exports);
-        if (v !== undefined) module.exports = v;
-    }
-    else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "@tsparticles/engine"], factory);
-    }
-})(function (require, exports) {
-    "use strict";
-    Object.defineProperty(exports, "__esModule", { value: true });
-    exports.drawLine = drawLine;
-    exports.getCanvasImageData = getCanvasImageData;
-    exports.getImageData = getImageData;
-    exports.getTextData = getTextData;
-    exports.loadFont = loadFont;
-    const engine_1 = require("@tsparticles/engine");
-    const defaultWidth = 0, indexesOffset = {
-        r: 0,
-        g: 1,
-        b: 2,
-        a: 3,
-    }, alphaMax = 255, alphaFactor = engine_1.identity / alphaMax;
-    function drawLine(context, begin, end) {
-        context.beginPath();
-        context.moveTo(begin.x, begin.y);
-        context.lineTo(end.x, end.y);
-        context.closePath();
-    }
-    function getCanvasImageData(ctx, size, offset, clear = true) {
-        const imageData = ctx.getImageData(engine_1.originPoint.x, engine_1.originPoint.y, size.width, size.height).data;
-        if (clear) {
-            ctx.clearRect(engine_1.originPoint.x, engine_1.originPoint.y, size.width, size.height);
-        }
-        const pixels = [];
-        for (let i = 0; i < imageData.length; i += offset) {
-            const idx = i / offset, pos = {
-                x: idx % size.width,
-                y: Math.floor(idx / size.width),
-            };
-            pixels[pos.y] ??= [];
-            const row = pixels[pos.y];
-            if (!row) {
-                continue;
-            }
-            row[pos.x] = {
-                r: imageData[i + indexesOffset.r] ?? engine_1.defaultRgbMin,
-                g: imageData[i + indexesOffset.g] ?? engine_1.defaultRgbMin,
-                b: imageData[i + indexesOffset.b] ?? engine_1.defaultRgbMin,
-                a: (imageData[i + indexesOffset.a] ?? engine_1.defaultAlpha) * alphaFactor,
-            };
-        }
-        return {
-            pixels,
-            width: Math.min(...pixels.map(row => row.length)),
-            height: pixels.length,
-        };
-    }
-    function getImageData(src, offset, canvasSettings) {
-        const image = new Image();
-        image.crossOrigin = "Anonymous";
-        const p = new Promise((resolve, reject) => {
-            image.onerror = reject;
-            image.onload = () => {
-                const canvas = (0, engine_1.safeDocument)().createElement("canvas");
-                canvas.width = image.width;
-                canvas.height = image.height;
-                const context = canvas.getContext("2d", canvasSettings);
-                if (!context) {
-                    reject(new Error("Could not get canvas context"));
-                    return;
-                }
-                context.drawImage(image, engine_1.originPoint.x, engine_1.originPoint.y, image.width, image.height, engine_1.originPoint.x, engine_1.originPoint.y, canvas.width, canvas.height);
-                resolve(getCanvasImageData(context, canvas, offset));
-            };
-        });
-        image.src = src;
-        return p;
-    }
-    function getTextData(textOptions, offset, fill, canvasSettings) {
-        const canvas = (0, engine_1.safeDocument)().createElement("canvas"), context = canvas.getContext("2d", canvasSettings), { font, text, lines: linesOptions, color } = textOptions;
-        if (!text || !context) {
-            return;
-        }
-        const lines = text.split(linesOptions.separator), fontSize = (0, engine_1.isNumber)(font.size) ? `${font.size.toString()}px` : font.size, linesData = [];
-        let maxWidth = 0, totalHeight = 0;
-        for (const line of lines) {
-            context.font = `${font.style || ""} ${font.variant || ""} ${font.weight || ""} ${fontSize} ${font.family}`;
-            const measure = context.measureText(line), lineData = {
-                measure,
-                text: line,
-                height: measure.actualBoundingBoxAscent + measure.actualBoundingBoxDescent,
-                width: measure.width,
-            };
-            maxWidth = Math.max(maxWidth || defaultWidth, lineData.width);
-            totalHeight += lineData.height + linesOptions.spacing;
-            linesData.push(lineData);
-        }
-        canvas.width = maxWidth;
-        canvas.height = totalHeight;
-        let currentHeight = 0;
-        for (const line of linesData) {
-            context.font = `${font.style || ""} ${font.variant || ""} ${font.weight || ""} ${fontSize} ${font.family}`;
-            if (fill) {
-                context.fillStyle = color;
-                context.fillText(line.text, engine_1.originPoint.x, currentHeight + line.measure.actualBoundingBoxAscent);
-            }
-            else {
-                context.strokeStyle = color;
-                context.strokeText(line.text, engine_1.originPoint.x, currentHeight + line.measure.actualBoundingBoxAscent);
-            }
-            currentHeight += line.height + linesOptions.spacing;
-        }
-        return getCanvasImageData(context, canvas, offset);
-    }
-    async function loadFont(font, weight) {
-        try {
-            await (0, engine_1.safeDocument)().fonts.load(`${weight ?? "400"} 36px '${font ?? "Verdana"}'`);
-        }
-        catch {
-        }
-    }
-});

package/umd/index.js

@@ -1,27 +0,0 @@
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (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);
-};
-(function (factory) {
-    if (typeof module === "object" && typeof module.exports === "object") {
-        var v = factory(require, exports);
-        if (v !== undefined) module.exports = v;
-    }
-    else if (typeof define === "function" && define.amd) {
-        define(["require", "exports", "./Utils.js"], factory);
-    }
-})(function (require, exports) {
-    "use strict";
-    Object.defineProperty(exports, "__esModule", { value: true });
-    __exportStar(require("./Utils.js"), exports);
-});

package/umd/types.js

@@ -1,12 +0,0 @@
-(function (factory) {
-    if (typeof module === "object" && typeof module.exports === "object") {
-        var v = factory(require, exports);
-        if (v !== undefined) module.exports = v;
-    }
-    else if (typeof define === "function" && define.amd) {
-        define(["require", "exports"], factory);
-    }
-})(function (require, exports) {
-    "use strict";
-    Object.defineProperty(exports, "__esModule", { value: true });
-});