@zhin.js/schema 1.0.73 → 1.1.1

package/README.md

@@ -124,21 +124,35 @@ const formatter = Schema.resolve('number')
 
 ## 与 Zhin.js 集成
 
-在插件中使用 `defineSchema` 定义配置（自动注册到 Web 控制台表单渲染）：
-
-```typescript
-import { usePlugin, Schema } from 'zhin.js'
-
-const { defineSchema } = usePlugin()
+Plugin Runtime 的配置契约由插件根目录 `schema.json` 声明，Runtime 在候选代装配前统一校验并填充默认值：
+
+```json
+{
+  "type": "object",
+  "properties": {
+    "port": { "type": "number", "default": 8080 },
+    "enabled": { "type": "boolean", "default": true }
+  },
+  "additionalProperties": false
+}
+```
 
-const getConfig = defineSchema(Schema.object({
-  port: Schema.number().default(8080).description('服务端口'),
-  enabled: Schema.boolean().default(true).description('是否启用'),
-}))
+插件从 generation-owned `ConfigView` 读取已验证配置：
 
-const config = getConfig()
+```typescript
+import { definePlugin } from 'zhin.js'
+
+export default definePlugin<{ port: number; enabled: boolean }>({
+  name: 'example',
+  setup({ config }) {
+    const current = config.get()
+    console.log(current.port, current.enabled)
+  },
+})
 ```
 
+`@zhin.js/schema` 继续用于业务输入的运行时解析；它不承担 Plugin Runtime 配置注册。
+
 ## 工具函数
 
 - `isEmpty(value)` - 检查值是否为空（`undefined`、`null`、空字符串、空数组、空对象）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/schema",
-  "version": "1.0.73",
+  "version": "1.1.1",
   "description": "Configuration validation and schema system for Zhin.js",
   "type": "module",
   "main": "./lib/index.js",