@qin-ui/element-plus-pro 1.2.4 → 1.3.1

package/AI-CONTEXT.md

@@ -152,7 +152,7 @@ useTable({ columns, data, pageParam, searchParam, searchFields }); // 数据源
 
 关键 prop：`table`（useTable 实例）、`search`（数据查询方法 `() => Promise`，ProTable 内部调用，非自动触发）、`addIndexColumn`、`immediateSearch`、`control`、`searchFormConfig`（含 `hidden`/`container`/`layout`/`expand`）、`tableContainer`、`columns`（覆盖实例列配置）、`data`（覆盖实例数据源）、`pagination`（`false` | 分页属性）。
 
-**列控制（control）**：`control` 支持布尔值或 `{ sizeControl, columnControl }` 对象；`columnControl` 可为布尔值或 `ColumnControlConfig`：`excludedKeys`（不在下拉出现、始终展示）、`disabledKeys`（显示但不可取消勾选）、`disableCheckAll`（禁用全选/取消全选）。element-plus 列标题用 `label`（字符串）渲染，无需 labels 映射；列 key 取 `prop` / `columnKey` / 索引。
+**列控制（control）**：`control` 支持布尔值或 `{ sizeControl, columnControl }` 对象；`columnControl` 可为布尔值或 `ColumnControlConfig`：`labels`（列在下拉中的显示名映射，label 为 vnode 或函数时必用）、`excludedKeys`（不在下拉出现、始终展示）、`disabledKeys`（显示但不可取消勾选）、`disableCheckAll`（禁用全选/取消全选）。列 key 取 `prop` 或自定义 `key`。
 
 **数据流**：搜索->重置分页到第 1 页->调 `search()`；分页/排序变化->更新 `pageParam`->调 `search()`；重置->`resetQueryParams()`->调 `search()`。
 

package/README.md

@@ -189,17 +189,17 @@ ProForm/ProTable 是渲染引擎，所有真实 UI 来自 element-plus。**Field
 
 ### 1. ProComponentProvider
 
-作为全局或局部范围的上下文配置器，通过传入 `component-vars` 属性来统一覆盖子组件的默认配置。
+作为全局或局部范围的上下文配置器，通过传入 `componentVars` 属性来统一覆盖子组件的默认配置。
 
 #### Props
 
-| 参数名           | 说明                                    | 类型            | 默认值 |
-| :--------------- | :-------------------------------------- | :-------------- | :----- |
-| `component-vars` | 需要全局 provide 给子组件的默认属性配置 | `ComponentVars` | -      |
+| 参数名          | 说明                                    | 类型            | 默认值 |
+| :-------------- | :-------------------------------------- | :-------------- | :----- |
+| `componentVars` | 需要全局 provide 给子组件的默认属性配置 | `ComponentVars` | -      |
 
 #### 内置默认预设（INJECT_CONFIG）
 
-ProComponentProvider 内置了一套默认属性预设，**即使不配置 `component-vars` 也会生效**。Field 配置优先级最高，会覆盖这些预设。以下为各组件的内置默认值（写代码时需知晓，避免行为与预期不符）：
+ProComponentProvider 内置了一套默认属性预设，**即使不配置 `componentVars` 也会生效**。Field 配置优先级最高，会覆盖这些预设。以下为各组件的内置默认值（写代码时需知晓，避免行为与预期不符）：
 
 | component                                     | 默认预设                                                                                                                                                                                                                                            |
 | :-------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |

package/api.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-08-20T09:56:22.122Z",
+  "generatedAt": "2026-08-28T06:01:50.949Z",
   "name": "@qin-ui/element-plus-pro",
   "api": [
     {
@@ -89,30 +89,6 @@
       "signature": "export type ComponentName =\n  | keyof BaseComponentMap\n  | keyof ComponentMap\n  | 'custom';",
       "description": "组件名称联合类型\n所有支持的组件名称"
     },
-    {
-      "name": "useFormData",
-      "type": "function",
-      "package": "@qin-ui/element-plus-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__/cross-package.spec.d.ts

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

package/es/__tests__/cross-package.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cross-package.spec.d.ts","sourceRoot":"","sources":["../../__tests__/cross-package.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[];
+    data?: 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,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACb,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/element-plus-pro.css

@@ -1,16 +1,16 @@
-[class*='-form-item'] [class*='-form-item'][data-v-295cd434] {
+[class*='-form-item'] [class*='-form-item'][data-v-e8f152ee] {
   margin-bottom: 18px;
 }
-.pro-table_search-form[data-v-20c91e48] [class*='-form-item'] {
+.pro-table_search-form[data-v-9c362a11] [class*='-form-item'] {
   margin: 0;
 }
-.pro-table_search-form_expand-toggle-button[data-v-20c91e48] {
+.pro-table_search-form_expand-toggle-button[data-v-9c362a11] {
   display: flex;
   align-items: center;
   padding: 0;
   padding-left: 4px;
 }
-.pro-table_search-form .transition[data-v-20c91e48] {
+.pro-table_search-form .transition[data-v-9c362a11] {
   transition: all 0.25s;
 }
 .pro-table_search-form-container[data-v-45e627f4] {
@@ -25,42 +25,42 @@
   background-color: var(--el-bg-color, #fff);
   border-radius: 4px;
 }
-.pro-table_size-control_button[data-v-b114045c] {
+.pro-table_size-control_button[data-v-e31e9c15] {
   display: flex;
   align-items: center;
   padding-right: 12px;
   padding-left: 12px;
 }
-.pro-table_size-control_button[data-v-b114045c] svg {
+.pro-table_size-control_button[data-v-e31e9c15] svg {
   transform: scale(1.3);
 }
-.pro-table_column-control_button[data-v-97c582f9] {
+.pro-table_column-control_button[data-v-92c3fe41] {
   display: flex;
   align-items: center;
   padding-right: 12px;
   padding-left: 12px;
 }
-.pro-table_column-control_button[data-v-97c582f9] svg {
+.pro-table_column-control_button[data-v-92c3fe41] svg {
   transform: scale(1.2, 1.4);
 }
-.pro-table_header[data-v-127db81d] {
+.pro-table_header[data-v-e9641e7c] {
   display: flex;
   align-items: center;
   justify-content: flex-end;
 }
-.pro-table_header[data-v-127db81d]:empty {
+.pro-table_header[data-v-e9641e7c]:empty {
   display: none;
 }
-.pro-table_header + .pro-table_header_content[data-v-127db81d] {
+.pro-table_header + .pro-table_header_content[data-v-e9641e7c] {
   margin-top: 16px;
 }
-.pro-table_header_button-bar[data-v-127db81d] {
+.pro-table_header_button-bar[data-v-e9641e7c] {
   flex: 1;
 }
-.pro-table_header_toolbar[data-v-127db81d] {
+.pro-table_header_toolbar[data-v-e9641e7c] {
   margin-left: 12px;
 }
-.pro-table_pagination[data-v-127db81d] {
+.pro-table_pagination[data-v-e9641e7c] {
   justify-content: flex-end;
   padding: 16px 0;
 }