@robot-admin/naive-ui-components 0.19.0 → 0.20.0

package/dist/useWorkflowValidation.d.cts

@@ -261,22 +261,22 @@ declare const __VLS_export: vue.DefineComponent<WorkflowProps, {
   "update:modelValue": (value: WorkflowData) => any;
   change: (value: WorkflowData) => any;
   save: (data: WorkflowData) => any;
+  "validate-error": (errors: ValidationError[]) => any;
   "node-click": (node: WorkflowNode<NodeType>) => any;
   "edge-click": (edge: WorkflowEdge) => 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;
+  "onValidate-error"?: ((errors: ValidationError[]) => any) | undefined;
   "onNode-click"?: ((node: WorkflowNode<NodeType>) => any) | undefined;
   "onEdge-click"?: ((edge: WorkflowEdge) => any) | undefined;
-  "onValidate-error"?: ((errors: ValidationError[]) => any) | undefined;
 }>, {
+  readonly: boolean;
   theme: "light" | "dark";
   users: User[];
   roles: Role[];
   departments: Department[];
-  readonly: boolean;
   allowCycles: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
@@ -303,10 +303,19 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "start";
+    type: "copy";
     data: {
+      copyUsers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
       title: string;
-      status: "active";
+      status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -336,19 +345,10 @@ 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: "start";
     data: {
-      copyUsers?: {
-        id: string;
-        name: string;
-        avatar?: string | undefined;
-        department: string;
-        role: string;
-        email?: string | undefined;
-        phone?: string | undefined;
-      }[] | undefined;
       title: string;
-      status?: NodeStatus | undefined;
+      status: "active";
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -461,10 +461,19 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "start";
+    type: "copy";
     data: {
+      copyUsers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
       title: string;
-      status: "active";
+      status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -494,19 +503,10 @@ 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: "start";
     data: {
-      copyUsers?: {
-        id: string;
-        name: string;
-        avatar?: string | undefined;
-        department: string;
-        role: string;
-        email?: string | undefined;
-        phone?: string | undefined;
-      }[] | undefined;
       title: string;
-      status?: NodeStatus | undefined;
+      status: "active";
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -672,10 +672,19 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "start";
+    type: "copy";
     data: {
+      copyUsers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
       title: string;
-      status: "active";
+      status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -705,19 +714,10 @@ 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: "start";
     data: {
-      copyUsers?: {
-        id: string;
-        name: string;
-        avatar?: string | undefined;
-        department: string;
-        role: string;
-        email?: string | undefined;
-        phone?: string | undefined;
-      }[] | undefined;
       title: string;
-      status?: NodeStatus | undefined;
+      status: "active";
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -830,10 +830,19 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "start";
+    type: "copy";
     data: {
+      copyUsers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
       title: string;
-      status: "active";
+      status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -863,19 +872,10 @@ 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: "start";
     data: {
-      copyUsers?: {
-        id: string;
-        name: string;
-        avatar?: string | undefined;
-        department: string;
-        role: string;
-        email?: string | undefined;
-        phone?: string | undefined;
-      }[] | undefined;
       title: string;
-      status?: NodeStatus | undefined;
+      status: "active";
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -1047,10 +1047,19 @@ declare function useWorkflowPreview(nodes: Ref<WorkflowNode[]>, edges: Ref<Workf
       zIndex?: number | undefined;
       extent?: "parent" | [[number, number], [number, number]] | undefined;
       expandParent?: boolean | undefined;
-      type: "start";
+      type: "copy";
       data: {
+        copyUsers?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
         title: string;
-        status: "active";
+        status?: NodeStatus | undefined;
         config?: Record<string, unknown> | undefined;
         initiators?: {
           id: string;
@@ -1080,19 +1089,10 @@ 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: "start";
       data: {
-        copyUsers?: {
-          id: string;
-          name: string;
-          avatar?: string | undefined;
-          department: string;
-          role: string;
-          email?: string | undefined;
-          phone?: string | undefined;
-        }[] | undefined;
         title: string;
-        status?: NodeStatus | undefined;
+        status: "active";
         config?: Record<string, unknown> | undefined;
         initiators?: {
           id: string;
@@ -1222,10 +1222,19 @@ declare function useWorkflowPreview(nodes: Ref<WorkflowNode[]>, edges: Ref<Workf
       zIndex?: number | undefined;
       extent?: "parent" | [[number, number], [number, number]] | undefined;
       expandParent?: boolean | undefined;
-      type: "start";
+      type: "copy";
       data: {
+        copyUsers?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
         title: string;
-        status: "active";
+        status?: NodeStatus | undefined;
         config?: Record<string, unknown> | undefined;
         initiators?: {
           id: string;
@@ -1255,19 +1264,10 @@ 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: "start";
       data: {
-        copyUsers?: {
-          id: string;
-          name: string;
-          avatar?: string | undefined;
-          department: string;
-          role: string;
-          email?: string | undefined;
-          phone?: string | undefined;
-        }[] | undefined;
         title: string;
-        status?: NodeStatus | undefined;
+        status: "active";
         config?: Record<string, unknown> | undefined;
         initiators?: {
           id: string;

package/dist/useWorkflowValidation.d.ts

@@ -261,22 +261,22 @@ declare const __VLS_export: vue.DefineComponent<WorkflowProps, {
   "update:modelValue": (value: WorkflowData) => any;
   change: (value: WorkflowData) => any;
   save: (data: WorkflowData) => any;
+  "validate-error": (errors: ValidationError[]) => any;
   "node-click": (node: WorkflowNode<NodeType>) => any;
   "edge-click": (edge: WorkflowEdge) => 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;
+  "onValidate-error"?: ((errors: ValidationError[]) => any) | undefined;
   "onNode-click"?: ((node: WorkflowNode<NodeType>) => any) | undefined;
   "onEdge-click"?: ((edge: WorkflowEdge) => any) | undefined;
-  "onValidate-error"?: ((errors: ValidationError[]) => any) | undefined;
 }>, {
+  readonly: boolean;
   theme: "light" | "dark";
   users: User[];
   roles: Role[];
   departments: Department[];
-  readonly: boolean;
   allowCycles: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
@@ -303,10 +303,19 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "start";
+    type: "copy";
     data: {
+      copyUsers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
       title: string;
-      status: "active";
+      status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -336,19 +345,10 @@ 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: "start";
     data: {
-      copyUsers?: {
-        id: string;
-        name: string;
-        avatar?: string | undefined;
-        department: string;
-        role: string;
-        email?: string | undefined;
-        phone?: string | undefined;
-      }[] | undefined;
       title: string;
-      status?: NodeStatus | undefined;
+      status: "active";
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -461,10 +461,19 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "start";
+    type: "copy";
     data: {
+      copyUsers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
       title: string;
-      status: "active";
+      status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -494,19 +503,10 @@ 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: "start";
     data: {
-      copyUsers?: {
-        id: string;
-        name: string;
-        avatar?: string | undefined;
-        department: string;
-        role: string;
-        email?: string | undefined;
-        phone?: string | undefined;
-      }[] | undefined;
       title: string;
-      status?: NodeStatus | undefined;
+      status: "active";
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -672,10 +672,19 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "start";
+    type: "copy";
     data: {
+      copyUsers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
       title: string;
-      status: "active";
+      status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -705,19 +714,10 @@ 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: "start";
     data: {
-      copyUsers?: {
-        id: string;
-        name: string;
-        avatar?: string | undefined;
-        department: string;
-        role: string;
-        email?: string | undefined;
-        phone?: string | undefined;
-      }[] | undefined;
       title: string;
-      status?: NodeStatus | undefined;
+      status: "active";
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -830,10 +830,19 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     zIndex?: number | undefined;
     extent?: "parent" | [[number, number], [number, number]] | undefined;
     expandParent?: boolean | undefined;
-    type: "start";
+    type: "copy";
     data: {
+      copyUsers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
       title: string;
-      status: "active";
+      status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -863,19 +872,10 @@ 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: "start";
     data: {
-      copyUsers?: {
-        id: string;
-        name: string;
-        avatar?: string | undefined;
-        department: string;
-        role: string;
-        email?: string | undefined;
-        phone?: string | undefined;
-      }[] | undefined;
       title: string;
-      status?: NodeStatus | undefined;
+      status: "active";
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -1047,10 +1047,19 @@ declare function useWorkflowPreview(nodes: Ref<WorkflowNode[]>, edges: Ref<Workf
       zIndex?: number | undefined;
       extent?: "parent" | [[number, number], [number, number]] | undefined;
       expandParent?: boolean | undefined;
-      type: "start";
+      type: "copy";
       data: {
+        copyUsers?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
         title: string;
-        status: "active";
+        status?: NodeStatus | undefined;
         config?: Record<string, unknown> | undefined;
         initiators?: {
           id: string;
@@ -1080,19 +1089,10 @@ 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: "start";
       data: {
-        copyUsers?: {
-          id: string;
-          name: string;
-          avatar?: string | undefined;
-          department: string;
-          role: string;
-          email?: string | undefined;
-          phone?: string | undefined;
-        }[] | undefined;
         title: string;
-        status?: NodeStatus | undefined;
+        status: "active";
         config?: Record<string, unknown> | undefined;
         initiators?: {
           id: string;
@@ -1222,10 +1222,19 @@ declare function useWorkflowPreview(nodes: Ref<WorkflowNode[]>, edges: Ref<Workf
       zIndex?: number | undefined;
       extent?: "parent" | [[number, number], [number, number]] | undefined;
       expandParent?: boolean | undefined;
-      type: "start";
+      type: "copy";
       data: {
+        copyUsers?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
         title: string;
-        status: "active";
+        status?: NodeStatus | undefined;
         config?: Record<string, unknown> | undefined;
         initiators?: {
           id: string;
@@ -1255,19 +1264,10 @@ 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: "start";
       data: {
-        copyUsers?: {
-          id: string;
-          name: string;
-          avatar?: string | undefined;
-          department: string;
-          role: string;
-          email?: string | undefined;
-          phone?: string | undefined;
-        }[] | undefined;
         title: string;
-        status?: NodeStatus | undefined;
+        status: "active";
         config?: Record<string, unknown> | undefined;
         initiators?: {
           id: string;

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;
   reset: () => any;
+  success: (data: CaptchaSuccessPayload) => any;
+  "load-error": (error: unknown) => 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;
+  "onLoad-error"?: ((error: unknown) => 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;
 }>, {
-  disabled: boolean;
   theme: "light" | "dark";
+  disabled: boolean;
   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;
   reset: () => any;
+  success: (data: CaptchaSuccessPayload) => any;
+  "load-error": (error: unknown) => 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;
+  "onLoad-error"?: ((error: unknown) => 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;
 }>, {
-  disabled: boolean;
   theme: "light" | "dark";
+  disabled: boolean;
   provider: CaptchaProvider;
   images: string[];
   verificationTimeout: number;

package/docs/guides/usage.en.md

@@ -671,3 +671,9 @@ Define domain models in the application. Components preserve their types without
 CRUD bindings remain structural. `@robot-admin/request-core` 0.6.3 accepts component columns directly, without application converters or a dependency between the two packages.
 
 For a concrete business model, enable dynamic insertion with the existing `dynamicRows.defaultRowData` factory returning a complete row and valid unique key; `false` still disables it directly. Factory keys retain their original type. Copying with a string key preserves business fields and takes a fresh key from the factory. With a function key, the factory receives an optional source copy and returns a complete new record. Missing, duplicate or invalid factory keys report failure without changing data. Open dynamic records retain the legacy empty-row shorthand.
+
+## Breadcrumb directory navigation
+
+`C_Breadcrumb` keeps automatic route and manual `items` modes. Optional `menus` accepts the host's authorized menu tree directly (`path/key`, `label/meta.title`, `children`); the component emits `select(path)` and leaves authorization and navigation to the application. Supplying an empty menu explicitly exposes no route-derived shortcuts. Hidden entries and unresolved parameterized leaves are omitted from shortcuts, while the active detail page remains visible unless explicitly excluded with `meta.breadcrumb: false`.
+
+Parent buttons open a themed directory panel with page counts and current-page feedback. Narrow containers collapse intermediate path segments. Arrow keys, Home/End, Enter/Space and Escape are supported. Readonly inputs remain unchanged, disabled directories disable their descendants, and route/query/menu/size changes close stale panels. Generic text uses the existing component locale service. Existing `items`, `showIcon`, `iconSize`, `labelFormatter` and `select` remain available; manual labels are not translated again.

package/docs/guides/usage.md

@@ -754,3 +754,20 @@ loading.finish(id)
 CRUD 控制器只需满足结构契约；`@robot-admin/request-core` 0.6.3 起可直接接收组件列，无需应用内列转换器。组件库与请求包保持独立依赖关系。
 
 明确业务模型启用动态增行时，提供已有 `dynamicRows.defaultRowData` 工厂返回完整记录和合法唯一主键；`false` 仍可直接关闭。工厂主键不会被组件改成字符串。复制使用字符串主键时保留原业务字段、从工厂取得新主键；函数主键场景由工厂接收可选原行副本并返回完整新记录。缺失、重复或无效主键会反馈失败并保持原数据。宽松动态记录继续支持原有空行简写。
+
+## 面包屑与目录导航
+
+`C_Breadcrumb` 默认根据当前路由生成路径；父级点击展开目录，末项标识当前页。可选 `menus` 直接接收宿主已授权的菜单（`path/key`、`label/meta.title`、`children`），无需转换成 Naive UI 菜单选项。
+
+```vue
+<C_Breadcrumb
+  :menus="permissionStore.showMenuListGet"
+  :label-formatter="translateRouteTitle"
+  :show-icon="settingsStore.showBreadcrumbIcon"
+  @select="navigateTo"
+/>
+```
+
+组件只发出 `select(path)`，不执行路由跳转或权限请求。传入 `menus`（包括空数组）后，目录仅使用这份数据；隐藏项、无标题占位和不可直接跳转的动态参数叶页不进入快捷导航。隐藏详情页仍保留当前路径，显式 `meta.breadcrumb: false` 可隐藏对应层级。未传 `menus` 时继续使用路由子项；原生路由表并非权限边界，业务项目应传入与侧栏同源的授权菜单。
+
+已有 `items` 手动路径继续优先，标签沿用传入值并接受只读嵌套数据，`disabled` 对目录整支生效。完整路径在窄容器中自动收拢，保留当前页；目录支持方向键、Home/End、Enter/Space 和 Escape。颜色跟随 Naive 主题，浮层中的通用文案使用既有组件国际化服务。组件不保存菜单快照、不读取应用 Store，也不改写传入数据。

package/package.json

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