docs: usage statement

Author: cloydlau

README.md

@@ -77,7 +77,7 @@ If you want to specify dependency versions:
 }
 ```
 
-Or scoped:
+or scoped:
 
 ```json5
 // package.json
@@ -963,6 +963,48 @@ If you prefer the behavior of svelte-jsoneditor:
 />
 ```
 
+If you want to ensure you always get parsed JSON in text mode:
+
+> [!Caution]
+>
+> Not performant for large JSON documents.
+
+```ts
+createApp(App)
+  .use(JsonEditorVue, {
+    mode: 'text',
+    mainMenuBar: false,
+    onChange(updatedContent) {
+      if (updatedContent.text) {
+        try {
+          updatedContent.json = JSON.parse(updatedContent.text)
+        }
+        catch {}
+        updatedContent.text = undefined
+      }
+    },
+  })
+  .mount('#app')
+```
+
+or without `try...catch`:
+
+```html
+<JsonEditorVue
+  ref="jsonEditorVueRef"
+  mode="text"
+  :main-menu-bar="false"
+  :on-change="(updatedContent) => {
+    if (updatedContent.text) {
+      if (!jsonEditorVueRef.jsonEditor.validate()) {
+        updatedContent.json = JSON.parse(updatedContent.text)
+      }
+      updatedContent.text = undefined
+    }
+  }"
+/>
+```
+
 > See https://github.com/josdejong/svelte-jsoneditor/pull/166 for more details.
 
 ### Boolean properties

docs/README.zh-CN.md

@@ -961,6 +961,48 @@ module.exports = {
 />
 ```
 
+如果你想确保在 text 模式中总是得到 “parsed JSON”：
+
+> [!Caution]
+>
+> 对于大型 JSON 文档性能不佳
+
+```ts
+createApp(App)
+  .use(JsonEditorVue, {
+    mode: 'text',
+    mainMenuBar: false,
+    onChange(updatedContent) {
+      if (updatedContent.text) {
+        try {
+          updatedContent.json = JSON.parse(updatedContent.text)
+        }
+        catch {}
+        updatedContent.text = undefined
+      }
+    },
+  })
+  .mount('#app')
+```
+
+或不使用 `try...catch`:
+
+```html
+<JsonEditorVue
+  ref="jsonEditorVueRef"
+  mode="text"
+  :main-menu-bar="false"
+  :on-change="(updatedContent) => {
+    if (updatedContent.text) {
+      if (!jsonEditorVueRef.jsonEditor.validate()) {
+        updatedContent.json = JSON.parse(updatedContent.text)
+      }
+      updatedContent.text = undefined
+    }
+  }"
+/>
+```
+
 > 详情见 https://github.com/josdejong/svelte-jsoneditor/pull/166
 
 ### 布尔类型属性

package.json

@@ -76,7 +76,7 @@
     "vue-demi": "^0.14.7"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "^2.13.2",
+    "@antfu/eslint-config": "^2.13.3",
     "@commitlint/cli": "^19.2.1",
     "@commitlint/config-conventional": "^19.1.0",
     "@types/cross-spawn": "^6.0.6",
@@ -108,7 +108,7 @@
     "rollup-plugin-visualizer": "^5.12.0",
     "semver": "^7.6.0",
     "simple-git-hooks": "^2.11.1",
-    "typescript": "^5.4.4",
+    "typescript": "^5.4.5",
     "unplugin-auto-import": "^0.17.5",
     "unplugin-vue-components": "^0.26.0",
     "vite": "^5.2.8",