@qin-ui/antd-vue-pro 2.3.3 → 2.4.0

package/README.md

@@ -164,17 +164,17 @@ ProForm/ProTable 是渲染引擎，所有真实 UI 来自 ant-design-vue。**Fie
 
 ### 1. ProComponentProvider
 
-作为全局或局部范围的上下文配置器，通过传入 `component-vars` 属性来统一覆盖子组件的默认配置。
+作为全局或局部范围的上下文配置器，通过传入 `componentVars` 属性来统一覆盖子组件的默认配置。
 
 #### Props
 
-| 参数名           | 说明                                    | 类型            | 默认值 |
-| :--------------- | :-------------------------------------- | :-------------- | :----- |
-| `component-vars` | 需要全局 provide 给子组件的默认属性配置 | `ComponentVars` | -      |
+| 参数名          | 说明                                    | 类型            | 默认值 |
+| :-------------- | :-------------------------------------- | :-------------- | :----- |
+| `componentVars` | 需要全局 provide 给子组件的默认属性配置 | `ComponentVars` | -      |
 
 #### 内置默认预设（INJECT_CONFIG）
 
-ProComponentProvider 内置了一套默认属性预设，**即使不配置 `component-vars` 也会生效**。Field 配置优先级最高，会覆盖这些预设。以下为各组件的内置默认值（写代码时需知晓，避免行为与预期不符）：
+ProComponentProvider 内置了一套默认属性预设，**即使不配置 `componentVars` 也会生效**。Field 配置优先级最高，会覆盖这些预设。以下为各组件的内置默认值（写代码时需知晓，避免行为与预期不符）：
 
 | component                                      | 默认预设                                                                                                                                                                                                                                                      |
 | :--------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
@@ -389,6 +389,8 @@ const table = useTable<D, T>({
 }
 ```
 
+> 📌 **旧值（oldVal）注入契约**：仅当转换函数显式声明两个形参 `(val, oldVal) => ...` 时，底层才读取并传入写入前的旧值快照；声明单形参则不读取旧值（零克隆开销）。请勿使用默认参数或剩余参数声明（否则 `fn.length` 无法识别）。`oldVal` 为只读快照副本，不得依赖原地修改写回。
+>
 > ⚠️ `valueFormatter` 不支持响应式（不能包 `ref`/`computed`），与 `component` / `fields` / `slots` / `modelProp` 等同属不支持响应式的属性。
 
 ---

package/api.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-08-19T03:08:37.658Z",
+  "generatedAt": "2026-08-26T05:48:23.618Z",
   "name": "@qin-ui/antd-vue-pro",
   "api": [
     {
@@ -108,30 +108,6 @@
         "```ts\ntype Name = ComponentName\n// 'input' | 'select' | 'date-picker' | ... | 'custom'\n```"
       ]
     },
-    {
-      "name": "useFormData",
-      "type": "function",
-      "package": "@qin-ui/antd-vue-pro",
-      "signature": "export const useFormData = <D extends Data = Data>(\n  initFormData?: ExtendWithAny<DeepPartial<D>>\n): UseFormDataReturn<D> =>",
-      "description": "表单数据处理 Hook\n提供响应式表单数据的管理能力，支持：\n- 响应式数据存储（基于 Vue reactive）\n- 深层路径读写（支持点号分隔，如 'address.city'）\n- 类型安全的路径提示（传入泛型 D 后，path 参数可获得类型推导）\n- 父子表单自动注入（非根表单会从注入中获取数据）",
-      "params": [
-        {
-          "name": "initFormData",
-          "type": "ExtendWithAny<DeepPartial<D>>",
-          "optional": true,
-          "description": "初始表单数据"
-        }
-      ],
-      "returns": "{UseFormDataReturn<D>} 表单数据操作对象",
-      "typeParams": [
-        {
-          "name": "D"
-        }
-      ],
-      "examples": [
-        "```ts\ninterface User { name: string; age: number; address: { city: string } }\n\nconst { formData, getFormData, setFormData } = useFormData<User>({\nname: '张三',\naddress: { city: '北京' }\n})\n\n// 读取\ngetFormData('name')           // '张三'\ngetFormData('address.city')   // '北京'\nformData.name                 // '张三'（响应式）\n\n// 设置\nsetFormData('name', '李四')\nsetFormData('address.city', '上海')\nsetFormData({ name: '王五', age: 30 }) // 批量覆盖\nsetFormData(prev => ({ ...prev, name: '赵六' })) // 函数式更新\n```"
-      ]
-    },
     {
       "name": "useFields",
       "type": "function",

package/es/__tests__/BaseField.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=BaseField.spec.d.ts.map

package/es/__tests__/BaseField.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseField.spec.d.ts","sourceRoot":"","sources":["../../__tests__/BaseField.spec.ts"],"names":[],"mappings":""}

package/es/__tests__/BaseFormItem.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=BaseFormItem.spec.d.ts.map

package/es/__tests__/BaseFormItem.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseFormItem.spec.d.ts","sourceRoot":"","sources":["../../__tests__/BaseFormItem.spec.ts"],"names":[],"mappings":""}

package/es/__tests__/ProForm.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ProForm.spec.d.ts.map

package/es/__tests__/ProForm.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProForm.spec.d.ts","sourceRoot":"","sources":["../../__tests__/ProForm.spec.ts"],"names":[],"mappings":""}

package/es/__tests__/ProTable.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ProTable.spec.d.ts.map

package/es/__tests__/ProTable.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProTable.spec.d.ts","sourceRoot":"","sources":["../../__tests__/ProTable.spec.ts"],"names":[],"mappings":""}

package/es/__tests__/SearchForm.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SearchForm.spec.d.ts.map

package/es/__tests__/SearchForm.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchForm.spec.d.ts","sourceRoot":"","sources":["../../__tests__/SearchForm.spec.ts"],"names":[],"mappings":""}

package/es/__tests__/controls.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=controls.spec.d.ts.map

package/es/__tests__/controls.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controls.spec.d.ts","sourceRoot":"","sources":["../../__tests__/controls.spec.ts"],"names":[],"mappings":""}

package/es/__tests__/helpers/fixtures.d.ts

@@ -0,0 +1,15 @@
+import { Field } from '../../src/components/form/types';
+import { Column } from '../../src/components/table/types';
+/**
+ * 基础测试表单字段
+ */
+export declare const createBasicFields: () => Field[];
+/**
+ * 嵌套路径表单字段 (用于 H1 校验与深层数据绑定测试)
+ */
+export declare const createNestedFields: () => Field[];
+/**
+ * 基础测试表格列
+ */
+export declare const createBasicColumns: () => Column[];
+//# sourceMappingURL=fixtures.d.ts.map

package/es/__tests__/helpers/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../__tests__/helpers/fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,KAAK,EAqBzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAO,KAAK,EAa1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,QAAO,MAAM,EAa3C,CAAC"}

package/es/__tests__/helpers/mount.d.ts

@@ -0,0 +1,38 @@
+import { Field } from '../../src/components/form/types';
+import { Column } from '../../src/components/table/types';
+/**
+ * 等待所有异步 Promise 与 Vue DOM 更新完成
+ */
+export declare const flushPromises: () => Promise<void>;
+/**
+ * 挂载 ProForm 辅助函数
+ */
+export declare const mountProForm: (options?: {
+    form?: any;
+    fields?: Field[];
+    initialData?: Record<string, any>;
+    props?: Record<string, any>;
+    slots?: Record<string, any>;
+}) => {
+    wrapper: import('@vue/test-utils').VueWrapper<unknown, import('vue').ComponentPublicInstance<unknown, Omit<unknown, never>>>;
+    form: any;
+};
+/**
+ * 挂载 ProTable 辅助函数
+ */
+export declare const mountProTable: (options?: {
+    table?: any;
+    columns?: Column[];
+    dataSource?: any[];
+    search?: () => Promise<any> | any;
+    props?: Record<string, any>;
+    slots?: Record<string, any>;
+}) => {
+    wrapper: import('@vue/test-utils').VueWrapper<unknown, import('vue').ComponentPublicInstance<unknown, Omit<unknown, never>>>;
+    table: any;
+};
+/**
+ * 断言 console.warn 产生匹配警告
+ */
+export declare const expectWarn: (spy: any, matcher: string | RegExp) => void;
+//# sourceMappingURL=mount.d.ts.map

package/es/__tests__/helpers/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../../__tests__/helpers/mount.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,aAAa,qBAGzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GACvB,UAAS;IACP,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACxB;;;CA0BP,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GACxB,UAAS;IACP,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,GAAG,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACxB;;;CA4BP,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,KAAK,GAAG,EAAE,SAAS,MAAM,GAAG,MAAM,SAS5D,CAAC"}

package/es/__tests__/hooks-locale.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hooks-locale.spec.d.ts.map

package/es/__tests__/hooks-locale.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks-locale.spec.d.ts","sourceRoot":"","sources":["../../__tests__/hooks-locale.spec.ts"],"names":[],"mappings":""}

package/es/__tests__/index.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.spec.d.ts.map

package/es/__tests__/index.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.spec.d.ts","sourceRoot":"","sources":["../../__tests__/index.spec.ts"],"names":[],"mappings":""}

package/es/__tests__/integration.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=integration.spec.d.ts.map

package/es/__tests__/integration.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.spec.d.ts","sourceRoot":"","sources":["../../__tests__/integration.spec.ts"],"names":[],"mappings":""}

package/es/__tests__/setup.d.ts

@@ -0,0 +1,14 @@
+type ResizeCallback = (entries: any[], observer: any) => void;
+export declare const activeResizeObservers: Set<{
+    callback: ResizeCallback;
+    elements: Set<Element>;
+}>;
+export declare const triggerResize: (targetElement?: Element) => void;
+type IntersectCallback = (entries: any[], observer: any) => void;
+export declare const activeIntersectionObservers: Set<{
+    callback: IntersectCallback;
+    elements: Set<Element>;
+}>;
+export declare const triggerIntersect: (entries: Partial<IntersectionObserverEntry>[]) => void;
+export {};
+//# sourceMappingURL=setup.d.ts.map

package/es/__tests__/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../__tests__/setup.ts"],"names":[],"mappings":"AAsBA,KAAK,cAAc,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;AAC9D,eAAO,MAAM,qBAAqB;cACtB,cAAc;cACd,GAAG,CAAC,OAAO,CAAC;EACpB,CAAC;AA6BL,eAAO,MAAM,aAAa,GAAI,gBAAgB,OAAO,SAMpD,CAAC;AAOF,KAAK,iBAAiB,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG,KAAK,IAAI,CAAC;AACjE,eAAO,MAAM,2BAA2B;cAC5B,iBAAiB;cACjB,GAAG,CAAC,OAAO,CAAC;EACpB,CAAC;AA6BL,eAAO,MAAM,gBAAgB,GAC3B,SAAS,OAAO,CAAC,yBAAyB,CAAC,EAAE,SAK9C,CAAC"}

package/es/antd-vue-pro.css

@@ -1,13 +1,13 @@
-.pro-table_search-form[data-v-7bd701e4] [class*='-form-item'] {
+.pro-table_search-form[data-v-9dca0a5d] [class*='-form-item'] {
   margin: 0;
 }
-.pro-table_search-form_expand-toggle-button[data-v-7bd701e4] {
+.pro-table_search-form_expand-toggle-button[data-v-9dca0a5d] {
   display: flex;
   align-items: center;
   padding: 0;
   padding-left: 4px;
 }
-.pro-table_search-form .transition[data-v-7bd701e4] {
+.pro-table_search-form .transition[data-v-9dca0a5d] {
   transition: all 0.25s;
 }
 .pro-table_search-form-container[data-v-c385cd54] {
@@ -18,41 +18,41 @@
   flex: 1;
   padding: 24px 24px 0;
 }
-.pro-table_size-control_button[data-v-a718ce24] {
+.pro-table_size-control_button[data-v-2ac95d3b] {
   display: flex;
   align-items: center;
   padding-right: 12px;
   padding-left: 12px;
 }
-.pro-table_size-control_button[data-v-a718ce24] svg {
+.pro-table_size-control_button[data-v-2ac95d3b] svg {
   transform: scale(1.3);
 }
-.pro-table_column-control_button[data-v-9899456e] {
+.pro-table_column-control_button[data-v-04235d0e] {
   display: flex;
   align-items: center;
   padding-right: 12px;
   padding-left: 12px;
 }
-.pro-table_column-control_button[data-v-9899456e] svg {
+.pro-table_column-control_button[data-v-04235d0e] svg {
   transform: scale(1.2, 1.4);
 }
-.pro-table_header[data-v-ff6f01f4] {
+.pro-table_header[data-v-5ce28f7b] {
   display: flex;
   align-items: center;
   justify-content: flex-end;
 }
-.pro-table_header[data-v-ff6f01f4]:empty {
+.pro-table_header[data-v-5ce28f7b]:empty {
   display: none;
 }
-.pro-table_header + .pro-table_header_content[data-v-ff6f01f4] {
+.pro-table_header + .pro-table_header_content[data-v-5ce28f7b] {
   margin-top: 16px;
 }
-.pro-table_header_button-bar[data-v-ff6f01f4] {
+.pro-table_header_button-bar[data-v-5ce28f7b] {
   flex: 1;
 }
-.pro-table_header_toolbar[data-v-ff6f01f4] {
+.pro-table_header_toolbar[data-v-5ce28f7b] {
   margin-left: 12px;
 }
-.pro-table[data-v-ff6f01f4] [class*='-pagination'] [class*='-pagination-total-text'] {
+.pro-table[data-v-5ce28f7b] [class*='-pagination'] [class*='-pagination-total-text'] {
   flex: 1;
 }