@tsparticles/cli 3.0.17 → 3.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tsparticles/cli",
-  "version": "3.0.17",
+  "version": "3.1.0",
   "license": "MIT",
   "type": "module",
   "bin": {
@@ -11,20 +11,20 @@
   },
   "prettier": "@tsparticles/prettier-config",
   "dependencies": {
-    "@tsparticles/eslint-config": "^3.0.12",
+    "@tsparticles/eslint-config": "^3.1.0",
     "@tsparticles/prettier-config": "^3.0.11",
-    "@tsparticles/tsconfig": "^3.0.9",
-    "@tsparticles/webpack-plugin": "^3.0.12",
-    "commander": "^14.0.2",
+    "@tsparticles/tsconfig": "^3.1.0",
+    "@tsparticles/webpack-plugin": "^3.1.0",
+    "commander": "^14.0.3",
     "eslint": "^9.39.2",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-jsdoc": "^62.4.1",
+    "eslint-plugin-jsdoc": "^62.5.0",
     "eslint-plugin-prettier": "^5.5.5",
     "eslint-plugin-tsdoc": "^0.5.0",
     "fs-extra": "^11.3.3",
     "klaw": "^4.1.0",
     "lookpath": "^1.2.3",
-    "madge": "^8.0.0",
+    "dependency-cruiser": "^17.3.7",
     "path-scurry": "^2.0.1",
     "prettier": "^3.8.1",
     "prettier-plugin-multiline-arrays": "^4.1.3",
@@ -35,18 +35,15 @@
     "webpack": "^5.104.1"
   },
   "devDependencies": {
-    "@babel/core": "^7.28.6",
-    "@tsparticles/cli": "^3.0.16",
+    "@tsparticles/cli": "^3.0.17",
     "@tsparticles/engine": "^3.9.1",
     "@types/eslint": "^9.6.1",
     "@types/estree": "^1.0.8",
     "@types/fs-extra": "^11.0.4",
     "@types/klaw": "^3.0.7",
-    "@types/madge": "^5.0.3",
-    "@types/node": "^25.0.10",
+    "@types/node": "^25.2.0",
     "@types/prompts": "^2.4.9",
     "@types/webpack-env": "^1.18.8",
-    "babel-loader": "^10.0.0",
     "browserslist": "^4.28.1",
     "copyfiles": "^2.4.1",
     "cross-env": "^10.1.0",
@@ -66,7 +63,7 @@
     "prettify:readme": "prettier --write ./README.md",
     "lint": "eslint src --ext .js,.jsx,.ts,.tsx --fix",
     "lint:ci": "eslint src --ext .js,.jsx,.ts,.tsx",
-    "circular-deps": "madge --circular --extensions ts src",
+    "circular-deps": "depcruise src --include-only '^src' --validate --output-type err-long",
     "compile": "pnpm run build:ts",
     "compile:ci": "pnpm run build:ts",
     "build:ts": "pnpm run build:ts:cjs",

package/pnpm-workspace.yaml

@@ -1,3 +1,4 @@
 onlyBuiltDependencies:
+  - '@swc/core'
   - '@tsparticles/engine'
   - esbuild

package/src/build/build-bundle.ts

@@ -1,4 +1,4 @@
-import path from "path";
+import path from "node:path";
 import webpack from "webpack";
 
 /**

package/src/build/build-circular-deps.ts

@@ -1,39 +1,107 @@
-import madge from "madge";
-import path from "path";
+import {
+  type ICruiseOptions,
+  type ICruiseResult,
+  type IForbiddenRuleType,
+  type IViolation,
+  cruise,
+} from "dependency-cruiser";
+import fs from "fs-extra";
+import path from "node:path";
+
+const ZERO_VIOLATIONS = 0;
 
 /**
- *
- * @param basePath -
+ * Checks for circular dependencies using dependency-cruiser
+ * @param basePath - The project root path
  * @returns true if no circular dependencies are found, false otherwise
  */
 export async function buildCircularDeps(basePath: string): Promise<boolean> {
-  let res = false;
+  const srcPath = path.join(basePath, "src"),
+    configPath = path.join(basePath, ".dependency-cruiser.js"),
+    configPathCjs = path.join(basePath, ".dependency-cruiser.cjs");
+
+  // Base options with explicit type
+  let cruiseOptions: ICruiseOptions = {
+    tsPreCompilationDeps: false,
+    tsConfig: {
+      fileName: path.join(srcPath, "tsconfig.json"),
+    },
+  };
 
   try {
-    const madgeRes = await madge(path.join(basePath, "src"), {
-        fileExtensions: ["ts"],
-        detectiveOptions: {
-          ts: {
-            skipTypeImports: true,
-          },
+    if (await fs.pathExists(configPath)) {
+      const configModule = (await import(configPath)) as {
+          default: {
+            forbidden?: IForbiddenRuleType[];
+            options?: ICruiseOptions;
+          };
         },
-      }),
-      circularDeps = madgeRes.circular();
+        extendedConfig = configModule.default;
 
-    if (circularDeps.length) {
-      console.error("Circular dependencies found!");
+      cruiseOptions = {
+        ...cruiseOptions,
+        ...extendedConfig.options,
+        ruleSet: {
+          forbidden: extendedConfig.forbidden ?? [],
+        },
+      };
+    } else if (await fs.pathExists(configPathCjs)) {
+      const configModule = (await import(configPathCjs)) as {
+          default: {
+            forbidden?: IForbiddenRuleType[];
+            options?: ICruiseOptions;
+          };
+        },
+        extendedConfig = configModule.default;
 
-      for (const dep of circularDeps) {
-        console.error(dep.join(" > "));
-      }
+      cruiseOptions = {
+        ...cruiseOptions,
+        ...extendedConfig.options,
+        ruleSet: {
+          forbidden: extendedConfig.forbidden ?? [],
+        },
+      };
     } else {
-      res = true;
+      console.log("No .dependency-cruiser.js found, applying default circular check.");
+
+      cruiseOptions.ruleSet = {
+        forbidden: [
+          {
+            name: "no-circular",
+            severity: "error",
+            from: {},
+            to: { circular: true },
+          },
+        ],
+      };
+    }
+
+    const result: unknown = await cruise([srcPath], cruiseOptions),
+      cruiseResult = result as ICruiseResult,
+      violations: IViolation[] = cruiseResult.summary.violations,
+      circularViolations = violations.filter((violation: IViolation) => violation.rule.name === "no-circular");
+
+    if (circularViolations.length > ZERO_VIOLATIONS) {
+      console.error("⚠️ Circular dependencies found!");
+
+      for (const violation of circularViolations) {
+        const cyclePath = (violation.cycle ?? []).map(step => {
+          return (step as { name: string }).name;
+        });
+
+        console.error(`Cycle detected: ${cyclePath.join(" -> ")}`);
+      }
+      return false;
     }
-  } catch (e) {
-    console.error(e);
-  }
 
-  console.log("Finished checking circular dependencies.");
+    console.log("✅ No circular dependencies found.");
 
-  return res;
+    return true;
+  } catch (e) {
+    console.error("❌ Error while checking dependencies:", e);
+
+    return false;
+  } finally {
+    console.log("Finished checking circular dependencies.");
+  }
 }

package/src/build/build-clear.ts

@@ -1,4 +1,4 @@
-import path from "path";
+import path from "node:path";
 import { rimraf } from "rimraf";
 
 /**

package/src/build/build-distfiles.ts

@@ -1,6 +1,6 @@
 import fs from "fs-extra";
 import klaw from "klaw";
-import path from "path";
+import path from "node:path";
 
 /**
  * @param basePath -

package/src/build/build-prettier.ts

@@ -1,6 +1,6 @@
 import fs from "fs-extra";
 import klaw from "klaw";
-import path from "path";
+import path from "node:path";
 import prettier from "prettier";
 
 /**

package/src/build/build-tsc.ts

@@ -1,5 +1,5 @@
 import fs from "fs-extra";
-import path from "path";
+import path from "node:path";
 
 enum ExitCodes {
   OK = 0,

package/src/cli.ts

@@ -3,7 +3,7 @@ import { buildCommand } from "./build/build.js";
 import { createCommand } from "./create/create.js";
 import { fileURLToPath } from "url";
 import fs from "fs-extra";
-import path from "path";
+import path from "node:path";
 import { program } from "commander";
 
 const __filename = fileURLToPath(import.meta.url),

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

@@ -9,7 +9,7 @@ import {
   updateWebpackFile,
 } from "../../utils/template-utils.js";
 import fs from "fs-extra";
-import path from "path";
+import path from "node:path";
 import { replaceTokensInFile } from "../../utils/file-utils.js";
 
 /**

package/src/create/plugin/plugin.ts

@@ -3,7 +3,7 @@ import prompts, { type PromptObject } from "prompts";
 import { Command } from "commander";
 import { capitalize } from "../../utils/string-utils.js";
 import { createPluginTemplate } from "./create-plugin.js";
-import path from "path";
+import path from "node:path";
 
 const pluginCommand = new Command("plugin");
 

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

@@ -9,7 +9,7 @@ import {
   updateWebpackFile,
 } from "../../utils/template-utils.js";
 import fs from "fs-extra";
-import path from "path";
+import path from "node:path";
 import { replaceTokensInFile } from "../../utils/file-utils.js";
 
 /**

package/src/create/preset/preset.ts

@@ -3,7 +3,7 @@ import prompts, { type PromptObject } from "prompts";
 import { Command } from "commander";
 import { capitalize } from "../../utils/string-utils.js";
 import { createPresetTemplate } from "./create-preset.js";
-import path from "path";
+import path from "node:path";
 
 const presetCommand = new Command("preset");
 

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

@@ -9,7 +9,7 @@ import {
   updateWebpackFile,
 } from "../../utils/template-utils.js";
 import fs from "fs-extra";
-import path from "path";
+import path from "node:path";
 import { replaceTokensInFile } from "../../utils/file-utils.js";
 
 /**

package/src/create/shape/shape.ts

@@ -3,7 +3,7 @@ import prompts, { type PromptObject } from "prompts";
 import { Command } from "commander";
 import { capitalize } from "../../utils/string-utils.js";
 import { createShapeTemplate } from "./create-shape.js";
-import path from "path";
+import path from "node:path";
 
 const shapeCommand = new Command("shape");
 

package/src/utils/file-utils.ts

@@ -1,7 +1,7 @@
-import { exec } from "child_process";
+import { exec } from "node:child_process";
 import fs from "fs-extra";
 import { lookpath } from "lookpath";
-import path from "path";
+import path from "node:path";
 
 export interface ReplaceTokensOptions {
   path: string;

package/src/utils/template-utils.ts

@@ -1,7 +1,7 @@
-import { exec } from "child_process";
+import { exec } from "node:child_process";
 import fs from "fs-extra";
 import { lookpath } from "lookpath";
-import path from "path";
+import path from "node:path";
 import { replaceTokensInFile } from "./file-utils.js";
 
 /**

package/tests/create-plugin.test.ts

@@ -1,6 +1,6 @@
 import { describe, it, expect } from "vitest";
 import { createPluginTemplate } from "../src/create/plugin/create-plugin.js";
-import path from "path";
+import path from "node:path";
 import fs from "fs-extra";
 
 describe("create-plugin", () => {

package/tests/create-preset.test.ts

@@ -1,6 +1,6 @@
 import { describe, it, expect } from "vitest";
 import { createPresetTemplate } from "../src/create/preset/create-preset.js";
-import path from "path";
+import path from "node:path";
 import fs from "fs-extra";
 
 describe("create-preset", () => {

package/tests/create-shape.test.ts

@@ -1,6 +1,6 @@
 import { describe, it, expect } from "vitest";
 import { createShapeTemplate } from "../src/create/shape/create-shape.js";
-import path from "path";
+import path from "node:path";
 import fs from "fs-extra";
 
 describe("create-shape", () => {

package/tests/file-utils.test.ts

@@ -1,6 +1,6 @@
 import {afterAll, describe, it, expect} from "vitest";
 import fs from "fs-extra";
-import path from "path";
+import path from "node:path";
 import {
     getDestinationDir,
     getRepositoryUrl,

package/tsconfig.json

@@ -24,7 +24,6 @@
             "node",
             "fs-extra",
             "klaw",
-            "madge",
             "prompts",
             "eslint",
             "vitest"