@robot-admin/naive-ui-components 0.24.5 → 0.25.0

package/dist/useWorkflowValidation.d.ts

@@ -261,16 +261,16 @@ declare const __VLS_export: vue.DefineComponent<WorkflowProps, {
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   "update:modelValue": (value: WorkflowData) => any;
   change: (value: WorkflowData) => any;
-  save: (data: WorkflowData) => any;
   "node-click": (node: WorkflowNode<NodeType>) => any;
   "edge-click": (edge: WorkflowEdge) => any;
+  save: (data: WorkflowData) => any;
   "validate-error": (errors: ValidationError[]) => any;
 }, string, vue.PublicProps, Readonly<WorkflowProps> & Readonly<{
   "onUpdate:modelValue"?: ((value: WorkflowData) => any) | undefined;
   onChange?: ((value: WorkflowData) => any) | undefined;
-  onSave?: ((data: WorkflowData) => any) | undefined;
   "onNode-click"?: ((node: WorkflowNode<NodeType>) => any) | undefined;
   "onEdge-click"?: ((edge: WorkflowEdge) => any) | undefined;
+  onSave?: ((data: WorkflowData) => any) | undefined;
   "onValidate-error"?: ((errors: ValidationError[]) => any) | undefined;
 }>, {
   theme: "light" | "dark";
@@ -337,9 +337,9 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "approval";
+    type: "copy";
     data: {
-      approvers?: {
+      copyUsers?: {
         id: string;
         name: string;
         avatar?: string | undefined;
@@ -348,7 +348,6 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
         email?: string | undefined;
         phone?: string | undefined;
       }[] | undefined;
-      approvalMode?: ApprovalMode | undefined;
       title: string;
       status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
@@ -380,9 +379,9 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "copy";
+    type: "approval";
     data: {
-      copyUsers?: {
+      approvers?: {
         id: string;
         name: string;
         avatar?: string | undefined;
@@ -391,6 +390,7 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
         email?: string | undefined;
         phone?: string | undefined;
       }[] | undefined;
+      approvalMode?: ApprovalMode | undefined;
       title: string;
       status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
@@ -495,9 +495,9 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "approval";
+    type: "copy";
     data: {
-      approvers?: {
+      copyUsers?: {
         id: string;
         name: string;
         avatar?: string | undefined;
@@ -506,7 +506,6 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
         email?: string | undefined;
         phone?: string | undefined;
       }[] | undefined;
-      approvalMode?: ApprovalMode | undefined;
       title: string;
       status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
@@ -538,9 +537,9 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "copy";
+    type: "approval";
     data: {
-      copyUsers?: {
+      approvers?: {
         id: string;
         name: string;
         avatar?: string | undefined;
@@ -549,6 +548,7 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
         email?: string | undefined;
         phone?: string | undefined;
       }[] | undefined;
+      approvalMode?: ApprovalMode | undefined;
       title: string;
       status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
@@ -706,9 +706,9 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "approval";
+    type: "copy";
     data: {
-      approvers?: {
+      copyUsers?: {
         id: string;
         name: string;
         avatar?: string | undefined;
@@ -717,7 +717,6 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
         email?: string | undefined;
         phone?: string | undefined;
       }[] | undefined;
-      approvalMode?: ApprovalMode | undefined;
       title: string;
       status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
@@ -749,9 +748,9 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "copy";
+    type: "approval";
     data: {
-      copyUsers?: {
+      approvers?: {
         id: string;
         name: string;
         avatar?: string | undefined;
@@ -760,6 +759,7 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
         email?: string | undefined;
         phone?: string | undefined;
       }[] | undefined;
+      approvalMode?: ApprovalMode | undefined;
       title: string;
       status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
@@ -864,9 +864,9 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "approval";
+    type: "copy";
     data: {
-      approvers?: {
+      copyUsers?: {
         id: string;
         name: string;
         avatar?: string | undefined;
@@ -875,7 +875,6 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
         email?: string | undefined;
         phone?: string | undefined;
       }[] | undefined;
-      approvalMode?: ApprovalMode | undefined;
       title: string;
       status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
@@ -907,9 +906,9 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "copy";
+    type: "approval";
     data: {
-      copyUsers?: {
+      approvers?: {
         id: string;
         name: string;
         avatar?: string | undefined;
@@ -918,6 +917,7 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
         email?: string | undefined;
         phone?: string | undefined;
       }[] | undefined;
+      approvalMode?: ApprovalMode | undefined;
       title: string;
       status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
@@ -1088,9 +1088,9 @@ declare function useWorkflowPreview(nodes: Ref<WorkflowNode[]>, edges: Ref<Workf
       zIndex?: number | undefined;
       extent?: "parent" | [[number, number], [number, number]] | undefined;
       expandParent?: boolean | undefined;
-      type: "approval";
+      type: "copy";
       data: {
-        approvers?: {
+        copyUsers?: {
           id: string;
           name: string;
           avatar?: string | undefined;
@@ -1099,7 +1099,6 @@ declare function useWorkflowPreview(nodes: Ref<WorkflowNode[]>, edges: Ref<Workf
           email?: string | undefined;
           phone?: string | undefined;
         }[] | undefined;
-        approvalMode?: ApprovalMode | undefined;
         title: string;
         status?: NodeStatus | undefined;
         config?: Record<string, unknown> | undefined;
@@ -1131,9 +1130,9 @@ declare function useWorkflowPreview(nodes: Ref<WorkflowNode[]>, edges: Ref<Workf
       zIndex?: number | undefined;
       extent?: "parent" | [[number, number], [number, number]] | undefined;
       expandParent?: boolean | undefined;
-      type: "copy";
+      type: "approval";
       data: {
-        copyUsers?: {
+        approvers?: {
           id: string;
           name: string;
           avatar?: string | undefined;
@@ -1142,6 +1141,7 @@ declare function useWorkflowPreview(nodes: Ref<WorkflowNode[]>, edges: Ref<Workf
           email?: string | undefined;
           phone?: string | undefined;
         }[] | undefined;
+        approvalMode?: ApprovalMode | undefined;
         title: string;
         status?: NodeStatus | undefined;
         config?: Record<string, unknown> | undefined;
@@ -1263,9 +1263,9 @@ declare function useWorkflowPreview(nodes: Ref<WorkflowNode[]>, edges: Ref<Workf
       zIndex?: number | undefined;
       extent?: "parent" | [[number, number], [number, number]] | undefined;
       expandParent?: boolean | undefined;
-      type: "approval";
+      type: "copy";
       data: {
-        approvers?: {
+        copyUsers?: {
           id: string;
           name: string;
           avatar?: string | undefined;
@@ -1274,7 +1274,6 @@ declare function useWorkflowPreview(nodes: Ref<WorkflowNode[]>, edges: Ref<Workf
           email?: string | undefined;
           phone?: string | undefined;
         }[] | undefined;
-        approvalMode?: ApprovalMode | undefined;
         title: string;
         status?: NodeStatus | undefined;
         config?: Record<string, unknown> | undefined;
@@ -1306,9 +1305,9 @@ declare function useWorkflowPreview(nodes: Ref<WorkflowNode[]>, edges: Ref<Workf
       zIndex?: number | undefined;
       extent?: "parent" | [[number, number], [number, number]] | undefined;
       expandParent?: boolean | undefined;
-      type: "copy";
+      type: "approval";
       data: {
-        copyUsers?: {
+        approvers?: {
           id: string;
           name: string;
           avatar?: string | undefined;
@@ -1317,6 +1316,7 @@ declare function useWorkflowPreview(nodes: Ref<WorkflowNode[]>, edges: Ref<Workf
           email?: string | undefined;
           phone?: string | undefined;
         }[] | undefined;
+        approvalMode?: ApprovalMode | undefined;
         title: string;
         status?: NodeStatus | undefined;
         config?: Record<string, unknown> | undefined;

package/dist/verification.d.cts

@@ -77,16 +77,16 @@ declare const __VLS_export: vue.DefineComponent<CaptchaProps, {
   show: () => void;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
   change: (valid: boolean) => any;
-  success: (data: CaptchaSuccessPayload) => any;
   reset: () => any;
+  success: (data: CaptchaSuccessPayload) => any;
   fail: (error: string) => any;
   "verify-error": (error: unknown) => any;
   "load-error": (error: unknown) => any;
   "visible-change": (visible: boolean) => any;
 }, string, vue.PublicProps, Readonly<CaptchaProps> & Readonly<{
   onChange?: ((valid: boolean) => any) | undefined;
-  onSuccess?: ((data: CaptchaSuccessPayload) => any) | undefined;
   onReset?: (() => any) | undefined;
+  onSuccess?: ((data: CaptchaSuccessPayload) => any) | undefined;
   onFail?: ((error: string) => any) | undefined;
   "onVerify-error"?: ((error: unknown) => any) | undefined;
   "onLoad-error"?: ((error: unknown) => any) | undefined;

package/dist/verification.d.ts

@@ -77,16 +77,16 @@ declare const __VLS_export: vue.DefineComponent<CaptchaProps, {
   show: () => void;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
   change: (valid: boolean) => any;
-  success: (data: CaptchaSuccessPayload) => any;
   reset: () => any;
+  success: (data: CaptchaSuccessPayload) => any;
   fail: (error: string) => any;
   "verify-error": (error: unknown) => any;
   "load-error": (error: unknown) => any;
   "visible-change": (visible: boolean) => any;
 }, string, vue.PublicProps, Readonly<CaptchaProps> & Readonly<{
   onChange?: ((valid: boolean) => any) | undefined;
-  onSuccess?: ((data: CaptchaSuccessPayload) => any) | undefined;
   onReset?: (() => any) | undefined;
+  onSuccess?: ((data: CaptchaSuccessPayload) => any) | undefined;
   onFail?: ((error: string) => any) | undefined;
   "onVerify-error"?: ((error: unknown) => any) | undefined;
   "onLoad-error"?: ((error: unknown) => any) | undefined;

package/docs/guides/data-workflows.md

@@ -30,11 +30,20 @@ app.use(Components, {
 - `getOptions()`：同步快照，编码保留 string/number/boolean 类型。
 - `load({ signal })`：可选的异步准备；视图会忽略已失效的请求。
 - `subscribe(listener)`：可选的更新通知，返回取消订阅函数。
+- `getState()`：可选的共享状态快照，`status` 为 `idle/loading/ready/empty/error`，失败时可带 `error`。提供它时，订阅同时通知状态变化；源应先更新快照再通知。未提供时保持原有协议。
+
+状态快照可选带 `options`，这代表该数组不可变，并且与 `getOptions()` 返回同一份数据。此时仅加载／失败变化不会复制选项或重建翻译索引。未提供这个承诺的旧源仍支持修改原数组后发出订阅通知。
+
+初次绑定调用 `load({ signal })`，字段或表格的显式重试调用 `load({ signal, force: true })`。源负责合并同一字典的并发请求，某个控件卸载仅取消自己的等待，不能打断其他使用者。空数组是成功的空字典，不应通过抛错表示空结果。
+
+表单和搜索就地显示失败与重试，表格只显示一条按字典源去重的状态条；失败保留旧标签和原值，不逐单元格弹消息。`C_Form.getDictionaryError(field)` 可读取诊断，显式 `config.onError` 仍可观测表单异常。组件不把字典错误当作字段业务校验错误，也不会覆盖校验提示。表格的显式 `feedback.error` 继续可选接管诊断。
 
 应用已有 store/resolver 时直接桥接，不叠加第二套 TTL 缓存。源负责组织、租户、语言和业务参数隔离：请求开始时捕获作用域，参数切换后不得把旧响应写进新作用域。可由 `getDictionary` 返回该作用域的稳定源，或发布当前快照变更通知。组件仅管理可销毁的选项视图及派生索引。
 
 选项必须是有效且唯一的原始编码、字符串标签及可选 boolean disabled。空数组是已提供的空选项，不回退到旧数据。未知编码原样回显；停用历史编码可以保留在源中供展示。重复标签在反向解析时报告歧义，不自动选择第一项。高频展示使用 `createDictionaryLabelResolver(options)`，快照变化时重建一次索引。
 
+数组编码逐项翻译，以 `、` 连接；空数组显示为空。字符串编码不按逗号或其他字符自动拆分。普通枚举仅负责文字转换，状态色仍由表格列的 `status` 显式声明。
+
 ## 数值：存储、显示和校验分别定义
 
 ```ts

package/docs/guides/form-density.en.md

@@ -45,6 +45,8 @@ Density presets are plain data and preserve lazy loading of layouts and fields.
 
 Compact modals leave 10px between the header and first field and 12px on either side. Bottom spacing does not constrain real validation feedback. Viewport limits keep the header and footer visible while long content scrolls. Native Card section styles affect only the modal shell, preserving nested cards and slots without adding per-field measurements or watchers.
 
+`C_Table` editor dialogs share these section styles and viewport limits. `edit.modalWidth` is in pixels and defaults to 600. A configured width of 700 remains 700px on desktop and is capped at the viewport width minus 24px on narrow screens. Fields collapse from two columns to one as needed. Invalid numeric widths fall back to the default; saving, cancellation and validation retain their existing edit-session behavior.
+
 ## Application defaults with on-demand imports
 
 Provide defaults once during application startup. Local `config.density` takes precedence; search inherits only density, not form layout, callbacks or size.

package/docs/guides/form-density.md

@@ -62,6 +62,8 @@ const largeFields = { density: 'compact', size: 'large' } as const
 
 紧凑弹窗在标题底部与首行字段之间保留 10px，内容两侧为 12px；末行保留底部留白，不压缩实际校验提示。弹窗宽高受视口约束，长表单仅内容区滚动，标题和页脚保持可见。外壳使用原生 Card 分区样式，不修改内嵌业务卡片或插槽的间距，也不增加逐字段测量或监听。
 
+`C_Table` 的编辑弹窗共用这套分区与视口约束。`edit.modalWidth` 单位为 px，默认 600；如配置 700，桌面以 700px 居中，窄屏最多为视口宽度减 24px。表单按容器宽度从两列收为单列，数值宽度必须为有限正数，无效数值使用默认宽度。保存、取消及校验职责保持在表格原有编辑会话中。
+
 ## 按需设置应用默认值
 
 在应用启动时提供一次即可，局部的 `config.density` 优先，搜索只继承密度，不继承表单布局、回调或尺寸。

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.24.5",
+  "version": "0.25.0",
   "description": "基于 Naive UI 的 Vue 3 组件库",
   "packageManager": "bun@1.4.2",
   "engines": {