@qin-ui/antd-vue-pro 2.4.3 → 2.4.4

package/es/shared/core/index.d.ts

@@ -1,6 +1,5 @@
 /**
- * 统一 re-export @qin-ui/pro-components-core，包内所有文件通过此文件引入 core 内容，
- * 避免直接散列依赖 @qin-ui/pro-components-core，便于将来统一维护。
+ * 统一 re-export @qin-ui/pro-components-core，包内所有文件通过此文件引入 core 内容。
  */
 export { useForm, createFormProxy, useTable, useSearchFormExpand, useFields, useFormData, useFormRef, InjectionFormKey, InjectionFormSlotsKey, getObject, get, set, normalizePathKey, toPath, camelizeProperties, cloneDeep, pick, isPlainObject, isPromise, zhCN, zhTW, enUS, format, resolveLocaleName, type ProLocale, type ProLocaleName, type ProLocaleKey, type Data, type Path, type Paths, type KeyExpandString, type ExtendWithAny, type DeepPartial, type PageParam, type Fields, type Form, type Table, type UseFieldsReturn, type UseFormDataReturn, type UseFormRefReturn, } from '@qin-ui/pro-components-core';
 //# sourceMappingURL=index.d.ts.map

package/es/shared/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/core/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAEL,OAAO,EACP,eAAe,EACf,QAAQ,EACR,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,UAAU,EAEV,gBAAgB,EAChB,qBAAqB,EAErB,SAAS,EACT,GAAG,EACH,GAAG,EACH,gBAAgB,EAChB,MAAM,EACN,kBAAkB,EAClB,SAAS,EACT,IAAI,EACJ,aAAa,EACb,SAAS,EAET,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,iBAAiB,EACjB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,YAAY,EAEjB,KAAK,IAAI,EACT,KAAK,IAAI,EACT,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAEL,OAAO,EACP,eAAe,EACf,QAAQ,EACR,mBAAmB,EACnB,SAAS,EACT,WAAW,EACX,UAAU,EAEV,gBAAgB,EAChB,qBAAqB,EAErB,SAAS,EACT,GAAG,EACH,GAAG,EACH,gBAAgB,EAChB,MAAM,EACN,kBAAkB,EAClB,SAAS,EACT,IAAI,EACJ,aAAa,EACb,SAAS,EAET,IAAI,EACJ,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,iBAAiB,EACjB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,YAAY,EAEjB,KAAK,IAAI,EACT,KAAK,IAAI,EACT,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,KAAK,EACV,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,6BAA6B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qin-ui/antd-vue-pro",
-  "version": "2.4.3",
+  "version": "2.4.4",
   "description": "二次封装antd vue组件",
   "bin": {
     "antd-vue-pro": "./bin/init-ai.mjs"
@@ -43,11 +43,11 @@
   "dependencies": {
     "scroll-into-view-if-needed": "^3.1.0",
     "vue-component-type-helpers": "^3.2.5",
-    "@qin-ui/pro-components-core": "^2.0.2"
+    "@qin-ui/pro-components-core": "^2.0.3"
   },
   "devDependencies": {
     "@vue/test-utils": "^2.4.11",
-    "ant-design-vue": "^4",
+    "ant-design-vue": "^4.2.6",
     "happy-dom": "^20.11.6",
     "vitest": "^4.1.11"
   },

package/src/components/form/components/BaseField/index.vue

@@ -76,7 +76,11 @@ const triggerFormItemChange = () => {
 
 const attrs: any = useAttrs();
 
-// 全局默认配置注入：key = 组件名 + picker 修饰段；inject 须在 setup 同步期调用
+/**
+ * 全局默认配置注入：key = 组件名 + picker 修饰段，inject 须在 setup 同步期调用。
+ * 组件名与 `picker` 仅取 setup 期初始值——运行期变更不会切换 Provider 的默认值预设
+ * （`date-picker.month` 等子类型预设需在初始渲染前确定）。
+ */
 const pickerVal = attrs.picker;
 const injectConfigKey =
   typeof props.component === 'string'
@@ -123,6 +127,13 @@ const value = computed({
     }
     form.setFormData?.(props.path, newVal);
     triggerFormItemChange();
+    // 字段配置/attrs 传入的 onUpdate:* 监听器与内部写值组合回放，参数为组件原始 emit 值
+    const { onUpdateValue } = groupedAttrs.value;
+    if (typeof onUpdateValue === 'function') {
+      onUpdateValue(val);
+    } else if (Array.isArray(onUpdateValue)) {
+      onUpdateValue.forEach(listener => listener(val));
+    }
   },
 });
 
@@ -150,7 +161,7 @@ const groupedAttrs = computed(() => {
 
   // prettier-ignore
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  const { valueFormatter, modelProp, slots, componentClass, componentStyle, componentContainer, [effectiveModelProp]: _modelVal, [`onUpdate:${effectiveModelProp}`]: _onUpdateModelVal, ...bindAttrs } = mergedProps as any;
+  const { valueFormatter, modelProp, slots, componentClass, componentStyle, componentContainer, [effectiveModelProp]: _modelVal, [`onUpdate:${effectiveModelProp}`]: onUpdateValue, ...bindAttrs } = mergedProps as any;
 
   return {
     attrs: bindAttrs,
@@ -158,6 +169,7 @@ const groupedAttrs = computed(() => {
     componentContainer,
     modelProp,
     valueFormatter,
+    onUpdateValue,
   };
 });
 

package/src/components/form/components/BaseField/utils/index.ts

@@ -40,7 +40,7 @@ export const getInitProps = (
   return {};
 };
 
-/** 已告警过的未知组件名（模块级去重，避免 computed 重算导致刷屏） */
+/** 已告警过的未知组件名（模块级去重集合） */
 const warnedUnknownComponents = new Set<string>();
 
 export function warnUnknownComponent(name: string) {

package/src/components/form/components/BaseFormItem/index.vue

@@ -55,6 +55,7 @@ const validFields = computed(() =>
   (props.fields ?? []).filter(field => !toValue(field.hidden))
 );
 
+// 向下注入表单级禁用上下文，BaseField 经 useInjectDisabled 消费
 useProviderDisabled(computed(() => props.disabled));
 
 const config = INJECT_CONFIG['pro-form'];
@@ -88,6 +89,8 @@ const setFormItemRef = (field: any, el: any, formItemProps?: any) => {
     raw.getFormItemComputedProps = () => formItemProps;
   } else {
     formItemInstanceMap.delete(raw);
+    delete raw.getFormItemRef;
+    delete raw.getFormItemComputedProps;
   }
 };
 
@@ -102,6 +105,8 @@ const setComponentRef = (field: any, el: any) => {
       componentInstanceMap.get(raw)?.getComponentComputedProps();
   } else {
     componentInstanceMap.delete(raw);
+    delete raw.getComponentRef;
+    delete raw.getComponentComputedProps;
   }
 };
 

package/src/components/form/components/ProForm/index.vue

@@ -9,8 +9,8 @@
  *
  * 1. 数据隔离：ProForm 本身不负责存储和管理表单状态，所有核心状态（formData, fields, 校验规则）
  *    均交由底层的 `useForm`（@qin-ui/pro-components-core）驱动。
- * 2. 上下文透传：通过 `provide` 将核心状态下发给子组件，避免了深层嵌套的 Props 传递。
- * 3. 递归渲染：网格布局和具体字段的解析交由 `<BaseFormItem>` 递归完成，实现了 UI 布局与表单逻辑的解耦。
+ * 2. 上下文透传：通过 `provide` 将核心状态下发给子组件。
+ * 3. 递归渲染：网格布局和具体字段的解析交由 `<BaseFormItem>` 递归完成。
  *
  * @public
  *
@@ -98,6 +98,10 @@ const fields = computed(() => {
 const formData = computed(() => currentForm.value?.formData);
 const setFormRef = (el: any) => currentForm.value?.setFormRef?.(el);
 
+/*
+ * formKey 子树重挂载契约：以 WeakMap 为每个 form 实例生成自增 key，绑定到原生 Form 的 :key
+ * :form 运行期替换为全新实例时强制整棵表单子树重新挂载，重置宿主校验状态与深层字段非受控状态
+ */
 let formInstanceCounter = 0;
 const formInstanceKeyMap = new WeakMap<object, number>();
 const getFormKey = (f: object) => {

package/src/components/form/hooks/useGroupFieldAttrs.ts

@@ -17,6 +17,7 @@ const gridItemPropKeys = Object.keys(gridItemProps());
 // 模块级 Set：字段循环内 O(1) 命中，替代数组 includes 线性扫描
 const gridItemPropKeySet = new Set<string>(gridItemPropKeys);
 const formItemPropKeySet = new Set<string>(formItemPropKeys);
+const formItemSlotKeySet = new Set<string>(FORM_ITEM_SLOT_KEYS);
 
 export interface GroupedField {
   path: string;
@@ -33,7 +34,7 @@ export interface GroupedField {
  *
  * @description
  * 1. 响应式集成 ProComponentProvider 的 `pro-form-item` 全局变量配置；
- * 2. 剥离 `extraProps`（用户自定义字段标识袋）：保留在字段原始对象上供业务层存取，渲染层经解构剥离，避免落入 componentProps 透传为无效 DOM 属性。
+ * 2. 剥离 `extraProps`（用户自定义字段标识袋）：保留在字段原始对象上供业务层存取，渲染层经解构剥离，不落入 componentProps 透传。
  */
 export function useGroupFieldAttrs(validFields: ComputedRef<Field[]>) {
   const config = INJECT_CONFIG['pro-form-item'];
@@ -95,7 +96,7 @@ export function useGroupFieldAttrs(validFields: ComputedRef<Field[]>) {
 
         Object.assign(componentProps, componentDataAttrs);
         Object.keys(slots).forEach(k => {
-          if (FORM_ITEM_SLOT_KEYS.includes(k as any)) {
+          if (formItemSlotKeySet.has(k)) {
             formItemSlots[k] = slots[k];
           } else {
             componentProps.slots[k] = slots[k];

package/src/components/form/types/index.ts

@@ -267,10 +267,7 @@ type WithFields<D extends Data = Data> = WithRef<
 /**
  * @description 合并 FormItem 插槽与组件插槽
  */
-export type MergeSlots<
-  T extends abstract new (...args: any) => any,
-  CS = ComponentSlots<T>,
-> = Partial<{
+export type MergeSlots<T, CS = ComponentSlots<T>> = Partial<{
   [K in keyof FormItemSlots | keyof CS]: K extends keyof FormItemSlots
     ? FormItemSlots[K]
     : K extends keyof CS
@@ -283,10 +280,7 @@ export type MergeSlots<
  * @template T - Vue 组件类型
  * @template D - 数据对象类型
  */
-type WithComponent<
-  T extends abstract new (...args: any) => any,
-  D extends Data = Data,
-> = Omit<
+type WithComponent<T, D extends Data = Data> = Omit<
   WithCommon<Partial<ComponentProps<T>>, D>,
   keyof VNodeProps | 'slots'
 > & {

package/src/components/table/components/ColumnControl.vue

@@ -55,7 +55,7 @@ const checkedColumnsOptions = computed<
     const disabled =
       props.columnControl?.disabledKeys?.some(dk => String(dk) === key) ??
       false;
-    // labels 优先；title 为字符串时直接使用；vnode 等其他类型降级为 key，避免渲染异常
+    // labels 优先；title 为字符串时直接使用；vnode 等其他类型降级为 key
     const label =
       (props.columnControl?.labels?.[key] as string) ??
       (typeof item.title === 'string' ? item.title : key);

package/src/components/table/components/ProTable.vue

@@ -206,7 +206,7 @@ const columnRequiredSlotNames = new Set([
 /**
  * 判定插槽是否具备渲染条件（守卫过渡状态或空列下 column 为 undefined 的情况）
  * 当列被动态隐藏或所有列均隐藏时，旧单元格销毁过渡帧或空占位中 column 可能为 undefined，
- * 此时直接阻断依赖 column 的业务插槽调用，防止访问 column 属性抛出 TypeError；
+ * 此时阻断依赖 column 的业务插槽调用；
  * 非列依赖的表格级插槽（如 emptyText、footer、summary 等）始终正常渲染。
  */
 const isSlotRenderable = (name: string, scoped: any) => {
@@ -306,7 +306,8 @@ const computedPagination = computed<PaginationProps | false>(() => {
 
 const onTableChange: TableProps['onChange'] = (...args) => {
   props.table?.setPageParam?.(args[0]);
-  attrs.onChange?.(...args);
+  // change 回放：模板监听器优先，未绑定时回退 Provider 全局配置
+  (attrs.onChange ?? injectProps.value.onChange)?.(...args);
   _search();
 };
 

package/src/components/table/components/SearchForm.vue

@@ -46,7 +46,7 @@ export type SearchFormProps = {
  *
  * 1. 内部渲染 ProForm，使用 table.searchForm 管理搜索条件
  * 2. 支持 grid（网格）和 inline（行内）两种布局
- * 3. 网格布局下支持展开/折叠：通过 IntersectionObserver 自动检测哪些字段溢出
+ * 3. 网格布局下支持展开/折叠（溢出检测与初值自动展开见下方机制说明）
  * 4. 提供搜索、重置、展开/折叠按钮（支持自定义）
  *
  * ## 展开/折叠机制

package/src/components/table/hooks/useTable.ts

@@ -29,7 +29,7 @@ import { Fields } from '../../form/types';
  * @property appendColumn - 在指定列后追加新列，传 undefined 在末尾追加
  * @property prependColumn - 在指定列前插入新列，传 undefined 在开头插入
  * @property setPageParam - 设置分页参数，支持部分更新和函数式更新
- * @property resetQueryParams - 重置分页到第一页并恢复搜索条件到初始值
+ * @property resetQueryParams - 恢复分页与搜索条件到初始化时的快照（含自定义分页键，非固定回到第一页）
  *
  * @example
  * ```ts

package/src/shared/core/index.ts

@@ -1,6 +1,5 @@
 /**
- * 统一 re-export @qin-ui/pro-components-core，包内所有文件通过此文件引入 core 内容，
- * 避免直接散列依赖 @qin-ui/pro-components-core，便于将来统一维护。
+ * 统一 re-export @qin-ui/pro-components-core，包内所有文件通过此文件引入 core 内容。
  */
 export {
   // hooks