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

package/dist/useWorkflowValidation.d.ts

@@ -1,5 +1,6 @@
 import * as vue from "vue";
 import { Component, Ref } from "vue";
+import { Connection, EdgeChange, EdgeUpdateEvent, NodeChange } from "@vue-flow/core";
 
 //#region src/components/C_WorkFlow/types.d.ts
 /**
@@ -272,8 +273,8 @@ declare const __VLS_export: vue.DefineComponent<WorkflowProps, {
   "onNode-click"?: ((node: WorkflowNode<NodeType>) => any) | undefined;
   "onEdge-click"?: ((edge: WorkflowEdge) => any) | undefined;
 }>, {
-  readonly: boolean;
   theme: "light" | "dark";
+  readonly: boolean;
   users: User[];
   roles: Role[];
   departments: Department[];
@@ -303,19 +304,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;
@@ -345,10 +337,20 @@ 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: "approval";
     data: {
+      approvers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+      approvalMode?: ApprovalMode | undefined;
       title: string;
-      status: "active";
+      status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -378,9 +380,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;
@@ -389,7 +391,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;
@@ -461,19 +462,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;
@@ -503,10 +495,20 @@ 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: "approval";
     data: {
+      approvers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+      approvalMode?: ApprovalMode | undefined;
       title: string;
-      status: "active";
+      status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -536,9 +538,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;
@@ -547,7 +549,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;
@@ -672,19 +673,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;
@@ -714,10 +706,20 @@ 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: "approval";
     data: {
+      approvers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+      approvalMode?: ApprovalMode | undefined;
       title: string;
-      status: "active";
+      status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -747,9 +749,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;
@@ -758,7 +760,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;
@@ -830,19 +831,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;
@@ -872,10 +864,20 @@ 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: "approval";
     data: {
+      approvers?: {
+        id: string;
+        name: string;
+        avatar?: string | undefined;
+        department: string;
+        role: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+      }[] | undefined;
+      approvalMode?: ApprovalMode | undefined;
       title: string;
-      status: "active";
+      status?: NodeStatus | undefined;
       config?: Record<string, unknown> | undefined;
       initiators?: {
         id: string;
@@ -905,9 +907,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;
@@ -916,7 +918,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;
@@ -978,6 +979,13 @@ declare function useWorkflowNodes(props: WorkflowProps, emit: EmitFn$1, vueFlowR
     copyNodes: number;
     conditionNodes: number;
   }>;
+  commitCanvasChange: () => void;
+  handleCanvasChanges: (changes: NodeChange[] | EdgeChange[]) => void;
+  connectNodes: (connection: Connection) => void;
+  updateConnection: ({
+    edge,
+    connection
+  }: EdgeUpdateEvent) => void;
   addNode: (type: NodeType) => void;
   onNodeClick: (event: {
     node: {
@@ -1047,19 +1055,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;
@@ -1089,10 +1088,20 @@ 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: "approval";
       data: {
+        approvers?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
+        approvalMode?: ApprovalMode | undefined;
         title: string;
-        status: "active";
+        status?: NodeStatus | undefined;
         config?: Record<string, unknown> | undefined;
         initiators?: {
           id: string;
@@ -1122,9 +1131,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;
@@ -1133,7 +1142,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;
@@ -1222,19 +1230,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;
@@ -1264,10 +1263,20 @@ 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: "approval";
       data: {
+        approvers?: {
+          id: string;
+          name: string;
+          avatar?: string | undefined;
+          department: string;
+          role: string;
+          email?: string | undefined;
+          phone?: string | undefined;
+        }[] | undefined;
+        approvalMode?: ApprovalMode | undefined;
         title: string;
-        status: "active";
+        status?: NodeStatus | undefined;
         config?: Record<string, unknown> | undefined;
         initiators?: {
           id: string;
@@ -1297,9 +1306,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;
@@ -1308,7 +1317,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;

package/dist/verification.d.cts

@@ -76,20 +76,20 @@ declare const __VLS_export: vue.DefineComponent<CaptchaProps, {
   reset: () => void;
   show: () => void;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
-  change: (valid: boolean) => any;
-  reset: () => any;
   success: (data: CaptchaSuccessPayload) => any;
-  "load-error": (error: unknown) => any;
+  reset: () => any;
+  change: (valid: boolean) => 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;
-  onReset?: (() => any) | undefined;
   onSuccess?: ((data: CaptchaSuccessPayload) => any) | undefined;
-  "onLoad-error"?: ((error: unknown) => any) | undefined;
+  onReset?: (() => any) | undefined;
+  onChange?: ((valid: boolean) => 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";

package/dist/verification.d.ts

@@ -76,20 +76,20 @@ declare const __VLS_export: vue.DefineComponent<CaptchaProps, {
   reset: () => void;
   show: () => void;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
-  change: (valid: boolean) => any;
-  reset: () => any;
   success: (data: CaptchaSuccessPayload) => any;
-  "load-error": (error: unknown) => any;
+  reset: () => any;
+  change: (valid: boolean) => 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;
-  onReset?: (() => any) | undefined;
   onSuccess?: ((data: CaptchaSuccessPayload) => any) | undefined;
-  "onLoad-error"?: ((error: unknown) => any) | undefined;
+  onReset?: (() => any) | undefined;
+  onChange?: ((valid: boolean) => 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";

package/docs/architecture.en.md

@@ -25,7 +25,7 @@ The core is currently an internal boundary, not a separately published package.
 - ESM resolves `.d.ts`; CJS resolves `.d.cts`. Each declaration condition matches its JavaScript format.
 - All public reachable declarations are checked for `naive-ui/es/*` and `naive-ui/lib/*` internal imports, in both formats.
 
-The consumer contract check unpacks a real tarball into a temporary directory and attaches the repository's resolved dependencies. It covers Node16/NodeNext ESM/CJS types and subpath runtime imports without optional peers. It does not reinstall online, so it does not replace minimum/latest dependency matrices or application acceptance.
+The default consumer contract check unpacks a real tarball into a temporary directory and attaches the repository's resolved dependencies. It covers Node16/NodeNext ESM/CJS types and subpath runtime imports without optional peers. The `minimum` and `latest` profiles instead install fresh dependencies from the registry and also render representative components. CI runs both profiles; application acceptance remains a separate check.
 
 ## Highlight instances
 
@@ -81,3 +81,5 @@ Running both UI libraries in one application is outside this iteration. That wou
 Verify behavior through published consumers, public types, multiple applications, dynamic registration, unmount and host-state restoration. Source-level dependency guards complement runtime verification.
 
 `bun run verify` is the local quality gate. `bun run check:audit` remains a separate check and CI gate. Record actual advisory results; do not hide them by disabling checks or forcing unverified major versions.
+
+Fresh consumer compatibility is checked with `bun run check:consumer-contracts minimum` and `latest`. Each profile installs the real tarball in an isolated temporary directory, checks ESM/CJS types and renders representative components. CI runs both profiles. `/config` exports shared injection keys and protocol types without loading the presentation layer.

package/docs/architecture.md

@@ -25,7 +25,9 @@
 - ESM 使用 `.d.ts`，CJS 使用 `.d.cts`；条件类型入口与相应 JavaScript 格式对应。
 - 公共可达声明同时检查 ESM / CJS，不能引用 `naive-ui/es/*` 或 `naive-ui/lib/*` 内部路径。
 
-新增消费者契约验证使用真实 tarball，在临时目录解包并接入仓库已解析的依赖；覆盖 Node16 / NodeNext 的 ESM / CJS 类型与缺失可选 peer 的子路径运行行为。它不联网重新安装依赖，因此不能代替最低／最新依赖版本矩阵或真实应用验收。
+消费者契约验证使用真实 tarball，覆盖 Node16 / NodeNext 的 ESM / CJS 类型、轻量配置入口的注入键一致性和缺失可选 peer 的子路径运行行为。默认检查复用本地安装；`bun run check:consumer-contracts minimum` / `latest` 在临时目录联网全新安装依赖并渲染表单、表格、原生数字键菜单。CI 分别运行两种组合。类型检查保留 `skipLibCheck`，不将第三方声明内部检查冒充业务消费验证。
+
+`/config` 是独立公共配置入口，只包含注入键和协议类型，不引入呈现层。组件注册、样式与反馈适配仍由各自入口负责。
 
 ## 高亮实例
 

package/docs/guides/usage.en.md

@@ -677,3 +677,19 @@ For a concrete business model, enable dynamic insertion with the existing `dynam
 `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.
+
+## Configuration and behavior contracts (0.21)
+
+Use `@robot-admin/naive-ui-components/config` to import `COMPONENT_LOCALE_KEY`, `COMPONENT_FEEDBACK_KEY` and their protocol types. This entry shares injection identities with the root entry without importing components, router or the Naive feedback adapter. Provide a reactive configuration or locale getter for language changes. Built-in `zh-CN`/`en-US` text now also covers Tree, Transfer, SplitPane, Chat, NotificationCenter, Theme, Language, Skeleton and Timeline. Explicit labels remain application-owned.
+
+Form action slots receive the current model, including a normal business field named `value`. Collapsed search fields remain mounted and validated; errors expand the form. `show: false` excludes a field. Table expansion discards stale completions after dataset changes, and nested selection honors eligibility, parent limits and consistent events. Native Menu options preserve string/number keys; route-mode callbacks remain string paths. Chat drafts belong to the contact and retain at most 50 nonempty inactive drafts. ER and Workflow emit user-completed canvas edits without echoing parent updates. Human verification gates password login; SMS uses its own validation.
+
+Upload `concurrency` applies across normal and chunk upload requests. Cancellation stops subsequent hash reads; a Blob read already in progress is discarded on completion. Application-provided check/merge callbacks retain responsibility for their own network lifecycle.
+
+Excel previews preserve raw values, cell types and workbook display formatting. Sheets expand on demand. Defaults are 32 MiB per file and 100000 cells per sheet; `previewLimits: { maxBytes, maxCells }` accepts finite safe positive integers. Over-budget previews report an error and retain download access. These limits do not guarantee a bound on decompressed archive memory.
+
+WaterFall fills a visible sentinel for at most five consecutive pages, then exposes a manual continuation. Custom `footer` slots receive `paused` and `loadMore`. Continue updating `loading` and `noMore` in the host. Draggable instances sort independently by default; cross-list transfers require an explicitly shared `group`.
+
+Video supports MP4/HLS by default. DASH/FLV require a `sourceAdapters` loader returning a compatible xgplayer constructor; missing adapters enter the error state and emit `error`. Protocol SDK installation remains opt-in.
+
+Notification `categoryOptions` customizes labels/order of existing `all/system/business/alarm` categories. It does not add domain enums. The `filters` slot receives `{ controller }`; `item` and `item-actions` receive `{ message, index, busy, select, read, remove }`. Use supplied callbacks to retain busy/error handling. Approval commands, tenancy, authorization and backend contracts remain application-owned; Robot_Admin's enterprise notification store is not bundled into this preview component.

package/docs/guides/usage.md

@@ -64,6 +64,25 @@ app.mount('#app')
 
 > 子路径导入提供完整的 TypeScript 类型支持（`.d.ts`），IDE 可自动补全 props / emits / slots。组件相关工具函数（如 `createMenuOptions`）也从对应组件子路径导出，避免为了单个工具加载组件库根入口。
 
+### 按需配置语言与反馈
+
+独立 `/config` 入口只导出注入键和协议类型，不加载组件、路由或 Naive UI 适配器。与根入口使用相同的注入键，可以直接配置按需使用的组件：
+
+```ts
+import {
+  COMPONENT_LOCALE_KEY,
+  COMPONENT_FEEDBACK_KEY,
+} from '@robot-admin/naive-ui-components/config'
+
+app.provide(COMPONENT_LOCALE_KEY, { locale: 'en-US' })
+app.provide(COMPONENT_FEEDBACK_KEY, {
+  success: message.success,
+  error: text => message.error(text),
+})
+```
+
+默认中文，内置支持 `zh-CN` / `en-US`，自定义 `messages` 或 `t` 沿用现有协议。需要动态切换时提供响应式对象或 `locale` getter。Tree、Transfer、SplitPane、Chat、NotificationCenter、Theme、Language、Skeleton、Timeline 的内置文案与已有 Form/Table/Search/Breadcrumb 一起使用该上下文；业务标题、菜单名称和显式传入的文案由宿主管理。
+
 ### Composables 单独使用
 
 ```typescript
@@ -771,3 +790,40 @@ CRUD 控制器只需满足结构契约；`@robot-admin/request-core` 0.6.3 起
 组件只发出 `select(path)`，不执行路由跳转或权限请求。传入 `menus`（包括空数组）后，目录仅使用这份数据；隐藏项、无标题占位和不可直接跳转的动态参数叶页不进入快捷导航。隐藏详情页仍保留当前路径，显式 `meta.breadcrumb: false` 可隐藏对应层级。未传 `menus` 时继续使用路由子项；原生路由表并非权限边界，业务项目应传入与侧栏同源的授权菜单。
 
 已有 `items` 手动路径继续优先，标签沿用传入值并接受只读嵌套数据，`disabled` 对目录整支生效。完整路径在窄容器中自动收拢，保留当前页；目录支持方向键、Home/End、Enter/Space 和 Escape。颜色跟随 Naive 主题，浮层中的通用文案使用既有组件国际化服务。组件不保存菜单快照、不读取应用 Store，也不改写传入数据。
+
+## 状态一致性与资源边界（0.21）
+
+- 表单 `action` / `action-extra` 插槽直接提供当前业务模型，字段名 `value` 没有特殊含义。
+- 搜索折叠仅隐藏字段，字段保持挂载及校验；失败自动展开。`show: false` 才移除该字段的渲染与校验注册。大型自定义控件会在折叠状态初始化，应按业务配置实际需要的字段。
+- 表格全部展开在换数据或卸载后失效；子表禁选、父级数量上限、strict 联动与选择事件保持同一约束。
+- Menu 的路由模式事件仍为字符串路径；原生 `options` 支持字符串和数字 key，`0` 有效，`1` 与 `'1'` 不合并。
+- Chat 按会话保留草稿，发送后清空当前草稿；移除联系人清理旧草稿，最多缓存最近 50 个非空会话。
+- ER 的节点拖动与 Workflow 的拖动、连接、删除会同步外部快照；父级回填不再次触发用户变更事件。
+- Login 的人机验证门禁适用于密码模式；短信模式使用自己的字段规则及验证码提交事件。
+
+### 上传、文档和长列表
+
+`C_Upload.concurrency` 统一限制普通上传与分片上传请求。取消、移除和卸载会停止后续哈希读取并释放排队任务；已经开始的单次 Blob 读取完成后不再处理结果。业务自行提供的校验、合并回调仍由业务负责其网络生命周期。
+
+Excel 保留原始值、单元格类型和工作簿格式，不把文本编号转换为数值，也不自行舍入小数。工作表数据在首次打开时展开，默认文件预算 32 MiB、每表 100000 格；超限明确提示下载原文件，不静默截断。可使用一个配置调整预算：
+
+```vue
+<C_FilePreview
+  :file="file"
+  :preview-limits="{ maxBytes: 64 * 1024 * 1024, maxCells: 200000 }"
+/>
+```
+
+预算必须是有限安全正整数；这是预览资源限制，不是压缩文件解压后内存的绝对保证。
+
+WaterFall 会在哨兵持续可见时继续补页，每轮最多自动请求 5 页，避免空响应循环。达到上限后可点击“继续加载”；自定义 `footer` 插槽获得 `paused` 和 `loadMore`。使用侧继续维护 `loading` 和 `noMore`。
+
+Draggable 默认只在自身排序。需要跨列表拖动时，在相关实例上显式设置相同 `group`；此前依赖隐式 `default` 分组的页面应补上该属性。
+
+### 视频协议与通知预览
+
+视频默认支持 MP4/HLS。DASH/FLV 需要通过 `sourceAdapters` 提供按需加载、兼容 xgplayer 接口的播放器构造器；缺少适配器会进入错误状态并发出 `error`，不再尝试当作普通 MP4 播放。协议 SDK 的依赖与授权由使用该协议的项目管理。
+
+`C_NotificationCenter.categoryOptions` 只定制已有 `all/system/business/alarm` 分类的标签和顺序，不扩展消息领域协议。`filters` 插槽提供 `{ controller }`，`item` / `item-actions` 提供 `{ message, index, busy, select, read, remove }`，可组合独立筛选和业务操作。异步操作应沿用提供的回调以保留 busy/错误处理。
+
+审批命令、租户、权限和后端协议由宿主管理。Robot_Admin 的企业消息使用领域 Store 与自己的通知铃铛；本包提供可复用的通知展示与交互，二者的能力边界不同。