feat: created nx plugin and added integration with nx

Author: matteobruni

README.md

@@ -50,15 +50,43 @@ tsparticles-cli build
 
 ### Build in an Nx workspace
 
-The CLI can now cooperate with Nx instead of always running its internal build pipeline.
+The `build` command can delegate to Nx targets when it detects an Nx workspace.
 
 ```bash
 tsparticles-cli build --nx
 tsparticles-cli build --nx --clean --lint --tsc
+tsparticles-cli build --legacy
 pnpm nx run @tsparticles/cli-command-build:tsc
 ```
 
-Inside this repository, the local plugin `@tsparticles/cli-nx-plugin` augments package-based projects with canonical tsParticles targets like `clean`, `prettify`, `prettify:ci`, and `tsc`, while preserving the existing npm script names.
+- `--nx`: forces Nx-target execution when required targets exist
+- `--legacy`: disables Nx-aware mode and runs the original in-process pipeline
+- default behavior in this workspace: with no granular flags, `build`/`build:ci` Nx aggregate targets are preferred when available
+
+Inside this repository, the local plugin `@tsparticles/cli-nx-plugin` augments package projects under `commands/*` and `packages/*` with canonical aliases like `clean`, `prettify`, `prettify:ci`, `tsc`, `bundle`, and `distfiles`.
+
+## Workspace commands (development)
+
+From the `cli` root:
+
+```bash
+pnpm run show:projects
+pnpm run build
+pnpm run build:affected
+pnpm run build:ci
+pnpm run lint
+pnpm run lint:ci
+pnpm run test
+pnpm run test:ci
+```
+
+### Focused Nx commands
+
+```bash
+pnpm nx show project @tsparticles/cli-command-build --json
+pnpm nx run @tsparticles/cli-command-build:build
+pnpm nx run @tsparticles/cli-nx-plugin:build
+```
 
 ### Create
 

commands/build/README.md

@@ -82,6 +82,17 @@ The CLI now looks for these canonical build-step targets first and falls back to
 
 The workspace-local Nx plugin `@tsparticles/cli-nx-plugin` infers the canonical aliases automatically for packages in this repository, so packages can keep their current npm scripts while exposing friendlier Nx targets.
 
+### Verify in this workspace
+
+From the `cli` root, these commands validate the Nx integration end-to-end:
+
+```bash
+pnpm nx show project @tsparticles/cli-command-build --json
+pnpm nx run @tsparticles/cli-command-build:tsc
+pnpm nx run @tsparticles/cli-command-build:test
+pnpm run build
+```
+
 ### Create
 
 #### Preset

package.json

@@ -3,9 +3,14 @@
   "version": "0.0.0",
   "private": true,
   "scripts": {
-    "build": "nx run-many -t build",
-    "build:ci": "nx run-many -t build:ci",
-    "test": "nx run-many -t test"
+    "build": "pnpm nx run-many -t build",
+    "build:affected": "pnpm nx affected -t build",
+    "build:ci": "pnpm nx run-many -t build:ci",
+    "lint": "pnpm nx run-many -t lint",
+    "lint:ci": "pnpm nx run-many -t lint:ci",
+    "show:projects": "pnpm nx show projects",
+    "test": "pnpm nx run-many -t test",
+    "test:ci": "pnpm nx run-many -t test:ci"
   },
   "devDependencies": {
     "@nx/devkit": "^22.7.1",

packages/nx-plugin/README.md

@@ -8,6 +8,8 @@ Internal Nx plugin used by the `tsParticles CLI` workspace.
 
 The plugin augments package-based Nx projects under `commands/*` and `packages/*` with canonical tsParticles build-step aliases.
 
+It is enabled in the workspace `nx.json` via the `@tsparticles/cli-nx-plugin` entry in `plugins`.
+
 ### Canonical aliases inferred by the plugin
 
 | Canonical target | Script fallback                       |
@@ -27,3 +29,13 @@ pnpm nx run @tsparticles/cli-command-build:clean
 ```
 
 without forcing every package to rename its existing npm scripts.
+
+## Verify plugin behavior
+
+From the `cli` root:
+
+```bash
+pnpm nx show project @tsparticles/cli-command-build --json
+pnpm nx show projects --withTarget tsc
+pnpm nx run @tsparticles/cli-nx-plugin:test
+```