feat(plugin): add compatibility matrix generator

- Add generate-compat-matrix.mjs script to generate version compatibility data
- Add compat-matrix.config.json as git-versioned source of truth
- Output to dist/libs/plugin/compat-matrix.json for CDN access via unpkg

Features:
- Combined matrix: angular-three + three.js + angular + ngxtension versions
- Per-package matrix: each package with its specific peer dependencies
- Breaking change detection: auto-updates ranges when min version increases
- Supports all semver range formats: >=, ^, ~, with/without upper bounds

Usage:
- Run after build: node tools/scripts/generate-compat-matrix.mjs
- Access via CDN: https://unpkg.com/angular-three-plugin@latest/compat-matrix.json

Author: nartc

nx.json

@@ -202,7 +202,7 @@
 	"release": {
 		"projects": ["core", "cannon", "postprocessing", "soba", "rapier", "plugin", "tweakpane", "theatre"],
 		"version": {
-			"preVersionCommand": "npm run package",
+			"preVersionCommand": "pnpm package",
 			"currentVersionResolver": "git-tag",
 			"preserveLocalDependencyProtocols": false,
 			"manifestRootsToUpdate": ["dist/libs/{projectName}"]

package.json

@@ -51,6 +51,7 @@
 		"@tweakpane/core": "^2.0.5",
 		"@types/jest": "30.0.0",
 		"@types/node": "20.14.12",
+		"@types/semver": "^7.7.1",
 		"@types/three": "^0.182.0",
 		"@typescript-eslint/utils": "8.50.1",
 		"@vitest/coverage-v8": "^4.0.16",
@@ -84,6 +85,7 @@
 		"postprocessing": "^6.38.2",
 		"prettier": "^3.7.4",
 		"prettier-plugin-organize-imports": "^4.3.0",
+		"semver": "^7.7.3",
 		"storybook": "10.1.10",
 		"storybook-addon-deep-controls": "^0.10.0",
 		"tailwindcss": "^4.1.18",
@@ -157,6 +159,9 @@
 					],
 					"parallel": true
 				}
+			},
+			"generate-compat": {
+				"command": "node ./tools/scripts/generate-compat-matrix.mjs"
 			}
 		}
 	},

pnpm-lock.yaml

@@ -0,0 +1,110 @@
+{
+	"$schema": "https://angular-threejs.github.io/schemas/compat-matrix.schema.json",
+	"generated": "2026-01-06T00:00:00.000Z",
+	"description": "Compatibility matrix for angular-three ecosystem packages",
+	"combined": [
+		{
+			"angularThree": ">=4.0.0",
+			"three": ">=0.157.0 <0.183.0",
+			"angular": ">=20.0.0 <22.0.0",
+			"ngxtension": ">=3.0.0"
+		}
+	],
+	"packages": {
+		"angular-three": {
+			"displayName": "Core",
+			"entries": [
+				{
+					"version": ">=4.0.0",
+					"peerDependencies": {
+						"ngxtension": ">=3.0.0"
+					}
+				}
+			]
+		},
+		"angular-three-soba": {
+			"displayName": "Soba",
+			"entries": [
+				{
+					"version": ">=4.0.0",
+					"peerDependencies": {
+						"@monogrid/gainmap-js": "^3.0.0",
+						"@pmndrs/vanilla": "^1.24.0",
+						"camera-controls": "^2.8.0",
+						"hls.js": ">=1.5.0",
+						"maath": ">=0.10.0 <0.11.0",
+						"meshline": "^3.1.0",
+						"stats-gl": ">=2.0.0",
+						"three-custom-shader-material": ">=5.5.0 <6.5.0",
+						"three-mesh-bvh": ">=0.5.0 <0.10.0",
+						"three-stdlib": "^2.0.0",
+						"troika-three-text": ">=0.47.0 <0.53.0"
+					}
+				}
+			]
+		},
+		"angular-three-cannon": {
+			"displayName": "Cannon",
+			"entries": [
+				{
+					"version": ">=4.0.0",
+					"peerDependencies": {
+						"@pmndrs/cannon-worker-api": "^2.0.0",
+						"cannon-es": ">=0.20.0 <0.21.0",
+						"cannon-es-debugger": "^1.0.0"
+					}
+				}
+			]
+		},
+		"angular-three-rapier": {
+			"displayName": "Rapier",
+			"entries": [
+				{
+					"version": ">=4.0.0",
+					"peerDependencies": {
+						"@dimforge/rapier3d-compat": ">=0.14.0 <0.20.0",
+						"three-stdlib": "^2.0.0"
+					}
+				}
+			]
+		},
+		"angular-three-postprocessing": {
+			"displayName": "Postprocessing",
+			"entries": [
+				{
+					"version": ">=4.0.0",
+					"peerDependencies": {
+						"maath": ">=0.10.0 <0.11.0",
+						"n8ao": ">=1.9.4 <2.0.0",
+						"postprocessing": "^6.0.0",
+						"three-stdlib": "^2.0.0"
+					}
+				}
+			]
+		},
+		"angular-three-theatre": {
+			"displayName": "Theatre",
+			"entries": [
+				{
+					"version": ">=4.0.0",
+					"peerDependencies": {
+						"@theatre/core": ">=0.7.0 <0.8.0",
+						"@theatre/studio": ">=0.7.0 <0.8.0"
+					}
+				}
+			]
+		},
+		"angular-three-tweakpane": {
+			"displayName": "Tweakpane",
+			"entries": [
+				{
+					"version": ">=4.0.0",
+					"peerDependencies": {
+						"@tweakpane/core": "^2.0.0",
+						"tweakpane": "^4.0.0"
+					}
+				}
+			]
+		}
+	}
+}