@robot-admin/naive-ui-components 0.13.6 → 0.13.7

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @robot-admin/naive-ui-components
 
+## 0.13.7
+
+- `C_Form` 正式集成 `@robot-admin/form-validate@3.4.2`，统一消费原生规则、验证库规则和 `RuleSpec`，并通过表单入口导出已适配的 `PRESET_RULES`、`NAIVE_COMBOS` 与 `SPEC_RULES`。
+- 提供默认步骤提交按钮和 `action-extra` 业务操作插槽，复用组件内部的校验、防重复提交、加载与错误反馈；成功/重置提示由业务按需配置。
+- 修复规则回调异常后提交跳过校验的问题；提交支持取消信号，组件卸载后不继续触发提交事件或成功提示，禁用/只读状态不能通过实例方法绕过。
+
 ## 0.13.6
 
 ### Patch Changes

package/README.md

@@ -198,7 +198,42 @@ import '@robot-admin/naive-ui-components/C_Table/base.css'
 </template>
 ```
 
-自定义操作栏应调用 `action` 插槽的 `submit()`，不要用 `validate()` 代替提交。步骤布局的 `step-actions` 插槽同时提供 `isLastStep`、`submit()` 和 `submitting`，可在最后一步直接放置提交按钮。异步保存放在 `config.onSubmit` 中并等待完成；`@submit` 是保存成功后的通知事件，不承诺等待监听器返回的 Promise。
+表单已内置 `@robot-admin/form-validate`，使用侧无需另写类型适配，也不用重复安装验证依赖。`rules` / `rulesWhen` 直接接受 Naive UI 原生规则、验证库的 `NaiveRule` 和框架无关的 `RuleSpec`，可以混用；`required: true` 同样复用验证库的空值判断，`0` 和 `false` 不会被误判为空。
+
+```ts
+import {
+  defineFormOptions,
+  PRESET_RULES,
+  NAIVE_COMBOS,
+  SPEC_RULES,
+} from '@robot-admin/naive-ui-components/C_Form'
+
+const fields = defineFormOptions([
+  {
+    type: 'input',
+    prop: 'name',
+    label: '名称',
+    required: true,
+    rules: [SPEC_RULES.length('名称', 2, 20)],
+  },
+  {
+    type: 'input',
+    prop: 'email',
+    label: '邮箱',
+    rules: NAIVE_COMBOS.email('邮箱'),
+  },
+  {
+    type: 'input',
+    prop: 'mobile',
+    label: '手机号',
+    rules: [PRESET_RULES.mobile('手机号')],
+  },
+])
+```
+
+普通表单默认提供提交与重置，步骤表单最后一步默认提供提交按钮。只需配置 `submitText`、`resetText` 和 `onSubmit`；要增加预览等业务操作，使用 `action-extra` 插槽即可保留默认按钮和加载管理。需要完全定制时仍可覆盖 `action` / `step-actions`，并调用插槽的 `submit()`，不要用 `validate()` 代替提交。
+
+异步保存放在 `config.onSubmit` 中并等待完成；`@submit` 是完成后的通知事件，不等待监听器返回的 Promise。第二参数提供 `context?.signal`，可直接传给支持取消的请求；组件卸载会发出取消信号，并停止晚到的提交事件和提示。`submitSuccessText` / `resetSuccessText` 为可选反馈文案，默认不显示成功提示，也不代表数据已持久化。
 
 新增/编辑场景推荐用 `C_FormModal` 直接消费 Headless CRUD 的结构化 `editor`。字段、校验和布局继续由 `C_Form` 配置驱动，页面不再重复编写 Modal、按钮、loading 和草稿状态；默认采用紧凑小尺寸表单和右下角带图标操作按钮，宽度、表单尺寸与动作文案仍可覆盖：
 

package/README_EN.md

@@ -166,7 +166,42 @@ const { model, formRef, bindings } = useCForm({
 })
 ```
 
-Custom action bars should call the `action` slot's `submit()` rather than treating `validate()` as submission. The step-layout `step-actions` slot also provides `isLastStep`, `submit()`, and `submitting`. Put asynchronous persistence in `config.onSubmit`; the `@submit` event is a post-success notification and does not await an event listener's promise.
+`C_Form` includes `@robot-admin/form-validate`; consumers need no local type adapter or separate validation installation. `rules` and `rulesWhen` accept native Naive UI rules, the package's `NaiveRule`, and framework-independent `RuleSpec` objects, including mixed lists. `required: true` uses the same empty-value rules and preserves valid `0` and `false` values.
+
+```ts
+import {
+  defineFormOptions,
+  PRESET_RULES,
+  NAIVE_COMBOS,
+  SPEC_RULES,
+} from '@robot-admin/naive-ui-components/C_Form'
+
+const fields = defineFormOptions([
+  {
+    type: 'input',
+    prop: 'name',
+    label: 'Name',
+    required: true,
+    rules: [SPEC_RULES.length('Name', 2, 20)],
+  },
+  {
+    type: 'input',
+    prop: 'email',
+    label: 'Email',
+    rules: NAIVE_COMBOS.email('Email'),
+  },
+  {
+    type: 'input',
+    prop: 'mobile',
+    label: 'Mobile',
+    rules: [PRESET_RULES.mobile('Mobile')],
+  },
+])
+```
+
+Normal forms provide submit/reset controls; step forms provide a submit button on their last step. Configure `submitText`, `resetText`, and `onSubmit`. Use `action-extra` for business controls such as previews while retaining the built-in buttons and loading state. Full customization remains available through `action` and `step-actions`; call the slot's `submit()` rather than treating `validate()` as submission.
+
+Put asynchronous work in `config.onSubmit`; `@submit` is a completion notification and does not await an event listener's promise. The second argument provides `context?.signal` for cancellable requests. Unmount aborts that signal and suppresses late submit events and feedback. `submitSuccessText` and `resetSuccessText` opt in to feedback; no success message is shown by default, and validation alone does not imply persistence.
 
 For create/edit flows, `C_FormModal` consumes a structural headless `editor` directly. Fields, validation, and layout remain data-driven by `C_Form`, while pages no longer own duplicate modal, draft, or loading state: