@zat-design/sisyphus-react 4.4.1-beta.2 → 4.4.1-beta.3

package/es/ProTable/index.js

@@ -1,11 +1,10 @@
-import _isBoolean from "lodash/isBoolean";
-import _isFunction from "lodash/isFunction";
 import _isObject from "lodash/isObject";
 import _assign from "lodash/assign";
 import _keyBy from "lodash/keyBy";
-import { useEffect, useMemo, useState, createContext } from 'react';
+import React, { useEffect, useMemo, useState, createContext, useRef, forwardRef } from 'react';
 import { useDebounceEffect, useDeepCompareEffect, useSetState } from 'ahooks';
 import classnames from 'classnames';
+import { Form } from 'antd';
 import { useProConfig } from "../index";
 import { RenderTableHeader, RenderFooter, RenderTabs } from "./components";
 import useAntdTable, { SELECTION_ALL, CURRENT_PAGE, UNCHECK_ALL } from "./hooks/useAntdTable";
@@ -14,7 +13,8 @@ import { formatColumn } from "./components/FormatColumn";
 import empty from "../assets/empty.png";
 import resetSvg from "../assets/reset.svg";
 import customColumnSvg from "../assets/customColumn.svg";
-import { getColumnDataIndex, getRowKey } from "./utils";
+import { filterVisibleColumns, getColumnDataIndex, getRowKey } from "./utils";
+import { baseStorage, getColumnCache, getColumnCacheSync, removeColumnCache, setColumnCache } from "./utils/columnStorage";
 import locale from "../locale";
 import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const defaultCacheTime = 1; // columns 配置保存时间为一天
@@ -25,7 +25,7 @@ export const defaultPage = {
   pageNum: 1,
   pageSize: 10
 };
-const ProTable = props => {
+const ProTable = /*#__PURE__*/forwardRef((props, tableRef) => {
   const {
     storage: configStorage
   } = useProConfig('globalConfig') || {}; // 获取全局缓存位置配置
@@ -53,8 +53,13 @@ const ProTable = props => {
     onDragStart: onDragStartGuard,
     onDragEnd: onDragEndGuard,
     tabs,
+    editMode = 'per-cell-form',
     ...restProps
   } = props;
+
+  // shared-form 模式下顶层创建一份 Form 实例，所有 EditableCell 复用；
+  // per-cell-form 默认模式下不消费此实例（antd 的 useForm 必须无条件调用以满足 hooks rule）
+  const [sharedForm] = Form.useForm();
   const {
     scrollFollowParent = true
   } = props;
@@ -125,17 +130,33 @@ const ProTable = props => {
   } = window.location;
   // 以pathname + tableId作为缓存配置key
   const pathKey = `${pathname}/${tableId || ''}`;
-  const Storage = storage === 'sessionStorage' ? sessionStorage : localStorage;
-  const tableConfig = Storage.getItem('tableConfig');
-  const curTableConfig = tableConfig ? JSON.parse(tableConfig) : {};
-  const startTime = curTableConfig[pathKey]?.startTime;
+
+  // 默认 storage 为 'indexedDB'（baseStorage），与 ProEnum 一致
+  const effectiveStorage = storage ?? baseStorage;
+
+  // 同步首读：localStorage / sessionStorage 命中即返回；indexedDB 未命中内存时返回 undefined（异步兜底）
+  const [columnEntry, setColumnEntry] = useState(() => getColumnCacheSync(effectiveStorage, pathKey));
+
+  // indexedDB 模式：异步加载 + setState 平滑替换（不闪烁）
+  useEffect(() => {
+    if (effectiveStorage !== 'indexedDB') return;
+    let cancelled = false;
+    Promise.resolve(getColumnCache(effectiveStorage, pathKey)).then(entry => {
+      if (cancelled) return;
+      if (entry) setColumnEntry(entry);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [effectiveStorage, pathKey]);
+  const startTime = columnEntry?.startTime;
   const [curColumns, setCurColumns] = useState(propsColumns);
   useDeepCompareEffect(() => {
     let localColumns;
     const duration = (typeof cacheTime === 'number' ? cacheTime : defaultCacheTime) * 86400000;
     // 开启缓存配置功能且缓存存在时，从缓存中获取缓存配置
     if (cacheTime && startTime && new Date().getTime() - startTime < duration) {
-      localColumns = curTableConfig[pathKey]?.columns?.map(item => ({
+      localColumns = columnEntry?.columns?.map(item => ({
         ...propsColumnObj[getColumnDataIndex(item.dataIndex)],
         dataIndex: item.dataIndex,
         width: resizeColumn ? item?.width : propsColumnObj[getColumnDataIndex(item.dataIndex)]?.width
@@ -145,16 +166,13 @@ const ProTable = props => {
     } else {
       setCurColumns(propsColumns);
     }
-  }, [pathKey, cacheTime, propsColumns]);
+  }, [pathKey, cacheTime, propsColumns, columnEntry]);
   useEffect(() => {
-    if (!cacheTime && JSON.stringify(curTableConfig) !== '{}') {
-      // 关闭缓存时，清理对应table缓存
-      Storage.setItem('tableConfig', JSON.stringify({
-        ...curTableConfig,
-        [pathKey]: undefined
-      }));
+    if (!cacheTime && columnEntry) {
+      // 关闭缓存时，清理对应 table 缓存
+      removeColumnCache(effectiveStorage, pathKey);
     }
-  }, [cacheTime, curTableConfig, storage]);
+  }, [cacheTime, columnEntry, effectiveStorage, pathKey]);
 
   // 重置列宽，恢复至props的columns列宽
   const resetColumnWidth = () => {
@@ -190,7 +208,7 @@ const ProTable = props => {
     }
   };
   const formatColumns = nextColumns => {
-    nextColumns?.forEach((item, index) => {
+    nextColumns?.forEach(item => {
       formatColumn({
         column: item,
         originalObj,
@@ -198,10 +216,9 @@ const ProTable = props => {
         diffConfig,
         wrapToolTipProps,
         scroll: _scroll,
-        onUpdateMinWidth: w => {
-          curColumns[index].minWidth = w;
-        },
-        isInNewRow: _isInNewRow
+        isInNewRow: _isInNewRow,
+        editMode,
+        sharedForm: editMode === 'shared-form' ? sharedForm : undefined
       });
       if (item.children && Array.isArray(item.children)) {
         formatColumns(item.children);
@@ -228,19 +245,30 @@ const ProTable = props => {
     const nextColumns = formatColumns(newColumns);
     return nextColumns;
   }, [curColumns, handleResize, _scroll, originalDataSource, originalObj, _isInNewRow]);
-  const _columns = useMemo(() => columns?.filter((item, index) => {
+
+  // 仅在 dev 环境针对 column.show 提示一次（按实例去重）
+  const showDeprecationWarnedRef = useRef(false);
+  const _columns = useMemo(() => {
     const {
-      show
-    } = item;
-    if (_isBoolean(show)) {
-      return show;
-    }
-    if (_isFunction(show)) {
-      return show();
+      columns: filtered,
+      usedShow
+    } = filterVisibleColumns(columns || []);
+    if (usedShow && process.env.NODE_ENV !== 'production' && !showDeprecationWarnedRef.current) {
+      showDeprecationWarnedRef.current = true;
+      // eslint-disable-next-line no-console
+      console.warn('[ProTable] column.show is deprecated, please use column.hidden (antd 5.13+ native) instead. column.show 已废弃，请改用 column.hidden（antd 5.13+ 原生支持）。');
     }
-    return true;
-  }), [columns]);
+    return filtered;
+  }, [columns]);
   const isExistPercentWidth = !!_columns?.find(item => item?.width && typeof item?.width === 'string' && item?.width?.endsWith('%'));
+
+  // shared-form 模式下，仅当存在 editConfig 列时才需要包共享 Form Provider；
+  // 否则不挂载 Form，避免给纯展示型表格注入无意义的 Form Context
+  const hasEditConfigColumn = useMemo(() => {
+    const walk = (cols = []) => cols.some(c => Boolean(c?.editConfig) || Array.isArray(c?.children) && walk(c.children));
+    return walk(propsColumns);
+  }, [propsColumns]);
+  const shouldWrapSharedForm = editMode === 'shared-form' && hasEditConfigColumn;
   if (isExistPercentWidth) {
     _scroll = props?.scroll;
   }
@@ -268,19 +296,16 @@ const ProTable = props => {
   };
   useDebounceEffect(() => {
     if (cacheTime) {
-      const newTableConfig = {
-        ...curTableConfig,
-        [pathKey]: {
-          startTime: new Date().getTime(),
-          columns: curColumns?.map(item => ({
-            dataIndex: item.dataIndex,
-            width: typeof item.width === 'number' ? Math.round(Number(item.width)) : item.width
-          }))
-        }
+      const newEntry = {
+        startTime: new Date().getTime(),
+        columns: curColumns?.map(item => ({
+          dataIndex: item.dataIndex,
+          width: typeof item.width === 'number' ? Math.round(Number(item.width)) : item.width
+        }))
       };
-      Storage.setItem('tableConfig', JSON.stringify(newTableConfig));
+      setColumnCache(effectiveStorage, pathKey, newEntry);
     }
-  }, [cacheTime, storage, pathKey, curColumns], {
+  }, [cacheTime, effectiveStorage, pathKey, curColumns], {
     wait: 100
   });
   const customColumns = useMemo(() => propsColumns.map(item => ({
@@ -346,80 +371,95 @@ const ProTable = props => {
     '--zaui-contract-bg': changeTipColor,
     '--zaui-contract-bg-add': addTipColor
   };
-  return /*#__PURE__*/_jsx(TableContext.Provider, {
-    value: {
-      pathKey,
-      tableConfig,
-      Storage
-    },
-    children: /*#__PURE__*/_jsxs("div", {
-      className: cls,
-      children: [tabs && /*#__PURE__*/_jsx(RenderTabs, {
-        ...tabs,
-        formTableProps: restProps?.formTableProps
-      }), /*#__PURE__*/_jsx(RenderTableHeader, {
-        dataSource: {
+  const tableContent = /*#__PURE__*/_jsxs("div", {
+    className: cls,
+    children: [tabs && /*#__PURE__*/_jsx(RenderTabs, {
+      ...tabs,
+      formTableProps: restProps?.formTableProps
+    }), /*#__PURE__*/_jsx(RenderTableHeader, {
+      dataSource: {
+        headerRender,
+        columnConfig,
+        resizeColumn,
+        resetSvg,
+        resetColumnWidth,
+        locale,
+        customColumns,
+        checkColumns,
+        handleColumnConfig,
+        customColumnSvg
+      }
+    }), /*#__PURE__*/_jsxs("div", {
+      className: "pro-table-container",
+      style: tagStyle,
+      children: [/*#__PURE__*/_jsx(TableComponent, {
+        ref: tableRef,
+        ...restProps,
+        draggableProps: {
+          onChange: onDataSourceChange,
+          draggable,
+          rowKey,
+          onDragStartGuard,
+          onDragEndGuard
+        },
+        tableProps: {
+          value: _dataSource,
           headerRender,
-          columnConfig,
-          resizeColumn,
-          resetSvg,
-          resetColumnWidth,
+          columns: _columns,
+          renderRowSelection,
+          rowClassName: _rowClassName,
+          disabled,
+          resizeColumn
+        },
+        emptyTextProps: {
+          empty,
           locale,
-          customColumns,
-          checkColumns,
-          handleColumnConfig,
-          customColumnSvg
-        }
-      }), /*#__PURE__*/_jsxs("div", {
-        className: "pro-table-container",
-        style: tagStyle,
-        children: [/*#__PURE__*/_jsx(TableComponent, {
-          ...restProps,
-          draggableProps: {
-            onChange: onDataSourceChange,
-            draggable,
-            rowKey,
-            onDragStartGuard,
-            onDragEndGuard
-          },
-          tableProps: {
-            value: _dataSource,
-            headerRender,
-            columns: _columns,
-            renderRowSelection,
-            rowClassName: _rowClassName,
-            disabled,
-            resizeColumn
-          },
-          emptyTextProps: {
-            empty,
-            locale,
-            emptyText
-          },
-          summaryProps: {
-            summary,
-            dataSource: _dataSource
-          },
-          dataSource: _dataSource,
-          scroll: _scroll
-        }), /*#__PURE__*/_jsx("span", {
-          className: "pro-table-resizable-line",
-          style: {
-            display: 'none'
-          }
-        })]
-      }), /*#__PURE__*/_jsx(RenderFooter, {
-        dataSource: {
-          footerRender,
-          pagination,
-          _dataSource
+          emptyText
+        },
+        summaryProps: {
+          summary,
+          dataSource: _dataSource
+        },
+        dataSource: _dataSource,
+        scroll: _scroll
+      }), /*#__PURE__*/_jsx("span", {
+        className: "pro-table-resizable-line",
+        style: {
+          display: 'none'
         }
       })]
-    })
+    }), /*#__PURE__*/_jsx(RenderFooter, {
+      dataSource: {
+        footerRender,
+        pagination,
+        _dataSource
+      }
+    })]
   });
-};
+
+  // 向后兼容：旧 Context 字段映射到新 columnStorage 语义
+  // - tableConfig 之前是 { [pathKey]: entry } 的 JSON map；现仍按此结构包一层
+  // - Storage 之前是 Storage 实例；indexedDB 模式下不可同步访问，返回 null
+  const legacyTableConfig = columnEntry ? {
+    [pathKey]: columnEntry
+  } : {};
+  const legacyStorage = effectiveStorage === 'localStorage' ? window.localStorage : effectiveStorage === 'sessionStorage' ? window.sessionStorage : null;
+  return /*#__PURE__*/_jsx(TableContext.Provider, {
+    value: {
+      pathKey,
+      tableConfig: legacyTableConfig,
+      Storage: legacyStorage
+    },
+    children: shouldWrapSharedForm ? /*#__PURE__*/_jsx(Form, {
+      form: sharedForm,
+      component: false,
+      children: tableContent
+    }) : tableContent
+  });
+});
 ProTable.useAntdTable = useAntdTable;
 ProTable.SELECTION_ALL = SELECTION_ALL;
 ProTable.CURRENT_PAGE = CURRENT_PAGE;
 ProTable.UNCHECK_ALL = UNCHECK_ALL;
+export { getColumnCache, setColumnCache, removeColumnCache } from "./utils/columnStorage";
 export default ProTable;

package/es/ProTable/propsType.d.ts

@@ -117,9 +117,9 @@ export interface ProTableColumnType extends Omit<ColumnType<any>, 'dataIndex'> {
      */
     width?: number | string;
     /**
-     * 最小宽度
-     * @description 设置在拖拽调节列宽过程中的最小宽度
-     * @default 50
+     * 列最小宽度
+     * @description 透传至 antd Table column.minWidth（antd 5.21+），用于 tableLayout='auto' 下计算最小列宽；同时作为列宽拖拽下限
+     * @default undefined
      */
     minWidth?: number;
     /**
@@ -194,9 +194,16 @@ export interface ProTableColumnType extends Omit<ColumnType<any>, 'dataIndex'> {
      * @default undefined
      */
     transform?: (value: any, record?: any) => string[];
+    /**
+     * 列隐藏（antd 5.13+ 原生支持）
+     * @description 控制列是否隐藏；优先级高于 show
+     * @default undefined
+     */
+    hidden?: boolean;
     /**
      * 列头显示控制
-     * @description 控制列是否显示
+     * @deprecated 请改用 column.hidden（antd 5.13+ 原生支持）。show 将在后续版本移除。
+     * @description 控制列是否显示；当 hidden 缺省时回退此字段
      * @default true
      */
     show?: boolean | (() => boolean);
@@ -462,10 +469,10 @@ export interface ProTableType<T = any> extends Omit<TableProps<any>, 'summary' |
     sortColumnText?: string;
     /**
      * 浏览器缓存位置
-     * @description 用于设置表格配置的存储位置
+     * @description 用于设置表格列配置的存储位置；'indexedDB' 走异步存储，容量大且不阻塞主线程；其他两种走同步 Web Storage。
      * @default 'localStorage'
      */
-    storage?: 'localStorage' | 'sessionStorage';
+    storage?: 'localStorage' | 'sessionStorage' | 'indexedDB';
     /**
      * 自定义 table footer 左侧渲染
      * @description 可以是 ReactNode 或返回 ReactNode 的函数
@@ -544,6 +551,14 @@ export interface ProTableType<T = any> extends Omit<TableProps<any>, 'summary' |
      * @default true
      */
     scrollFollowParent?: boolean;
+    /**
+     * 行内编辑 Form 模式
+     * @description
+     * - 'per-cell-form'（默认）：每个 cell 独立 Form 实例，行为与重构前一致
+     * - 'shared-form'：ProTable 顶层创建共享 Form，所有 cell 复用，并自动注入 column.shouldCellUpdate 实现单 cell 精确更新
+     * @default 'per-cell-form'
+     */
+    editMode?: 'per-cell-form' | 'shared-form';
     [key: string]: any;
 }
 /**

package/es/ProTable/utils/columnStorage.d.ts

@@ -0,0 +1,35 @@
+export type StorageType = 'localStorage' | 'sessionStorage' | 'indexedDB';
+/** v4 默认列缓存存储类型 */
+export declare const baseStorage: StorageType;
+/** 单条列缓存条目结构 */
+export interface ColumnCacheEntry {
+    startTime?: number;
+    columns?: any[];
+    [key: string]: any;
+}
+/**
+ * 同步读取列缓存
+ * - localStorage / sessionStorage：直接同步读
+ * - indexedDB：仅命中内存缓存时同步返回，否则 undefined（业务侧需异步兜底）
+ */
+export declare function getColumnCacheSync(storage: StorageType, pathKey: string): ColumnCacheEntry | undefined;
+/**
+ * 读取列缓存
+ * - localStorage / sessionStorage：同步返回
+ * - indexedDB：返回 Promise；命中内存缓存时同样走 Promise（保持调用侧一致）
+ */
+export declare function getColumnCache(storage: StorageType, pathKey: string): ColumnCacheEntry | undefined | Promise<ColumnCacheEntry | undefined>;
+/**
+ * 写入列缓存
+ * - localStorage / sessionStorage：同步写
+ * - indexedDB：同步预热内存缓存 + 异步持久化（返回 Promise）
+ */
+export declare function setColumnCache(storage: StorageType, pathKey: string, value: ColumnCacheEntry): void | Promise<void>;
+/**
+ * 删除列缓存
+ */
+export declare function removeColumnCache(storage: StorageType, pathKey: string): void | Promise<void>;
+/**
+ * 仅供测试：重置内存缓存与 IndexedDB 可用性探测结果
+ */
+export declare function __resetColumnCacheForTest(): void;

package/es/ProTable/utils/columnStorage.js

@@ -0,0 +1,171 @@
+import { get as idbGet, set as idbSet, del as idbDel } from 'idb-keyval';
+/** v4 默认列缓存存储类型 */
+export const baseStorage = 'localStorage';
+
+/** 顶层共享 key（向后兼容现有 localStorage / sessionStorage 中已存在的 'tableConfig' 数据） */
+const TOP_KEY = 'tableConfig';
+
+/** 单条列缓存条目结构 */
+
+/** 模块级内存缓存：pathKey → ColumnCacheEntry */
+const memoryCache = new Map();
+
+/** IndexedDB 可用性探测结果（首次 set/del 试探后缓存） */
+let indexedDBAvailable = null;
+const isSSR = () => typeof window === 'undefined';
+const getWebStorage = storage => {
+  if (isSSR()) return null;
+  return storage === 'sessionStorage' ? window.sessionStorage : window.localStorage;
+};
+const readTopMap = storage => {
+  const ws = getWebStorage(storage);
+  if (!ws) return {};
+  try {
+    const raw = ws.getItem(TOP_KEY);
+    if (!raw) return {};
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === 'object' ? parsed : {};
+  } catch {
+    return {};
+  }
+};
+const writeTopMap = (storage, next) => {
+  const ws = getWebStorage(storage);
+  if (!ws) return;
+  ws.setItem(TOP_KEY, JSON.stringify(next));
+};
+async function checkIndexedDBSupport() {
+  if (indexedDBAvailable !== null) return indexedDBAvailable;
+  try {
+    await idbSet('__pro_table_idb_test__', 1);
+    await idbDel('__pro_table_idb_test__');
+    indexedDBAvailable = true;
+    return true;
+  } catch (error) {
+    // eslint-disable-next-line no-console
+    console.warn('ProTable: IndexedDB is not available, falling back to localStorage. 列缓存默认存储 IndexedDB 不可用，已自动降级到 localStorage。', error);
+    indexedDBAvailable = false;
+    return false;
+  }
+}
+
+/**
+ * 同步读取列缓存
+ * - localStorage / sessionStorage：直接同步读
+ * - indexedDB：仅命中内存缓存时同步返回，否则 undefined（业务侧需异步兜底）
+ */
+export function getColumnCacheSync(storage, pathKey) {
+  if (memoryCache.has(pathKey)) return memoryCache.get(pathKey);
+  if (storage === 'localStorage' || storage === 'sessionStorage') {
+    const map = readTopMap(storage);
+    const entry = map[pathKey];
+    memoryCache.set(pathKey, entry);
+    return entry;
+  }
+  return undefined;
+}
+
+/**
+ * 读取列缓存
+ * - localStorage / sessionStorage：同步返回
+ * - indexedDB：返回 Promise；命中内存缓存时同样走 Promise（保持调用侧一致）
+ */
+export function getColumnCache(storage, pathKey) {
+  if (storage === 'localStorage' || storage === 'sessionStorage') {
+    return getColumnCacheSync(storage, pathKey);
+  }
+  // indexedDB
+  if (memoryCache.has(pathKey)) {
+    return Promise.resolve(memoryCache.get(pathKey));
+  }
+  if (isSSR()) {
+    return Promise.resolve(undefined);
+  }
+  return checkIndexedDBSupport().then(async ok => {
+    if (!ok) {
+      // 降级路径：尝试从 localStorage 读取
+      const map = readTopMap('localStorage');
+      const entry = map[pathKey];
+      memoryCache.set(pathKey, entry);
+      return entry;
+    }
+    try {
+      const value = await idbGet(pathKey);
+      memoryCache.set(pathKey, value);
+      return value;
+    } catch (error) {
+      // eslint-disable-next-line no-console
+      console.warn('ProTable: IndexedDB read failed:', error);
+      return undefined;
+    }
+  });
+}
+
+/**
+ * 写入列缓存
+ * - localStorage / sessionStorage：同步写
+ * - indexedDB：同步预热内存缓存 + 异步持久化（返回 Promise）
+ */
+export function setColumnCache(storage, pathKey, value) {
+  memoryCache.set(pathKey, value);
+  if (isSSR()) return;
+  if (storage === 'localStorage' || storage === 'sessionStorage') {
+    const map = readTopMap(storage);
+    map[pathKey] = value;
+    writeTopMap(storage, map);
+    return;
+  }
+  // indexedDB
+  return checkIndexedDBSupport().then(async ok => {
+    if (!ok) {
+      // 降级到 localStorage
+      const map = readTopMap('localStorage');
+      map[pathKey] = value;
+      writeTopMap('localStorage', map);
+      return;
+    }
+    try {
+      await idbSet(pathKey, value);
+    } catch (error) {
+      // eslint-disable-next-line no-console
+      console.warn('ProTable: IndexedDB write failed:', error);
+    }
+  });
+}
+
+/**
+ * 删除列缓存
+ */
+export function removeColumnCache(storage, pathKey) {
+  memoryCache.delete(pathKey);
+  if (isSSR()) return;
+  if (storage === 'localStorage' || storage === 'sessionStorage') {
+    const map = readTopMap(storage);
+    delete map[pathKey];
+    writeTopMap(storage, map);
+    return;
+  }
+  // indexedDB
+  return checkIndexedDBSupport().then(async ok => {
+    if (!ok) {
+      const map = readTopMap('localStorage');
+      delete map[pathKey];
+      writeTopMap('localStorage', map);
+      return;
+    }
+    try {
+      await idbDel(pathKey);
+    } catch (error) {
+      // eslint-disable-next-line no-console
+      console.warn('ProTable: IndexedDB delete failed:', error);
+    }
+  });
+}
+
+/**
+ * 仅供测试：重置内存缓存与 IndexedDB 可用性探测结果
+ */
+export function __resetColumnCacheForTest() {
+  memoryCache.clear();
+  indexedDBAvailable = null;
+}

package/es/ProTable/utils/index.d.ts

@@ -1,3 +1,19 @@
+/**
+ * 列可见性过滤：hidden 优先（antd 5.13+ 原生），show 兼容（已废弃）
+ * - hidden 为布尔值 → 直接按 hidden 决定
+ * - hidden 缺省、show 为布尔值 → 按 show 决定
+ * - hidden 缺省、show 为函数 → 调用 show() 决定
+ * - 都缺省 → 显示
+ *
+ * 返回过滤后的列与 deprecated show 使用情况，由调用方决定告警时机/去重。
+ */
+export declare const filterVisibleColumns: <T extends {
+    hidden?: boolean;
+    show?: boolean | (() => boolean);
+}>(columns?: T[]) => {
+    columns: T[];
+    usedShow: boolean;
+};
 /**
  * 获取小数点后的位数
  * @param num 数字
@@ -34,5 +50,3 @@ export declare const removeEmptyKeys: (obj?: Record<string, any>) => {
 };
 /** 判断是有值的对象 */
 export declare const isNonEmptyObject: (obj: any) => obj is Record<string, any>;
-/** 解析宽度值 */
-export declare const parseWidth: (widthValue: number | string | undefined, trWidth: number) => number;