Merge pull request #664 from devforth/feature/AdminForth/1704/create-json-editor-plugin

fix: add documentation for af edit json field plugin

Author: yaroslav8765

adminforth/documentation/docs/tutorial/09-Plugins/28-json-editor.md

@@ -0,0 +1,65 @@
+---
+title: JSON Editor
+description: "Guide to the JSON Editor plugin — add, edit and delete key-value pairs stored as a JSON object in a database column."
+slug: /tutorial/Plugins/json-editor
+---
+
+# JSON Editor
+
+The JSON Editor plugin replaces the default text input for JSON columns with a structured key-value editor. Users can add, edit, and delete individual pairs without writing raw JSON.
+
+Values support all standard JSON types: strings, numbers, booleans, `null`, arrays, and nested objects.
+
+## Installation
+
+```bash
+pnpm install @adminforth/json-editor --save
+```
+
+## Setting up
+
+Import and attach the plugin to an existing column in your resource:
+
+```ts title="./resources/apartments.ts"
+//diff-add
+import JsonEditorPlugin from '@adminforth/json-editor';
+
+export default {
+  ...
+  plugins: [
+    ...
+//diff-add
+    new JsonEditorPlugin({
+//diff-add
+      fieldName: 'description',
+//diff-add
+    }),
+  ],
+}
+```
+
+> The plugin works on columns with type `json`, `string`, or `text`. The stored value must be a JSON object (`{}`). Top-level arrays and primitives are not supported.
+
+![alt text](json-plugin-example.png)
+
+## Value types
+
+Values are entered in JSON notation:
+
+| Input | Saved as |
+|---|---|
+| `"hello"` | string |
+| `42` | number |
+| `true` / `false` | boolean |
+| `null` | null |
+| `[1, "x", true]` | array |
+| `{"key": 1}` | nested object |
+
+## Validation
+
+Saving is blocked when:
+
+- **Duplicate keys** - two rows share the same key name.
+- **Invalid JSON value** - the value field is not valid JSON (e.g. `hello` without quotes). The error identifies the row: `Row 2: value is not valid JSON`.
+
+An empty value field is allowed and saved as an empty string `""`.