@robot-admin/naive-ui-components 0.17.4 → 0.17.5

package/dist/verification.d.cts

@@ -76,26 +76,26 @@ declare const __VLS_export: vue.DefineComponent<CaptchaProps, {
   reset: () => void;
   show: () => void;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+  change: (valid: boolean) => any;
   success: (data: CaptchaSuccessPayload) => any;
+  reset: () => any;
+  "load-error": (error: unknown) => any;
   fail: (error: string) => any;
   "verify-error": (error: unknown) => any;
-  "load-error": (error: unknown) => any;
-  change: (valid: boolean) => any;
   "visible-change": (visible: boolean) => any;
-  reset: () => any;
 }, string, vue.PublicProps, Readonly<CaptchaProps> & Readonly<{
+  onChange?: ((valid: boolean) => any) | undefined;
   onSuccess?: ((data: CaptchaSuccessPayload) => any) | undefined;
+  onReset?: (() => any) | undefined;
+  "onLoad-error"?: ((error: unknown) => any) | undefined;
   onFail?: ((error: string) => any) | undefined;
   "onVerify-error"?: ((error: unknown) => any) | undefined;
-  "onLoad-error"?: ((error: unknown) => any) | undefined;
-  onChange?: ((valid: boolean) => any) | undefined;
   "onVisible-change"?: ((visible: boolean) => any) | undefined;
-  onReset?: (() => any) | undefined;
 }>, {
-  provider: CaptchaProvider;
-  images: string[];
   disabled: boolean;
   theme: "light" | "dark";
+  provider: CaptchaProvider;
+  images: string[];
   verificationTimeout: number;
   requireServerVerification: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;

package/dist/verification.d.ts

@@ -76,26 +76,26 @@ declare const __VLS_export: vue.DefineComponent<CaptchaProps, {
   reset: () => void;
   show: () => void;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
+  change: (valid: boolean) => any;
   success: (data: CaptchaSuccessPayload) => any;
+  reset: () => any;
+  "load-error": (error: unknown) => any;
   fail: (error: string) => any;
   "verify-error": (error: unknown) => any;
-  "load-error": (error: unknown) => any;
-  change: (valid: boolean) => any;
   "visible-change": (visible: boolean) => any;
-  reset: () => any;
 }, string, vue.PublicProps, Readonly<CaptchaProps> & Readonly<{
+  onChange?: ((valid: boolean) => any) | undefined;
   onSuccess?: ((data: CaptchaSuccessPayload) => any) | undefined;
+  onReset?: (() => any) | undefined;
+  "onLoad-error"?: ((error: unknown) => any) | undefined;
   onFail?: ((error: string) => any) | undefined;
   "onVerify-error"?: ((error: unknown) => any) | undefined;
-  "onLoad-error"?: ((error: unknown) => any) | undefined;
-  onChange?: ((valid: boolean) => any) | undefined;
   "onVisible-change"?: ((visible: boolean) => any) | undefined;
-  onReset?: (() => any) | undefined;
 }>, {
-  provider: CaptchaProvider;
-  images: string[];
   disabled: boolean;
   theme: "light" | "dark";
+  provider: CaptchaProvider;
+  images: string[];
   verificationTimeout: number;
   requireServerVerification: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;

package/docs/guides/usage.en.md

@@ -411,6 +411,14 @@ Default, inline, and grid layouts are synchronous. Card, tabs, steps, dynamic, a
 
 For `C_Tree`, read `tree.value?.selectedKeys`, `expandedKeys`, and `checkedKeys` directly as arrays with `ref<TreeExpose>()`. Prefer `v-model:*` for controlled state. The standalone `useTreeOperations()` composable retains internal refs.
 
+### Table editing validation
+
+`required` and `editProps.rules` share the same extraction and native validation semantics in modal, row, and cell editing. Use Naive `FormItemRule` entries such as `{ type: 'email', message: 'Invalid email' }`. Number and switch editors infer their basic type unless explicitly specified. Prefer Promise-based async rules; `asyncValidator` callbacks are supported too. Warning-level rules do not block saves.
+
+Selection, expansion, index, and action columns are automatically excluded from generated form fields. Read-only business columns remain excluded. Numeric field keys are converted to form field strings. Existing configuration and compatibility entries remain supported.
+
+Read `TimeExpose.startTime/endTime/singleTime` directly as numbers or null, and `MenuExpose.menuRef` directly as the native menu instance or null. Vue unwraps these top-level exposed refs.
+
 ### Table pagination, selection, and export
 
 `TableProps<Row>` includes `config`, `crud`, `remote`, and `virtualScrollX`; columns and data may be omitted when supplied by CRUD. Legacy edit, expansion, and selection prop types remain as compatibility declarations; component features belong in `config`.

package/docs/guides/usage.md

@@ -472,6 +472,14 @@ function preview() {
 
 `C_Tree` 的公开实例遵循同一规则：`ref<TreeExpose>()` 后直接读取 `tree.value?.selectedKeys`、`expandedKeys` 和 `checkedKeys` 数组，受控状态仍推荐通过 `v-model:*` 管理。独立 `useTreeOperations()` 返回的内部状态保持 Ref。
 
+### 表格编辑校验
+
+`required` 和 `editProps.rules` 在弹窗、行编辑、单元格编辑中使用同一口径。类型规则沿用 Naive 的 `FormItemRule`，例如 `{ type: 'email', message: '请输入正确邮箱' }`；数字与开关编辑器可推断基础类型，也可显式指定 `type`。异步规则推荐返回 Promise，`asyncValidator` 也支持 callback。警告级规则不阻止保存。
+
+选择、展开、序号和操作列自动排除于编辑字段，业务侧无需为它们额外声明 `editable: false`。`editable: false` 的业务列仍只读；字段键为数字时转换成表单字段字符串。校验规则属于 `rules`，编辑控件属性属于 `attrs`，组件内部统一完成转换。旧兼容入口按弃用说明继续保留。
+
+`C_Time` 的 `TimeExpose.startTime/endTime/singleTime` 直接读取数值或 null；`C_Menu` 的 `MenuExpose.menuRef` 直接读取原生菜单实例或 null，均无需第二层 `.value`。
+
 ### 表格分页、选择与导出
 
 `TableProps<Row>` 支持 `config`、`crud`、`remote` 与 `virtualScrollX`；CRUD 绑定已提供列和数据时不必重复传入。旧编辑、展开和选择属性类型仅保留兼容声明，组件功能统一放在 `config` 中。

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.17.4",
+  "version": "0.17.5",
   "description": "基于 Naive UI 的 Vue 3 组件库",
   "packageManager": "bun@1.3.14",
   "engines": {
@@ -132,6 +132,7 @@
     }
   },
   "dependencies": {
+    "async-validator": "4.2.5",
     "@antv/x6": "^2.19.2",
     "@chenfengyuan/vue-barcode": "^2.0.2",
     "@fullcalendar/core": "^6.1.21",