@robot-admin/naive-ui-components 0.17.1 → 0.17.3

package/dist/useWorkflowValidation.d.ts

@@ -118,6 +118,8 @@ interface WorkflowProps {
   departments?: Department[];
   modelValue?: WorkflowData;
   readonly?: boolean;
+  /** 是否允许循环连接，默认 true。无环审批流程应设为 false；执行规则由业务后端校验。 */
+  allowCycles?: boolean;
   theme?: 'light' | 'dark';
 }
 interface WorkflowEmits {
@@ -237,25 +239,26 @@ declare const __VLS_export: vue.DefineComponent<WorkflowProps, {
     conditionNodes: number;
   }>;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  change: (value: WorkflowData) => any;
   "update:modelValue": (value: WorkflowData) => any;
+  change: (value: WorkflowData) => any;
   save: (data: WorkflowData) => any;
-  "validate-error": (errors: ValidationError[]) => any;
   "node-click": (node: WorkflowNode) => any;
   "edge-click": (edge: WorkflowEdge) => any;
+  "validate-error": (errors: ValidationError[]) => any;
 }, string, vue.PublicProps, Readonly<WorkflowProps> & Readonly<{
-  onChange?: ((value: WorkflowData) => any) | undefined;
   "onUpdate:modelValue"?: ((value: WorkflowData) => any) | undefined;
+  onChange?: ((value: WorkflowData) => any) | undefined;
   onSave?: ((data: WorkflowData) => any) | undefined;
-  "onValidate-error"?: ((errors: ValidationError[]) => any) | undefined;
   "onNode-click"?: ((node: WorkflowNode) => any) | undefined;
   "onEdge-click"?: ((edge: WorkflowEdge) => any) | undefined;
+  "onValidate-error"?: ((errors: ValidationError[]) => any) | undefined;
 }>, {
   theme: "light" | "dark";
   readonly: boolean;
   users: User[];
   roles: Role[];
   departments: Department[];
+  allowCycles: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion
@@ -1019,6 +1022,8 @@ interface WorkflowValidationOptions {
   onShowNodeConfig?: (node: WorkflowNode) => void;
   /** 验证失败时的外部回调（通常用于 emit） */
   onValidateError?: (errors: ValidationError[]) => void;
+  /** 默认允许循环以兼容通用流程；审批业务可显式关闭。 */
+  allowCycles?: boolean | (() => boolean);
 }
 /** 工作流验证 —— 封装流程校验逻辑、错误展示和节点定位 */
 declare function useWorkflowValidation(nodes: Ref<WorkflowNode[]>, edges: Ref<WorkflowEdge[]>, vueFlowRef: Ref, options?: WorkflowValidationOptions): {

package/dist/verification.d.cts

@@ -77,23 +77,23 @@ declare const __VLS_export: vue.DefineComponent<CaptchaProps, {
   show: () => void;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
   change: (valid: boolean) => any;
-  success: (data: CaptchaSuccessPayload) => any;
-  "load-error": (error: unknown) => 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;
-  "onLoad-error"?: ((error: unknown) => 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;
   "onVisible-change"?: ((visible: boolean) => any) | undefined;
 }>, {
-  theme: "light" | "dark";
   disabled: boolean;
+  theme: "light" | "dark";
   provider: CaptchaProvider;
   images: string[];
   verificationTimeout: number;

package/dist/verification.d.ts

@@ -77,23 +77,23 @@ declare const __VLS_export: vue.DefineComponent<CaptchaProps, {
   show: () => void;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
   change: (valid: boolean) => any;
-  success: (data: CaptchaSuccessPayload) => any;
-  "load-error": (error: unknown) => 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;
-  "onLoad-error"?: ((error: unknown) => 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;
   "onVisible-change"?: ((visible: boolean) => any) | undefined;
 }>, {
-  theme: "light" | "dark";
   disabled: boolean;
+  theme: "light" | "dark";
   provider: CaptchaProvider;
   images: string[];
   verificationTimeout: number;

package/docs/components.en.md

@@ -99,6 +99,8 @@ Image/calendar behavior notes: `C_ImageCropper` flips the actual source and rese
 
 `C_VtableGantt` merges presets and `options` without dropping untouched nested settings, replaces arrays as a whole, and ignores prototype-related keys. Its fullscreen button reflects the actual fullscreen state of that Gantt container.
 
+If Gantt initialization or rebuilding fails, a released `ganttInstance` is cleared, an error and retry button appear, and an `error` event emits an `Error`. The component instance exposes `loading`, `error`, and asynchronous `reload()` for status feedback and retries. Wait for `ganttCreated` before operating on a replacement engine instance.
+
 `C_AudioPlayer` enters the playing state and emits `play` only after the browser accepts `play()`. A rejected autoplay emits `error`, and an empty playlist cannot emit a false play event. Mute, playlist tracks, and seeking are keyboard operable.
 
 `C_CollapsePanel` and `C_TagsView` validate persisted data before restoring it, so corrupt or outdated JSON cannot break initialization. Persisted tags restore only in-app paths, and special characters in a path are no longer interpolated into CSS selectors.
@@ -107,6 +109,8 @@ Image/calendar behavior notes: `C_ImageCropper` flips the actual source and rese
 
 `C_WorkFlow` loads the supplied `modelValue` on first render and returns isolated snapshots from `getCurrentWorkflowData()`, `save`, `change`, and `node-click`, so callers cannot accidentally mutate its internal nodes. Editing conditions cannot change canvas data before Save, and incomplete conditions are not silently dropped. `readonly` blocks dragging, connecting, configuring, adding/removing, and saving while leaving preview, validation, and fit-to-view available. Node and condition IDs remain unique when created in the same tick.
 
+Workflow validation requires unique, nonempty node and edge IDs, exactly one start node, existing edge endpoints, and directed reachability from the start to every node. `allowCycles` defaults to `true` for general workflows with loops. Use `:allow-cycles="false"` for acyclic approval flows; a detected cycle blocks saving and produces a structural error that can be located on the canvas. This option supports runtime changes. Passing validation confirms graph structure and node configuration; execution, permissions, and business rules remain the responsibility of the business backend.
+
 Type verification covers TypeScript source, Vue SFC templates, and consumer examples built against the package. `C_Table` summary rendering expects an object keyed by column (`{ columnKey: { value, colSpan? } }`). `C_FormSearch` preserves existing numeric timestamp ranges and also supports formatted string ranges, binding each to the matching Naive UI value API.
 
 Runtime component dependencies are declared by this package and resolved automatically. Every consumer needs:

package/docs/components.md

@@ -99,6 +99,8 @@
 
 `C_VtableGantt` 合并预设与 `options` 时会保留未覆盖的嵌套配置、以新数组整体替换旧数组，并忽略原型相关键；全屏按钮状态仅反映该甘特图容器的实际全屏状态。
 
+甘特图初始化或重建失败时，会清空已释放的 `ganttInstance`、显示错误及重试按钮，并触发 `error` 事件（参数为 `Error`）。组件实例公开 `loading`、`error` 和异步 `reload()`，使用侧可据此展示状态或主动重试；等待 `ganttCreated` 后再操作新的底层实例。
+
 `C_AudioPlayer` 只在浏览器确认 `play()` 成功后进入播放状态并触发 `play`；自动播放被拒绝时会触发 `error`，空播放列表不会产生虚假的播放事件。静音、曲目和进度条均可用键盘操作。
 
 `C_CollapsePanel` 与 `C_TagsView` 会校验本地持久化数据结构；损坏或旧格式数据会安全回退，不会阻断组件初始化。持久化标签仅恢复站内路径，特殊字符路径的定位不会拼接 CSS 选择器。
@@ -107,6 +109,8 @@
 
 `C_WorkFlow` 会在首次渲染时加载传入的 `modelValue`，并在 `getCurrentWorkflowData()` / `save` / `change` / `node-click` 中输出隔离的数据快照，避免调用方意外修改内部节点。条件编辑弹窗在保存前不会修改画布数据，未填完整的条件不会被静默丢弃。`readonly` 禁止节点拖拽、连线、配置、增删与保存，但仍允许预览、验证和适应视图；节点与条件 ID 在同一时刻连续创建时保持唯一。
 
+流程校验要求节点与连线标识唯一且非空、恰有一个开始节点、连线两端存在，且所有节点可从开始节点按连线方向到达。`allowCycles` 默认 `true`，兼容包含回路的通用流程；无环审批流程使用 `:allow-cycles="false"`，发现循环时阻止保存并定位结构错误。该选项可动态更新；校验结果仅代表图结构与节点配置合法，审批执行、权限和业务规则仍由业务后端负责。
+
 类型验证同时覆盖 TypeScript 源码、Vue 单文件组件模板和发布后的使用侧示例。`C_Table` 合计行的 `summary.render` 应返回按列键组织的对象（`{ columnKey: { value, colSpan? } }`）；`C_FormSearch` 的日期范围兼容原有数字时间戳数组，也支持格式化字符串数组，两种值会分别绑定 Naive UI 对应的值接口。
 
 组件运行依赖已由本包声明，安装组件库时会自动解析。所有场景都需要：

package/docs/guides/table-density.md

@@ -85,3 +85,9 @@ const columns: TableColumn<Order>[] = [
 若所有业务列都显式指定宽度，且总宽小于容器，保留原生表格的剩余空间分配规则；这时声明的 `width` 不保证等于最后测量的像素。通常让名称或描述列保持弹性，比给所有列设宽更合适。虚拟横向滚动仍需按 Naive UI 的契约提供具体列宽。
 
 独立的列 `renderExpand` 直接转交原生表格；配置 `config.expand.onLoadData / renderContent` 后由组件的加载、失败重试和内容渲染器接管展开区。不要同时配置两套展开内容并依赖原生渲染器优先。自动横向滚动宽度按最终可见列计算，包含辅助列、动态选择列和操作列，不再额外追加固定留白。
+
+## 行拖拽的组合范围
+
+`config.rowDrag: true` 按稳定 `rowKey` 重排当前页的顶层行。树表的子行、详情展开内容及合计行不参与拖拽；移动父行时其子树数据整体保留，不改变父子关系。过滤、排序与分页后的行位置会映射回原始数据，其余页和隐藏行保持不变。使用侧继续接收 `update:data` 和 `row-move`，无须自行计算 DOM 下标。
+
+纵向 `config.virtualScroll` 或横向 `virtualScrollX` 开启时，行拖拽自动停用，避免局部窗口错误重排完整数据；退出虚拟模式后恢复。拖拽期间数据被替换或身份变化，会丢弃该次排序。行键必须唯一、稳定，数字与字符串按各自类型区分。空数据后加载、错误视图恢复等表体重新出现的场景会自动连接拖拽实例。

package/package.json

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