@ea-lab/reactive-json 0.0.40 → 0.0.41

package/.cursorrules

@@ -30,6 +30,17 @@
 - For **creating/developing** React components → use `extend/component-development.md`
 - For **using/configuring** components in JSON/YAML → use `core/[category]/`
 
+## Plugin System Requirements
+
+**⚠️ CRITICAL**: When using custom components as plugins, `mergeComponentCollections([...])` is **MANDATORY** - even for a single plugin collection. The reactive-json plugin system will NOT work without it.
+
+```js
+import {ReactiveJsonRoot, mergeComponentCollections} from "@ea-lab/reactive-json";
+
+const plugins = mergeComponentCollections([customPlugins]); // REQUIRED
+return <ReactiveJsonRoot {...props} plugins={plugins} />;
+```
+
 ## Component Validation Rules
 
 1. For each component, STRICTLY verify:

package/README.md

@@ -108,7 +108,7 @@ The `ReactiveJsonRoot` component accepts the following properties:
 - `dataUrl`: The URL of the document containing the build data (JSON or YAML)
 - `dataFetchMethod`: The fetch method for the data ("GET" or "POST", case-insensitive)
 - `headersForData`: Headers for the data request (e.g., authentication info)
-- `plugins`: Reactive-JSON plugins to extend functionality
+- `plugins`: Reactive-JSON plugins to extend functionality (**must** use `mergeComponentCollections`)
 - `debugMode`: Debug mode to show the data structure and debug info
 - `maybeRawAppData`: A RjBuild configuration to initialize directly (string or object)
 

package/README_LLM.md

@@ -316,6 +316,8 @@ export const CustomRoot = (props) => {
 };
 ```
 
+**⚠️ CRITICAL**: `mergeComponentCollections([...])` is **mandatory** even when you have only a single plugin collection. The reactive-json plugin system will not work without it.
+
 ### Plugin Structure
 ```js
 {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ea-lab/reactive-json",
   "private": false,
-  "version": "0.0.40",
+  "version": "0.0.41",
   "type": "module",
   "repository": {
     "type": "git",