@tsparticles/cli 2.0.4 → 2.1.0

package/.github/workflows/node.js-ci.yml

@@ -12,11 +12,11 @@ jobs:
     runs-on: ubuntu-latest
     if: ${{ github.event_name != 'pull_request' }}
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         name: Checkout [main]
         with:
           fetch-depth: 0
-      - uses: actions/setup-node@v3
+      - uses: actions/setup-node@v4
         with:
           node-version: "16"
       - uses: pnpm/action-setup@v2.4.0
@@ -35,7 +35,7 @@ jobs:
         run: |
           echo "::set-output name=pnpm_cache_dir::$(pnpm store path)"
 
-      - uses: actions/cache@v3
+      - uses: actions/cache@v4
         name: Setup pnpm cache
         with:
           path: ${{ steps.pnpm-cache.outputs.pnpm_cache_dir }}
@@ -49,12 +49,12 @@ jobs:
     runs-on: ubuntu-latest
     if: ${{ github.event_name == 'pull_request' }}
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
         with:
           ref: ${{ github.event.pull_request.head.ref }}
           repository: ${{ github.event.pull_request.head.repo.full_name }}
           fetch-depth: 0
-      - uses: actions/setup-node@v3
+      - uses: actions/setup-node@v4
         with:
           node-version: "16"
       - uses: pnpm/action-setup@v2.4.0
@@ -73,7 +73,7 @@ jobs:
         run: |
           echo "::set-output name=pnpm_cache_dir::$(pnpm store path)"
 
-      - uses: actions/cache@v3
+      - uses: actions/cache@v4
         name: Setup pnpm cache
         with:
           path: ${{ steps.pnpm-cache.outputs.pnpm_cache_dir }}

package/dist/build/build-distfiles.js

@@ -48,7 +48,7 @@ async function buildDistFiles(basePath) {
             libObj.peerDependencies = JSON.parse(JSON.stringify(pkgInfo.peerDependencies).replaceAll("workspace:", ""));
         }
         const jsonIndent = 2;
-        fs_extra_1.default.writeFileSync(libPackage, `${JSON.stringify(libObj, undefined, jsonIndent)}\n`, "utf8");
+        await fs_extra_1.default.writeFile(libPackage, `${JSON.stringify(libObj, undefined, jsonIndent)}\n`, "utf8");
         console.log(`package.dist.json updated successfully to version ${pkgInfo.version}`);
         const rootFilesToCopy = [
             "LICENSE",
@@ -60,14 +60,14 @@ async function buildDistFiles(basePath) {
         ];
         for (const file of rootFilesToCopy) {
             const src = path_1.default.join(basePath, typeof file === "string" ? file : file.source), dest = path_1.default.join(distPath, typeof file === "string" ? file : file.destination);
-            fs_extra_1.default.copyFileSync(src, dest);
+            await fs_extra_1.default.copyFile(src, dest);
         }
         const scriptsPath = path_1.default.join(basePath, "scripts"), distScriptsPath = path_1.default.join(distPath, "scripts");
-        if (fs_extra_1.default.existsSync(scriptsPath) && !fs_extra_1.default.existsSync(distScriptsPath)) {
-            fs_extra_1.default.mkdirSync(distScriptsPath);
+        if ((await fs_extra_1.default.exists(scriptsPath)) && !(await fs_extra_1.default.exists(distScriptsPath))) {
+            await fs_extra_1.default.mkdir(distScriptsPath);
             const installPath = path_1.default.join(scriptsPath, "install.js");
-            if (fs_extra_1.default.existsSync(installPath)) {
-                fs_extra_1.default.copyFileSync(installPath, path_1.default.join(distScriptsPath, "install.js"));
+            if (await fs_extra_1.default.exists(installPath)) {
+                await fs_extra_1.default.copyFile(installPath, path_1.default.join(distScriptsPath, "install.js"));
             }
         }
         for await (const file of (0, klaw_1.default)(distPath)) {

package/dist/build/build-diststats.js

@@ -28,7 +28,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getDistStats = void 0;
 const fs_extra_1 = __importDefault(require("fs-extra"));
-const path_1 = __importDefault(require("path"));
 /**
  * @param folderPath - the path to the folder to get the stats for
  * @param bundlePath - the bundle path to get the bundle size for
@@ -44,20 +43,20 @@ async function getFolderStats(folderPath, bundlePath) {
     if (!(await fs_extra_1.default.pathExists(folderPath))) {
         return stats;
     }
-    const dir = await fs_extra_1.default.promises.opendir(folderPath);
+    const dir = await fs_extra_1.default.promises.opendir(folderPath), path = await Promise.resolve().then(() => __importStar(require("path")));
     for await (const dirent of dir) {
         const increment = 1;
         if (dirent.isDirectory()) {
-            const subDirStats = await getFolderStats(path_1.default.join(folderPath, dirent.name), bundlePath);
+            const subDirStats = await getFolderStats(path.join(folderPath, dirent.name), bundlePath);
             stats.totalFolders += subDirStats.totalFolders + increment;
             stats.totalFiles += subDirStats.totalFiles;
             stats.totalSize += subDirStats.totalSize;
         }
         else {
-            const fileStats = await fs_extra_1.default.stat(path_1.default.join(folderPath, dirent.name));
+            const fileStats = await fs_extra_1.default.stat(path.join(folderPath, dirent.name));
             stats.totalFiles++;
             stats.totalSize += fileStats.size;
-            if (bundlePath && path_1.default.join(folderPath, dirent.name) === bundlePath) {
+            if (bundlePath && path.join(folderPath, dirent.name) === bundlePath) {
                 stats.bundleSize += fileStats.size;
             }
         }
@@ -70,10 +69,10 @@ async function getFolderStats(folderPath, bundlePath) {
  * @returns the stats for the dist folder
  */
 async function getDistStats(basePath) {
-    const distFolder = path_1.default.join(basePath, "dist"), pkgInfo = (await fs_extra_1.default.exists(path_1.default.join(distFolder, "package.json")))
-        ? (await Promise.resolve(`${path_1.default.join(distFolder, "package.json")}`).then(s => __importStar(require(s))))
+    const path = await Promise.resolve().then(() => __importStar(require("path"))), distFolder = path.join(basePath, "dist"), pkgInfo = (await fs_extra_1.default.exists(path.join(distFolder, "package.json")))
+        ? (await Promise.resolve(`${path.join(distFolder, "package.json")}`).then(s => __importStar(require(s))))
         : {}, bundlePath = (await fs_extra_1.default.exists(distFolder)) && pkgInfo.jsdelivr
-        ? path_1.default.resolve(path_1.default.join(distFolder, pkgInfo.jsdelivr))
+        ? path.resolve(path.join(distFolder, pkgInfo.jsdelivr))
         : undefined;
     return await getFolderStats(distFolder, bundlePath);
 }

package/dist/build/build-tsc.js

@@ -1,4 +1,27 @@
 "use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -6,7 +29,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildTS = void 0;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
-const typescript_1 = __importDefault(require("typescript"));
 /**
  * @param basePath -
  * @param file -
@@ -102,20 +124,20 @@ async function compile(basePath, type) {
     if (!options) {
         return 3 /* ExitCodes.NoOptions */;
     }
-    const parsed = typescript_1.default.parseJsonConfigFileContent(options, typescript_1.default.sys, basePath);
+    const ts = await Promise.resolve().then(() => __importStar(require("typescript"))), parsed = ts.parseJsonConfigFileContent(options, ts.sys, basePath);
     if (!parsed) {
         return 4 /* ExitCodes.ParseError */;
     }
-    const program = typescript_1.default.createProgram(parsed.fileNames, parsed.options), emitResult = program.emit(), allDiagnostics = typescript_1.default.getPreEmitDiagnostics(program).concat(emitResult.diagnostics);
+    const program = ts.createProgram(parsed.fileNames, parsed.options), emitResult = program.emit(), allDiagnostics = ts.getPreEmitDiagnostics(program).concat(emitResult.diagnostics);
     let failed = false;
     allDiagnostics.forEach(diagnostic => {
-        failed = failed || diagnostic.category === typescript_1.default.DiagnosticCategory.Error;
+        failed = failed || diagnostic.category === ts.DiagnosticCategory.Error;
         if (diagnostic.file) {
-            const startingPos = 0, { line, character } = typescript_1.default.getLineAndCharacterOfPosition(diagnostic.file, diagnostic.start ?? startingPos), message = typescript_1.default.flattenDiagnosticMessageText(diagnostic.messageText, "\n"), increment = 1;
+            const startingPos = 0, { line, character } = ts.getLineAndCharacterOfPosition(diagnostic.file, diagnostic.start ?? startingPos), message = ts.flattenDiagnosticMessageText(diagnostic.messageText, "\n"), increment = 1;
             console.log(`${diagnostic.file.fileName} (${line + increment},${character + increment}): ${message}`);
         }
         else {
-            console.log(typescript_1.default.flattenDiagnosticMessageText(diagnostic.messageText, "\n"));
+            console.log(ts.flattenDiagnosticMessageText(diagnostic.messageText, "\n"));
         }
     });
     const exitCode = emitResult.emitSkipped || failed ? 1 /* ExitCodes.EmitErrors */ : 0 /* ExitCodes.OK */;

package/dist/build/build.js

@@ -1,19 +1,30 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildCommand = void 0;
-const build_prettier_1 = require("./build-prettier");
 const commander_1 = require("commander");
-const build_distfiles_1 = require("./build-distfiles");
-const build_tsc_1 = require("./build-tsc");
-const build_bundle_1 = require("./build-bundle");
-const build_clear_1 = require("./build-clear");
-const fs_extra_1 = __importDefault(require("fs-extra"));
-const build_diststats_1 = require("./build-diststats");
-const build_eslint_1 = require("./build-eslint");
-const path_1 = __importDefault(require("path"));
 const buildCommand = new commander_1.Command("build");
 exports.buildCommand = buildCommand;
 buildCommand.description("Build the tsParticles library using TypeScript");
@@ -28,39 +39,46 @@ buildCommand.option("-t, --tsc", "Build the library using TypeScript", false);
 buildCommand.argument("[path]", `Path to the project root folder, default is "src"`, "src");
 buildCommand.action(async (argPath) => {
     const opts = buildCommand.opts(), ci = !!opts.ci, all = !!opts.all || (!opts.bundle && !opts.clean && !opts.dist && !opts.lint && !opts.prettify && !opts.tsc), doBundle = all || !!opts.bundle, clean = all || !!opts.clean, distfiles = all || !!opts.dist, doLint = all || !!opts.lint, prettier = all || !!opts.prettify, tsc = all || !!opts.tsc;
-    const basePath = process.cwd(), oldStats = await (0, build_diststats_1.getDistStats)(basePath);
+    const basePath = process.cwd(), { getDistStats } = await Promise.resolve().then(() => __importStar(require("./build-diststats.js"))), oldStats = await getDistStats(basePath);
     if (clean) {
-        await (0, build_clear_1.clearDist)(basePath);
+        const { clearDist } = await Promise.resolve().then(() => __importStar(require("./build-clear.js")));
+        await clearDist(basePath);
     }
-    const srcPath = path_1.default.join(basePath, argPath);
-    if (!(await fs_extra_1.default.pathExists(srcPath))) {
+    const path = await Promise.resolve().then(() => __importStar(require("path"))), srcPath = path.join(basePath, argPath), fs = await Promise.resolve().then(() => __importStar(require("fs-extra")));
+    if (!(await fs.pathExists(srcPath))) {
         throw new Error("Provided path does not exist");
     }
     let canContinue = true;
     if (canContinue && prettier) {
-        canContinue = await (0, build_prettier_1.prettifySrc)(basePath, srcPath, ci);
+        const { prettifySrc } = await Promise.resolve().then(() => __importStar(require("./build-prettier.js")));
+        canContinue = await prettifySrc(basePath, srcPath, ci);
     }
     if (canContinue && doLint) {
-        canContinue = await (0, build_eslint_1.lint)(ci);
+        const { lint } = await Promise.resolve().then(() => __importStar(require("./build-eslint.js")));
+        canContinue = await lint(ci);
     }
     if (canContinue && tsc) {
-        canContinue = await (0, build_tsc_1.buildTS)(basePath);
+        const { buildTS } = await Promise.resolve().then(() => __importStar(require("./build-tsc.js")));
+        canContinue = await buildTS(basePath);
     }
     if (canContinue && doBundle) {
-        canContinue = await (0, build_bundle_1.bundle)(basePath);
+        const { bundle } = await Promise.resolve().then(() => __importStar(require("./build-bundle.js")));
+        canContinue = await bundle(basePath);
     }
     if (canContinue && prettier) {
-        canContinue = await (0, build_prettier_1.prettifyReadme)(basePath, ci);
-        canContinue = await (0, build_prettier_1.prettifyPackageJson)(basePath, ci);
-        canContinue = await (0, build_prettier_1.prettifyPackageDistJson)(basePath, ci);
+        const { prettifyReadme, prettifyPackageJson, prettifyPackageDistJson } = await Promise.resolve().then(() => __importStar(require("./build-prettier")));
+        canContinue = await prettifyReadme(basePath, ci);
+        canContinue = await prettifyPackageJson(basePath, ci);
+        canContinue = await prettifyPackageDistJson(basePath, ci);
     }
     if (canContinue && distfiles) {
-        canContinue = await (0, build_distfiles_1.buildDistFiles)(basePath);
+        const { buildDistFiles } = await Promise.resolve().then(() => __importStar(require("./build-distfiles.js")));
+        canContinue = await buildDistFiles(basePath);
     }
     if (!canContinue) {
         throw new Error("Build failed");
     }
-    const newStats = await (0, build_diststats_1.getDistStats)(basePath), diffSize = newStats.totalSize - oldStats.totalSize, bundleDiffSize = newStats.bundleSize - oldStats.bundleSize, minSize = 0, bundleSizeIncreased = bundleDiffSize > minSize, outputFunc = bundleSizeIncreased ? console.warn : console.info, texts = [
+    const newStats = await getDistStats(basePath), diffSize = newStats.totalSize - oldStats.totalSize, bundleDiffSize = newStats.bundleSize - oldStats.bundleSize, minSize = 0, bundleSizeIncreased = bundleDiffSize > minSize, outputFunc = bundleSizeIncreased ? console.warn : console.info, texts = [
         !bundleDiffSize
             ? "Bundle size unchanged"
             : `Bundle size ${bundleSizeIncreased ? "increased" : "decreased"} from ${oldStats.bundleSize} to ${newStats.bundleSize} (${Math.abs(bundleDiffSize)}B)`,

package/dist/create/plugin/plugin.js

@@ -15,8 +15,7 @@ exports.pluginCommand = pluginCommand;
 pluginCommand.description("Create a new tsParticles plugin");
 pluginCommand.argument("<destination>", "Destination folder");
 pluginCommand.action(async (destination) => {
-    const destPath = await (0, file_utils_1.getDestinationDir)(destination), repoUrl = await (0, file_utils_1.getRepositoryUrl)();
-    const initialName = destPath.split(path_1.default.sep).pop(), questions = [
+    const destPath = await (0, file_utils_1.getDestinationDir)(destination), repoUrl = await (0, file_utils_1.getRepositoryUrl)(), initialName = destPath.split(path_1.default.sep).pop(), questions = [
         {
             type: "text",
             name: "name",
@@ -37,7 +36,6 @@ pluginCommand.action(async (destination) => {
             message: "What is the repository URL? (optional)",
             initial: repoUrl.trim(),
         },
-    ];
-    const { name, description, repositoryUrl } = (await (0, prompts_1.default)(questions));
+    ], { name, description, repositoryUrl } = (await (0, prompts_1.default)(questions));
     await (0, create_plugin_1.createPluginTemplate)(name.trim(), description.trim(), repositoryUrl.trim(), destPath);
 });

package/dist/create/preset/preset.js

@@ -15,8 +15,7 @@ exports.presetCommand = presetCommand;
 presetCommand.description("Create a new tsParticles preset");
 presetCommand.argument("<destination>", "Destination folder");
 presetCommand.action(async (destination) => {
-    const destPath = await (0, file_utils_1.getDestinationDir)(destination), repoUrl = await (0, file_utils_1.getRepositoryUrl)();
-    const initialName = destPath.split(path_1.default.sep).pop(), questions = [
+    const destPath = await (0, file_utils_1.getDestinationDir)(destination), repoUrl = await (0, file_utils_1.getRepositoryUrl)(), initialName = destPath.split(path_1.default.sep).pop(), questions = [
         {
             type: "text",
             name: "name",
@@ -37,7 +36,6 @@ presetCommand.action(async (destination) => {
             message: "What is the repository URL? (optional)",
             initial: repoUrl.trim(),
         },
-    ];
-    const { name, description, repositoryUrl } = (await (0, prompts_1.default)(questions));
+    ], { name, description, repositoryUrl } = (await (0, prompts_1.default)(questions));
     await (0, create_preset_1.createPresetTemplate)(name.trim(), description.trim(), repositoryUrl.trim(), destPath);
 });

package/dist/create/shape/shape.js

@@ -15,8 +15,7 @@ exports.shapeCommand = shapeCommand;
 shapeCommand.description("Create a new tsParticles shape");
 shapeCommand.argument("<destination>", "Destination folder");
 shapeCommand.action(async (destination) => {
-    const destPath = await (0, file_utils_1.getDestinationDir)(destination), repoUrl = await (0, file_utils_1.getRepositoryUrl)();
-    const initialName = destPath.split(path_1.default.sep).pop(), questions = [
+    const destPath = await (0, file_utils_1.getDestinationDir)(destination), repoUrl = await (0, file_utils_1.getRepositoryUrl)(), initialName = destPath.split(path_1.default.sep).pop(), questions = [
         {
             type: "text",
             name: "name",
@@ -37,7 +36,6 @@ shapeCommand.action(async (destination) => {
             message: "What is the repository URL? (optional)",
             initial: repoUrl.trim(),
         },
-    ];
-    const { name, description, repositoryUrl } = (await (0, prompts_1.default)(questions));
+    ], { name, description, repositoryUrl } = (await (0, prompts_1.default)(questions));
     await (0, create_shape_1.createShapeTemplate)(name.trim(), description.trim(), repositoryUrl.trim(), destPath);
 });

package/files/create-plugin/src/PluginInstance.ts

@@ -10,6 +10,7 @@ export class PluginInstance implements IContainerPlugin {
     }
 
     async init(): Promise<void> {
-        // add your plugin initialization here
+        // add your plugin initialization here, replace the empty promise
+        return await Promise.resolve();
     }
 }

package/files/create-plugin/src/index.ts

@@ -1,39 +1,10 @@
-import type { Container, Engine, IPlugin, ISourceOptions, Options } from "@tsparticles/engine";
-import { PluginInstance } from "./PluginInstance";
-
-/**
- */
-class Plugin implements IPlugin {
-    readonly id;
-
-    private readonly _engine;
-
-    constructor(engine: Engine) {
-        this.id = "#template#";
-
-        this._engine = engine;
-    }
-
-    getPlugin(container: Container): PluginInstance {
-        return new PluginInstance(container, this._engine);
-    }
-
-    loadOptions(_options: Options, _source?: ISourceOptions): void {
-        if (!this.needsPlugin()) {
-            return;
-        }
-
-        // Load your options here
-    }
-
-    needsPlugin(_options?: ISourceOptions): boolean {
-        return true; // add your condition here
-    }
-}
+import type { Engine } from "@tsparticles/engine";
 
 /**
  * @param engine - The engine instance
  */
 export async function loadTemplatePlugin(engine: Engine): Promise<void> {
+    const { Plugin } = await import("./plugin.js");
+
     await engine.addPlugin(new Plugin(engine));
 }

package/files/create-plugin/src/plugin.ts

@@ -0,0 +1,36 @@
+import { type Container, type Engine, type IPlugin, type ISourceOptions, type Options } from "@tsparticles/engine";
+import type { PluginInstance } from "./PluginInstance.js";
+
+/**
+ */
+export class Plugin implements IPlugin {
+    readonly id;
+
+    private readonly _engine;
+
+    constructor(engine: Engine) {
+        this.id = "#template#";
+
+        this._engine = engine;
+    }
+
+    async getPlugin(container: Container): Promise<PluginInstance> {
+        const { PluginInstance } = await import("./PluginInstance.js");
+
+        return new PluginInstance(container, this._engine);
+    }
+
+    loadOptions(_options: Options, _source?: ISourceOptions): void {
+        if (!this.needsPlugin()) {
+            // ignore plugin options when not needed
+
+            return;
+        }
+
+        // Load your options here
+    }
+
+    needsPlugin(_options?: ISourceOptions): boolean {
+        return true; // add your condition here, replace true with condition if needed
+    }
+}

package/files/create-preset/src/bundle.ts

@@ -1,6 +1,6 @@
-import { loadTemplatePreset } from ".";
+import { loadTemplatePreset } from "./index.js";
 import { tsParticles } from "@tsparticles/engine";
 
-loadTemplatePreset(tsParticles);
+void loadTemplatePreset(tsParticles);
 
 export { loadTemplatePreset, tsParticles };

package/files/create-preset/src/index.ts

@@ -1,13 +1,14 @@
 import type { Engine } from "@tsparticles/engine";
-import { options } from "./options";
 
 /**
  *
  * @param engine - the engine instance to load the preset into
  */
-export function loadTemplatePreset(engine: Engine): void {
+export async function loadTemplatePreset(engine: Engine): Promise<void> {
+    const { options } = await import("./options");
+
     // TODO: additional modules must be loaded here
 
     // Adds the preset to the engine, with the given options
-    engine.addPreset("#template#", options);
+    await engine.addPreset("#template#", options);
 }

package/files/create-shape/src/ShapeDrawer.ts

@@ -1,7 +1,7 @@
 import type { IShapeDrawData, IShapeDrawer } from "@tsparticles/engine";
 
 export class ShapeDrawer implements IShapeDrawer {
-    draw(_data: IShapeDrawData): void {
+    async draw(_data: IShapeDrawData): Promise<void> {
         // draw the particle using the context
         // which is already centered in the particle position
         // colors are already handled, just draw the shape
@@ -10,5 +10,8 @@ export class ShapeDrawer implements IShapeDrawer {
         // pixelRatio is the canvas ratio used by the tsParticles instance, you may need it for density-independent shapes
         // the parameters have an underscore prefix because they're not used in this example
         // the underscore prefix can be removed for used parameters, the unused ones can be removed too
+
+        // remove this if there's already an await call
+        await Promise.resolve();
     }
 }

package/files/create-shape/src/index.ts

@@ -1,9 +1,10 @@
 import type { Engine } from "@tsparticles/engine";
-import { ShapeDrawer } from "./ShapeDrawer";
 
 /**
  * @param engine - the engine instance to load the shape into
  */
 export async function loadTemplateShape(engine: Engine): Promise<void> {
+    const { ShapeDrawer } = await import("./ShapeDrawer");
+
     await engine.addShape("#template#", new ShapeDrawer());
 }

package/files/empty-project/package.dist.json

@@ -72,6 +72,6 @@
   "module": "index.js",
   "types": "index.d.ts",
   "dependencies": {
-    "@tsparticles/engine": "^3.0.2"
+    "@tsparticles/engine": "^3.0.3"
   }
 }

package/files/empty-project/package.json

@@ -82,29 +82,29 @@
   "types": "dist/types/index.d.ts",
   "prettier": "@tsparticles/prettier-config",
   "devDependencies": {
-    "@babel/core": "^7.23.6",
-    "@tsparticles/cli": "^2.0.4",
-    "@tsparticles/eslint-config": "^2.0.2",
-    "@tsparticles/prettier-config": "^2.0.1",
+    "@babel/core": "^7.23.9",
+    "@tsparticles/cli": "^2.1.0",
+    "@tsparticles/eslint-config": "^2.1.4",
+    "@tsparticles/prettier-config": "^2.1.0",
     "@tsparticles/tsconfig": "^2.0.1",
-    "@tsparticles/webpack-plugin": "^2.0.2",
+    "@tsparticles/webpack-plugin": "^2.1.4",
     "@types/webpack-env": "^1.18.4",
-    "@typescript-eslint/eslint-plugin": "^6.14.0",
-    "@typescript-eslint/parser": "^6.14.0",
+    "@typescript-eslint/eslint-plugin": "^6.20.0",
+    "@typescript-eslint/parser": "^6.20.0",
     "babel-loader": "^9.1.3",
-    "browserslist": "^4.22.1",
+    "browserslist": "^4.22.3",
     "copyfiles": "^2.4.1",
-    "eslint": "^8.55.0",
+    "eslint": "^8.56.0",
     "eslint-config-prettier": "^9.1.0",
-    "prettier": "^3.1.1",
+    "prettier": "^3.2.4",
     "rimraf": "^5.0.5",
-    "terser-webpack-plugin": "^5.3.9",
+    "terser-webpack-plugin": "^5.3.10",
     "typescript": "^5.3.3",
-    "webpack": "^5.89.0",
-    "webpack-bundle-analyzer": "^4.10.0",
+    "webpack": "^5.90.0",
+    "webpack-bundle-analyzer": "^4.10.1",
     "webpack-cli": "^5.1.4"
   },
   "dependencies": {
-    "@tsparticles/engine": "^3.0.2"
+    "@tsparticles/engine": "^3.2.0"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/cli",
-  "version": "2.0.4",
+  "version": "2.1.0",
   "license": "MIT",
   "bin": {
     "tsparticles-cli": "dist/cli.js"
@@ -10,36 +10,36 @@
   },
   "prettier": "@tsparticles/prettier-config",
   "dependencies": {
-    "@tsparticles/eslint-config": "^2.0.4",
-    "@tsparticles/prettier-config": "^2.0.1",
+    "@tsparticles/eslint-config": "^2.1.4",
+    "@tsparticles/prettier-config": "^2.1.0",
     "@tsparticles/tsconfig": "^2.0.1",
-    "@tsparticles/webpack-plugin": "^2.0.4",
-    "@typescript-eslint/eslint-plugin": "^6.14.0",
-    "@typescript-eslint/parser": "^6.14.0",
+    "@tsparticles/webpack-plugin": "^2.1.4",
+    "@typescript-eslint/eslint-plugin": "^6.20.0",
+    "@typescript-eslint/parser": "^6.20.0",
     "commander": "^11.1.0",
-    "eslint": "^8.55.0",
+    "eslint": "^8.56.0",
     "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-jsdoc": "^46.9.0",
+    "eslint-plugin-jsdoc": "^48.0.4",
     "eslint-plugin-tsdoc": "^0.2.17",
     "fs-extra": "^11.2.0",
     "klaw": "^4.1.0",
     "lookpath": "^1.2.2",
     "path-scurry": "^1.10.1",
-    "prettier": "^3.1.1",
+    "prettier": "^3.2.4",
     "prettier-plugin-multiline-arrays": "^3.0.1",
     "prompts": "^2.4.2",
     "rimraf": "^5.0.5",
     "typescript": "^5.3.3",
-    "webpack": "^5.89.0"
+    "webpack": "^5.90.0"
   },
   "devDependencies": {
     "@types/chai": "^4.3.11",
     "@types/fs-extra": "^11.0.4",
     "@types/klaw": "^3.0.6",
     "@types/mocha": "^10.0.6",
-    "@types/node": "^20.10.4",
+    "@types/node": "^20.11.13",
     "@types/prompts": "^2.4.9",
-    "chai": "^4.3.10",
+    "chai": "^4.4.0",
     "cross-env": "^7.0.3",
     "mocha": "^10.2.0",
     "nyc": "^15.1.0",

package/src/build/build-distfiles.ts

@@ -35,7 +35,7 @@ export async function buildDistFiles(basePath: string): Promise<boolean> {
 
         const jsonIndent = 2;
 
-        fs.writeFileSync(libPackage, `${JSON.stringify(libObj, undefined, jsonIndent)}\n`, "utf8");
+        await fs.writeFile(libPackage, `${JSON.stringify(libObj, undefined, jsonIndent)}\n`, "utf8");
 
         console.log(`package.dist.json updated successfully to version ${pkgInfo.version}`);
 
@@ -52,19 +52,19 @@ export async function buildDistFiles(basePath: string): Promise<boolean> {
             const src = path.join(basePath, typeof file === "string" ? file : file.source),
                 dest = path.join(distPath, typeof file === "string" ? file : file.destination);
 
-            fs.copyFileSync(src, dest);
+            await fs.copyFile(src, dest);
         }
 
         const scriptsPath = path.join(basePath, "scripts"),
             distScriptsPath = path.join(distPath, "scripts");
 
-        if (fs.existsSync(scriptsPath) && !fs.existsSync(distScriptsPath)) {
-            fs.mkdirSync(distScriptsPath);
+        if ((await fs.exists(scriptsPath)) && !(await fs.exists(distScriptsPath))) {
+            await fs.mkdir(distScriptsPath);
 
             const installPath = path.join(scriptsPath, "install.js");
 
-            if (fs.existsSync(installPath)) {
-                fs.copyFileSync(installPath, path.join(distScriptsPath, "install.js"));
+            if (await fs.exists(installPath)) {
+                await fs.copyFile(installPath, path.join(distScriptsPath, "install.js"));
             }
         }
 

package/src/build/build-diststats.ts

@@ -1,5 +1,4 @@
 import fs from "fs-extra";
-import path from "path";
 
 export interface IDistStats {
     bundleSize: number;
@@ -25,7 +24,8 @@ async function getFolderStats(folderPath: string, bundlePath?: string): Promise<
         return stats;
     }
 
-    const dir = await fs.promises.opendir(folderPath);
+    const dir = await fs.promises.opendir(folderPath),
+        path = await import("path");
 
     for await (const dirent of dir) {
         const increment = 1;
@@ -57,7 +57,8 @@ async function getFolderStats(folderPath: string, bundlePath?: string): Promise<
  * @returns the stats for the dist folder
  */
 export async function getDistStats(basePath: string): Promise<IDistStats> {
-    const distFolder = path.join(basePath, "dist"),
+    const path = await import("path"),
+        distFolder = path.join(basePath, "dist"),
         pkgInfo = (await fs.exists(path.join(distFolder, "package.json")))
             ? ((await import(path.join(distFolder, "package.json"))) as { jsdelivr?: string })
             : {},

package/src/build/build-tsc.ts

@@ -1,6 +1,5 @@
 import fs from "fs-extra";
 import path from "path";
-import ts from "typescript";
 
 const enum ExitCodes {
     OK = 0,
@@ -123,7 +122,8 @@ async function compile(basePath: string, type: "browser" | "cjs" | "esm" | "type
         return ExitCodes.NoOptions;
     }
 
-    const parsed = ts.parseJsonConfigFileContent(options, ts.sys, basePath);
+    const ts = await import("typescript"),
+        parsed = ts.parseJsonConfigFileContent(options, ts.sys, basePath);
 
     if (!parsed) {
         return ExitCodes.ParseError;

package/src/build/build.ts

@@ -1,13 +1,4 @@
-import { prettifyPackageDistJson, prettifyPackageJson, prettifyReadme, prettifySrc } from "./build-prettier";
 import { Command } from "commander";
-import { buildDistFiles } from "./build-distfiles";
-import { buildTS } from "./build-tsc";
-import { bundle } from "./build-bundle";
-import { clearDist } from "./build-clear";
-import fs from "fs-extra";
-import { getDistStats } from "./build-diststats";
-import { lint } from "./build-eslint";
-import path from "path";
 
 const buildCommand = new Command("build");
 
@@ -42,13 +33,18 @@ buildCommand.action(async (argPath: string) => {
         tsc = all || !!opts.tsc;
 
     const basePath = process.cwd(),
+        { getDistStats } = await import("./build-diststats.js"),
         oldStats = await getDistStats(basePath);
 
     if (clean) {
+        const { clearDist } = await import("./build-clear.js");
+
         await clearDist(basePath);
     }
 
-    const srcPath = path.join(basePath, argPath);
+    const path = await import("path"),
+        srcPath = path.join(basePath, argPath),
+        fs = await import("fs-extra");
 
     if (!(await fs.pathExists(srcPath))) {
         throw new Error("Provided path does not exist");
@@ -57,28 +53,40 @@ buildCommand.action(async (argPath: string) => {
     let canContinue = true;
 
     if (canContinue && prettier) {
+        const { prettifySrc } = await import("./build-prettier.js");
+
         canContinue = await prettifySrc(basePath, srcPath, ci);
     }
 
     if (canContinue && doLint) {
+        const { lint } = await import("./build-eslint.js");
+
         canContinue = await lint(ci);
     }
 
     if (canContinue && tsc) {
+        const { buildTS } = await import("./build-tsc.js");
+
         canContinue = await buildTS(basePath);
     }
 
     if (canContinue && doBundle) {
+        const { bundle } = await import("./build-bundle.js");
+
         canContinue = await bundle(basePath);
     }
 
     if (canContinue && prettier) {
+        const { prettifyReadme, prettifyPackageJson, prettifyPackageDistJson } = await import("./build-prettier");
+
         canContinue = await prettifyReadme(basePath, ci);
         canContinue = await prettifyPackageJson(basePath, ci);
         canContinue = await prettifyPackageDistJson(basePath, ci);
     }
 
     if (canContinue && distfiles) {
+        const { buildDistFiles } = await import("./build-distfiles.js");
+
         canContinue = await buildDistFiles(basePath);
     }
 

package/src/create/plugin/plugin.ts

@@ -11,9 +11,8 @@ pluginCommand.description("Create a new tsParticles plugin");
 pluginCommand.argument("<destination>", "Destination folder");
 pluginCommand.action(async (destination: string) => {
     const destPath = await getDestinationDir(destination),
-        repoUrl = await getRepositoryUrl();
-
-    const initialName = destPath.split(path.sep).pop(),
+        repoUrl = await getRepositoryUrl(),
+        initialName = destPath.split(path.sep).pop(),
         questions: PromptObject[] = [
             {
                 type: "text",
@@ -35,13 +34,12 @@ pluginCommand.action(async (destination: string) => {
                 message: "What is the repository URL? (optional)",
                 initial: repoUrl.trim(),
             },
-        ];
-
-    const { name, description, repositoryUrl } = (await prompts(questions)) as {
-        description: string;
-        name: string;
-        repositoryUrl: string;
-    };
+        ],
+        { name, description, repositoryUrl } = (await prompts(questions)) as {
+            description: string;
+            name: string;
+            repositoryUrl: string;
+        };
 
     await createPluginTemplate(name.trim(), description.trim(), repositoryUrl.trim(), destPath);
 });

package/src/create/preset/preset.ts

@@ -11,9 +11,8 @@ presetCommand.description("Create a new tsParticles preset");
 presetCommand.argument("<destination>", "Destination folder");
 presetCommand.action(async (destination: string) => {
     const destPath = await getDestinationDir(destination),
-        repoUrl = await getRepositoryUrl();
-
-    const initialName = destPath.split(path.sep).pop(),
+        repoUrl = await getRepositoryUrl(),
+        initialName = destPath.split(path.sep).pop(),
         questions: PromptObject[] = [
             {
                 type: "text",
@@ -35,13 +34,12 @@ presetCommand.action(async (destination: string) => {
                 message: "What is the repository URL? (optional)",
                 initial: repoUrl.trim(),
             },
-        ];
-
-    const { name, description, repositoryUrl } = (await prompts(questions)) as {
-        description: string;
-        name: string;
-        repositoryUrl: string;
-    };
+        ],
+        { name, description, repositoryUrl } = (await prompts(questions)) as {
+            description: string;
+            name: string;
+            repositoryUrl: string;
+        };
 
     await createPresetTemplate(name.trim(), description.trim(), repositoryUrl.trim(), destPath);
 });

package/src/create/shape/shape.ts

@@ -11,9 +11,8 @@ shapeCommand.description("Create a new tsParticles shape");
 shapeCommand.argument("<destination>", "Destination folder");
 shapeCommand.action(async (destination: string) => {
     const destPath = await getDestinationDir(destination),
-        repoUrl = await getRepositoryUrl();
-
-    const initialName = destPath.split(path.sep).pop(),
+        repoUrl = await getRepositoryUrl(),
+        initialName = destPath.split(path.sep).pop(),
         questions: PromptObject[] = [
             {
                 type: "text",
@@ -35,13 +34,12 @@ shapeCommand.action(async (destination: string) => {
                 message: "What is the repository URL? (optional)",
                 initial: repoUrl.trim(),
             },
-        ];
-
-    const { name, description, repositoryUrl } = (await prompts(questions)) as {
-        description: string;
-        name: string;
-        repositoryUrl: string;
-    };
+        ],
+        { name, description, repositoryUrl } = (await prompts(questions)) as {
+            description: string;
+            name: string;
+            repositoryUrl: string;
+        };
 
     await createShapeTemplate(name.trim(), description.trim(), repositoryUrl.trim(), destPath);
 });

package/src/tsconfig.json

@@ -85,7 +85,7 @@
         /* Ensure that casing is correct in imports. */
 
         /* Type Checking */
-        "strict": true
+        "strict": true,
         /* Enable all strict type-checking options. */
         // "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
         // "strictNullChecks": true,                         /* When type checking, take into account 'null' and 'undefined'. */
@@ -111,5 +111,5 @@
         // "skipLibCheck": true
         /* Skip type checking all .d.ts files. */
     },
-    "references": [{ "path": "../" }]
+    "references": [{ "path": "../" }],
 }

package/tests/create-preset.test.ts

@@ -4,7 +4,7 @@ import { createPresetTemplate } from "../src/create/preset/create-preset";
 import path from "path";
 import fs from "fs-extra";
 
-describe("create-plugin", async () => {
+describe("create-preset", async () => {
     it("should have created the preset project", async () => {
         const destDir = path.resolve(path.join(__dirname, "tmp-files", "foo-preset"));