@qin-ui/element-plus-pro 1.3.0 → 1.3.2

package/es/locale/en-US.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"en-US.d.ts","sourceRoot":"","sources":["../../src/locale/en-US.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAQA,wBAYW"}

package/es/{src/locale → locale}/index.d.ts

@@ -1,5 +1,5 @@
 import { InjectionKey, MaybeRef } from 'vue';
-import { ProLocaleName } from '@qin-ui/pro-components-core';
+import { ProLocaleName } from '../shared/core';
 import { default as zhCN } from './zh-CN';
 import { default as zhTW } from './zh-TW';
 import { default as enUS } from './en-US';

package/es/locale/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/locale/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,KAAK,CAAC;AAEb,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAE5B,MAAM,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC;AAEpC,4CAA4C;AAC5C,eAAO,MAAM,iBAAiB,EAAE,YAAY,CAC1C,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,CAClB,CAAC;AAEzB;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,SAAS;aAaJ,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAG,MAAM;;CAQ1E,CAAC"}

package/es/locale/zh-CN.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zh-CN.d.ts","sourceRoot":"","sources":["../../src/locale/zh-CN.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAQA,wBAYW"}

package/es/locale/zh-TW.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zh-TW.d.ts","sourceRoot":"","sources":["../../src/locale/zh-TW.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAQA,wBAYW"}

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

@@ -0,0 +1,6 @@
+/**
+ * 统一 re-export @qin-ui/pro-components-core，包内所有文件通过此文件引入 core 内容，
+ * 避免直接散列依赖 @qin-ui/pro-components-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

@@ -0,0 +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"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/ui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,IAAI,IAAI,EACd,UAAU,IAAI,QAAQ,EACtB,KAAK,IAAI,IAAI,EACb,KAAK,IAAI,QAAQ,EACjB,OAAO,IAAI,KAAK,EAChB,aAAa,IAAI,WAAW,EAC5B,OAAO,IAAI,KAAK,EAChB,UAAU,IAAI,QAAQ,EACtB,cAAc,IAAI,YAAY,EAC9B,cAAc,IAAI,YAAY,EAC9B,UAAU,IAAI,QAAQ,EACtB,eAAe,IAAI,aAAa,EAChC,QAAQ,IAAI,MAAM,EAClB,cAAc,IAAI,YAAY,EAC9B,UAAU,IAAI,QAAQ,EACtB,YAAY,IAAI,UAAU,EAC1B,OAAO,IAAI,KAAK,EAChB,aAAa,IAAI,WAAW,EAC5B,QAAQ,IAAI,MAAM,EAClB,QAAQ,IAAI,MAAM,EAClB,QAAQ,IAAI,MAAM,EAClB,UAAU,IAAI,QAAQ,EACtB,YAAY,IAAI,UAAU,EAC1B,YAAY,IAAI,UAAU,EAC1B,YAAY,IAAI,UAAU,EAC1B,YAAY,IAAI,UAAU,EAC1B,YAAY,IAAI,UAAU,EAE1B,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,IAAI,WAAW,EAC9B,KAAK,cAAc,IAAI,UAAU,EACjC,KAAK,eAAe,EACpB,KAAK,QAAQ,IAAI,SAAS,EAC1B,KAAK,QAAQ,IAAI,aAAa,EAC/B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,gBAAgB,EAAsC,MAAM,KAAK,CAAC;AAEhF,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,KAAK,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,KAAK,EACL,WAAW,EACX,MAAM,EACN,MAAM,EACN,MAAM,EACN,QAAQ,EACR,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;AAO1C,eAAO,MAAM,UAAU,WAAoB,CAAC;AAC5C,eAAO,MAAM,eAAe,WAAyB,CAAC;AACtD,eAAO,MAAM,aAAa,WAAuB,CAAC;AAClD,eAAO,MAAM,aAAa,WAAuB,CAAC;AAIlD,eAAO,MAAM,kBAAkB,0CAS9B,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,UAAU,gBAAgB,CAAC,OAAO,GAAG,SAAS,CAAC,SAMhD,CAAC;AAEF,eAAO,MAAM,iBAAiB,0CAAqB,CAAC;AACpD,eAAO,MAAM,mBAAmB,aATpB,gBAAgB,CAAC,OAAO,GAAG,SAAS,CAAC,SASY,CAAC;AAE9D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qin-ui/element-plus-pro",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "基于 element-plus 的二次封装组件",
   "bin": {
     "element-plus-pro": "./bin/init-ai.mjs"
@@ -39,7 +39,7 @@
   },
   "dependencies": {
     "vue-component-type-helpers": "^3.2.5",
-    "@qin-ui/pro-components-core": "^2.0.0"
+    "@qin-ui/pro-components-core": "^2.0.1"
   },
   "devDependencies": {
     "@vue/test-utils": "^2.4.11",

package/src/components/component-provider/components/index.vue

@@ -93,9 +93,10 @@ if (props.componentVars) {
 }
 
 // 注入自定义组件映射，BaseField 在解析组件时会优先使用此映射
-if (props.componentMap) {
-  provide(INJECT_COMPONENTS, props.componentMap);
-}
+provide(
+  INJECT_COMPONENTS,
+  computed(() => props.componentMap)
+);
 
 // 注入内置文案覆盖，useLocale 在解析文案时会优先使用
 provide(

package/src/components/component-provider/constants/index.ts

@@ -1,5 +1,5 @@
 import { RequiredComponentVars } from '../types';
-import { InjectionKey, Component } from 'vue';
+import { InjectionKey, Component, type ComputedRef } from 'vue';
 
 export type InjectConfigEntry<T = any> = {
   injectionKey: InjectionKey<T>;
@@ -61,7 +61,7 @@ export const INJECT_CONFIG: {
     injectionKey: Symbol(''),
     default: {
       max: 10 ** 15 - 1,
-      min: -(10 ** 15 + 1),
+      min: -(10 ** 15 - 1),
       controls: false,
       style: { width: '100%' },
     },
@@ -165,7 +165,8 @@ export const INJECT_CONFIG: {
 };
 
 export const INJECT_COMPONENTS: InjectionKey<
-  Partial<Record<string, Component>>
+  | ComputedRef<Partial<Record<string, Component>> | undefined>
+  | Partial<Record<string, Component>>
 > = Symbol('INJECT_COMPONENTS');
 
 const DYNAMIC_INJECT_CONFIG: Record<string, InjectConfigEntry> =

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

@@ -46,7 +46,7 @@ import {
   getInjectConfig,
 } from '../../../component-provider/constants';
 import { useForm } from '../../hooks/useForm';
-import { getInitProps } from './utils';
+import { getInitProps, warnUnknownComponent } from './utils';
 import { useLocale } from '../../../../locale';
 
 defineOptions({ name: 'BaseField', inheritAttrs: false });
@@ -142,7 +142,6 @@ const groupedAttrs = computed(() => {
     initProps,
     attrs,
     { class: attrs.componentClass, style: attrs.componentStyle },
-    { class: initProps.componentClass, style: initProps.componentStyle },
     { disabled: effectiveDisabled },
     { modelProp: modelPropName }
   ) as Required<Field>;
@@ -177,12 +176,10 @@ const is = computed(() => {
   if (teleportSlot) return teleportSlot;
   if (typeof props.component === 'string') {
     const resolved =
-      (customComponents as any)[props.component] ||
+      toValue(customComponents as any)?.[props.component] ||
       (componentMap as any)[props.component];
     if (resolved) return resolved;
-    console.warn(
-      `[pro-components] 未识别的组件类型 "${props.component}"，已降级为原生元素渲染。如为自定义组件请在 componentMap 或 ProComponentProvider 中注册。`
-    );
+    warnUnknownComponent(props.component);
     return props.component;
   }
   return props.component;

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

@@ -71,3 +71,14 @@ export const getInitProps = (
   }
   return {};
 };
+
+/** 已告警过的未知组件名（模块级去重，避免 computed 重算导致刷屏） */
+const warnedUnknownComponents = new Set<string>();
+
+export function warnUnknownComponent(name: string) {
+  if (warnedUnknownComponents.has(name)) return;
+  warnedUnknownComponents.add(name);
+  console.warn(
+    `[pro-components] 未识别的组件类型 "${name}"，已降级为原生元素渲染。如为自定义组件请在 componentMap 或 ProComponentProvider 中注册。`
+  );
+}

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

@@ -47,7 +47,8 @@ const props = withDefaults(defineProps<Props>(), {
 });
 
 const validFields = computed(() =>
-  (props.fields ?? []).filter(field => !field.hidden)
+  // hidden 支持 Ref/ComputedRef/getter 等响应式形态（统一使用 toValue 取值）
+  (props.fields ?? []).filter(field => !toValue(field.hidden))
 );
 
 const config = INJECT_CONFIG['pro-form'];

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

@@ -41,7 +41,11 @@ import { INJECT_CONFIG } from '../../../component-provider/constants';
 import { BaseFormItem } from '..';
 import { InjectionFormKey, InjectionFormSlotsKey } from '../../constants';
 import type { Grid, VModelProps, PathProps } from '../../types';
-import { Path, camelizeProperties } from '../../../../shared/core';
+import {
+  Path,
+  camelizeProperties,
+  createFormProxy,
+} from '../../../../shared/core';
 import { useForm, type Form } from '../../hooks/useForm';
 
 defineOptions({ name: 'ProForm', inheritAttrs: false });
@@ -69,27 +73,9 @@ const currentForm = computed(
 
 /**
  * 表单实例代理：操作全部转发至 currentForm 当前实例；
- * 下游持有本代理即可，:form 运行期替换无需重绑。
+ * 下游持有本代理即可，:form 运行期替换无需重绑；方法具有引用记忆化。
  */
-const formProxy = new Proxy({} as F, {
-  get(_, prop) {
-    const target = currentForm.value as any;
-    const val = target?.[prop];
-    if (typeof val === 'function') {
-      return (...args: any[]) => (currentForm.value as any)?.[prop]?.(...args);
-    }
-    return val;
-  },
-  set(_, prop, value) {
-    if (currentForm.value) {
-      (currentForm.value as any)[prop] = value;
-    }
-    return true;
-  },
-  has(_, prop) {
-    return Boolean(currentForm.value && prop in currentForm.value);
-  },
-});
+const formProxy = createFormProxy(() => currentForm.value);
 
 provide(InjectionFormKey, formProxy);
 
@@ -124,6 +110,10 @@ const injectAttrs = computed(() => {
   return rest;
 });
 
+const formAttrs = computed(() => {
+  return mergeProps(injectAttrs.value, camelizeProperties(attrs));
+});
+
 type ExtractPath<T> = T extends Form<infer D> ? Path<D> : string;
 type FieldSlotProps = VModelProps &
   PathProps & { disabled?: boolean; [x: string]: any };
@@ -143,7 +133,7 @@ provide(InjectionFormSlotsKey, slots);
     :key="formKey"
     :ref="setFormRef"
     :model="formData"
-    v-bind="mergeProps(injectAttrs, camelizeProperties(attrs))"
+    v-bind="formAttrs"
     class="pro-form"
     @submit.prevent
   >

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

@@ -5,7 +5,6 @@
  *
  * @public
  */
-import { isVNode } from 'vue';
 import { SlotComponentType } from '../../types';
 
 defineOptions({ name: 'SlotComponent', inheritAttrs: false });
@@ -14,13 +13,17 @@ type Props = {
   component?: SlotComponentType;
 };
 defineProps<Props>();
+
+// 可组件化渲染判定：VNode / 函数（含函数式组件）/ 组件定义对象；
+// 其余（string/number/boolean/null/undefined）一律按文本渲染，
+// 避免字符串返回值被 <component :is> 当作标签名解析
+const isRenderable = (c: Props['component']) =>
+  c !== null &&
+  c !== undefined &&
+  (typeof c === 'function' || typeof c === 'object');
 </script>
 
 <template>
-  <component
-    :is="component"
-    v-if="isVNode(component) || typeof component === 'function'"
-    v-bind="$attrs"
-  />
+  <component :is="component" v-if="isRenderable(component)" v-bind="$attrs" />
   <template v-else>{{ component }}</template>
 </template>

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

@@ -14,6 +14,9 @@ const formItemPropKeys = Object.keys(formItemProps()).filter(
   k => k !== 'disabled'
 );
 const gridItemPropKeys = Object.keys(gridItemProps());
+// 模块级 Set：字段循环内 O(1) 命中，替代数组 includes 线性扫描
+const gridItemPropKeySet = new Set<string>(gridItemPropKeys);
+const formItemPropKeySet = new Set<string>(formItemPropKeys);
 
 export interface GroupedField {
   path: string;
@@ -75,9 +78,9 @@ export function useGroupFieldAttrs(validFields: ComputedRef<Field[]>) {
         const container = formItemContainer ?? injectFormItemContainer;
 
         Object.keys(rest).forEach(k => {
-          if (gridItemPropKeys.includes(k)) {
+          if (gridItemPropKeySet.has(k)) {
             gridItemProps[k] = rest[k];
-          } else if (formItemPropKeys.includes(k)) {
+          } else if (formItemPropKeySet.has(k)) {
             (formItemProps as any)[k] = rest[k];
           } else {
             componentProps[k] = rest[k];

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

@@ -6,7 +6,7 @@ import {
   DropdownItem,
   Checkbox,
 } from '../../../shared/ui';
-import { computed, onMounted, ref, watch } from 'vue';
+import { computed, ref, watch } from 'vue';
 import type { Column, Columns, ColumnControlConfig } from '../types';
 import { type Table } from '../useTable';
 import FilterOutlined from './icons/FilterOutlined.vue';
@@ -46,18 +46,26 @@ const checkedColumnsOptions = computed<
   props.columns
     .map((item, index) => {
       const key = getColumnKey(item, index);
-      const excluded = props.columnControl?.excludedKeys?.some(
-        ek => String(ek) === key
-      );
+      // 默认排除内部序号列 __INDEX__ 及显式指定的 excludedKeys
+      const excluded =
+        key === '__INDEX__' ||
+        (item as any).type === 'index' ||
+        props.columnControl?.excludedKeys?.some(ek => String(ek) === key);
       const disabled = props.columnControl?.disabledKeys?.some(
         dk => String(dk) === key
       );
-      const label = String(
-        item.label ??
-          (item as any).title ??
-          item.prop ??
-          t('table.columnFallback', { index: index + 1 })
-      );
+      const rawTitle = item.label ?? (item as any).title;
+      const titleLabel = typeof rawTitle === 'string' ? rawTitle : undefined;
+      const propLabel =
+        item.prop !== undefined && item.prop !== null
+          ? String(item.prop)
+          : undefined;
+      const label =
+        (props.columnControl?.labels?.[key] as string) ??
+        titleLabel ??
+        propLabel ??
+        key ??
+        t('table.columnFallback', { index: index + 1 });
       return {
         label,
         value: key,
@@ -96,7 +104,6 @@ const onCheckAllChange = (value: any) => {
   checkedColumnKeys.value = checked
     ? controllableOptions.value.map(item => item.value)
     : [];
-  indeterminate.value = false;
 };
 
 const toggleColumnsItem = (val: string) => {
@@ -127,13 +134,7 @@ watch(
   { immediate: true }
 );
 
-// 强制 disabledKeys 列始终展示
-onMounted(() => {
-  props.columnControl?.disabledKeys?.forEach(key => {
-    props.table?.setColumn(String(key), { hidden: false });
-  });
-});
-
+// disabledKeys 指定的列始终强制展示
 watch(
   () => props.columnControl?.disabledKeys,
   keys => {
@@ -141,7 +142,7 @@ watch(
       props.table?.setColumn(String(key), { hidden: false });
     });
   },
-  { deep: true }
+  { immediate: true, deep: true }
 );
 </script>
 

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

@@ -83,6 +83,9 @@ defineOptions({
   inheritAttrs: false,
 });
 
+const tableProperties = Object.keys(tableProps());
+const paginationProperties = Object.keys(paginationProps());
+
 type Control = {
   sizeControl: boolean;
   columnControl: boolean | ColumnControlConfig<Path<RecordType>>;
@@ -137,9 +140,6 @@ const config = INJECT_CONFIG['pro-table'];
 const injectPropsRaw = inject(config.injectionKey, config.default);
 const injectProps = computed(() => toValue(injectPropsRaw) || {});
 
-const tableProperties = Object.keys(tableProps());
-const paginationProperties = Object.keys(paginationProps());
-
 const attrs = useAttrs() as Record<string, any>;
 
 const injectTableAttrs = computed(() => {
@@ -156,14 +156,17 @@ const attrsTableProps = computed(() => {
 const size = defineModel<TableProps['size']>('size');
 const loading = defineModel<boolean>('loading', { default: false });
 
-// 核心搜索方法：设置 loading 状态，调用外部 search 函数
+// 递增序号做请求竞态守卫，仅最新一次请求可变更 loading
+let searchSequence = 0;
 const _search = async () => {
+  const seq = ++searchSequence;
   const searchPromise = (props.search || attrs.onSearch)?.();
-  if (isPromise(searchPromise)) {
-    loading.value = true;
-    try {
-      await searchPromise;
-    } finally {
+  if (!isPromise(searchPromise)) return;
+  loading.value = true;
+  try {
+    await searchPromise;
+  } finally {
+    if (seq === searchSequence) {
       loading.value = false;
     }
   }
@@ -177,29 +180,21 @@ const reset = () => {
   });
 };
 
+const customSlotNames = [
+  'search-form',
+  'button-bar',
+  'toolbar',
+  'table',
+] as const;
+
 type CustomSlots = Readonly<
-  Partial<Record<'search-form' | 'button-bar' | 'toolbar' | 'table', Slot>>
+  Partial<Record<(typeof customSlotNames)[number], Slot>>
 >;
-
 type Slots = CustomSlots & Readonly<Record<string, Slot>>;
 
 const slots = useSlots() as Slots;
-const searchFormSlot = slots['search-form'];
-const buttonBarSlot = slots['button-bar'];
-const toolbarSlot = slots['toolbar'];
-
-const tableSlots = computed(() => {
-  const customNames = new Set([
-    'search-form',
-    'button-bar',
-    'toolbar',
-    'table',
-  ]);
-  return Object.fromEntries(
-    Object.entries(slots).filter(([name]) => !customNames.has(name))
-  ) as Record<string, Slot>;
-});
-const tableSlotNames = computed(() => Object.keys(tableSlots.value));
+const forwardedSlotNames = () =>
+  Object.keys(slots).filter(name => !customSlotNames.includes(name as any));
 
 const searchPage1st = () => {
   props.table?.setPageParam?.({ current: 1 });
@@ -242,7 +237,7 @@ const normalizedRawColumns = computed(() => {
   if (props.addIndexColumn ?? injectProps.value.addIndexColumn) {
     return [
       {
-        key: '_index',
+        key: '__INDEX__',
         type: 'index',
         label: t('table.index'),
         width: 80,
@@ -328,15 +323,14 @@ const onPaginationChange = (currentPage: number, pageSize: number) => {
   attrs.onChange?.(currentPage, pageSize);
 };
 
-const showSearch = computed(() => {
+const searchFormVisible = computed(() => {
   const searchFields = props.table?.searchForm?.fields;
   const fieldList =
     (Array.isArray(searchFields) ? searchFields : searchFields?.value) ?? [];
   return !!(
-    searchFormSlot ||
-    ((computedSearchFormConfig.value as any)?.hidden !== true &&
-      props.table?.searchForm &&
-      fieldList.filter((item: any) => !item.hidden)?.length > 0)
+    (computedSearchFormConfig.value as any)?.hidden !== true &&
+    props.table?.searchForm &&
+    fieldList.filter((item: any) => !toValue(item.hidden))?.length > 0
   );
 });
 
@@ -372,12 +366,17 @@ onMounted(() => {
     _search();
   }
 });
+
+defineExpose({
+  /** 手动触发一次查询（与内部搜索共用 loading 竞态守卫），便于外部刷新列表 */
+  search: _search,
+});
 </script>
 
 <template>
   <div class="pro-table" :class="attrs.class" :style="attrs.style">
     <ContainerFragment
-      v-if="showSearch"
+      v-if="searchFormVisible || $slots['search-form']"
       :component="computedSearchFormConfig.container"
     >
       <slot name="search-form">
@@ -393,10 +392,10 @@ onMounted(() => {
 
     <ContainerFragment :component="computedTableContainer">
       <div class="pro-table_header">
-        <div v-if="buttonBarSlot" class="pro-table_header_button-bar">
+        <div v-if="$slots['button-bar']" class="pro-table_header_button-bar">
           <slot name="button-bar" />
         </div>
-        <div v-if="toolbarSlot" class="pro-table_header_toolbar">
+        <div v-if="$slots['toolbar']" class="pro-table_header_toolbar">
           <slot name="toolbar" />
         </div>
         <div
@@ -411,7 +410,7 @@ onMounted(() => {
         >
           <ColumnControl
             :columns="
-              normalizedRawColumns.filter(item => item.key !== '_index')
+              normalizedRawColumns.filter(item => item.key !== '__INDEX__')
             "
             :table="props.table"
             :column-control="columnControlConfig"
@@ -428,7 +427,11 @@ onMounted(() => {
           :data="computedDataSource"
         >
           <TableColumnRenderer :columns="normalizedRawColumns" />
-          <template v-for="name in tableSlotNames" :key="name" #[name]="scoped">
+          <template
+            v-for="name in forwardedSlotNames()"
+            :key="name"
+            #[name]="scoped"
+          >
             <slot :name="name" v-bind="scoped" />
           </template>
         </ElTable>