@hi-ui/schema-editable-table 4.0.0-experimental.1

package/lib/esm/table.js

@@ -0,0 +1,251 @@
+/** @LICENSE
+ * @hi-ui/schema-editable-table
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-editable-table#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React, { useRef, useMemo } from 'react';
+import { useReactTable, getCoreRowModel } from '@tanstack/react-table';
+import { useSetState } from 'ahooks';
+import { useSubscription } from '@hi-ui/use-subscription';
+import { EditableControlProvider } from '@hi-ui/schema-fields';
+import { EditableSchemaTableCtx } from './ctx.js';
+import { clsPrefix, cls } from './utils/cls.js';
+import { TableContainer } from './container/index.js';
+import Header from './header/index.js';
+import Body from './body/index.js';
+import Footer from './footer/index.js';
+import DftCell from './cell/index.js';
+import { usePropsRef } from './hooks/use-props.js';
+import { useTableColumns } from './hooks/use-table-columns.js';
+import { useTableUpdate } from './hooks/use-update.js';
+import { useTableInnerCtx } from './hooks/use-inner-ctx.js';
+import { useGlobalStatic } from './hooks/use-global-static.js';
+import { useGlobalStaticActions } from './hooks/use-global-actions.js';
+import { useTableMeta } from './hooks/use-table-meta.js';
+import { CustomAggregatedFeature } from './features/_overrides/aggregated.js';
+import { CustomGetterFeature } from './features/_overrides/getter.js';
+import { OverridesFeature } from './features/_overrides/overrides.js';
+import { CustomRowSelectionFeature } from './features/_overrides/row-selection.js';
+import { CustomGroupingFeature } from './features/_overrides/grouping.js';
+import { AsyncDataGetter } from './features/async-data/getter.js';
+import { useGetFieldsValue, useGetGroupedValues } from './hooks/use-get-fields-value.js';
+import { useInitialColumnState } from './features/column-state.js';
+import { TableRowController } from './features/row-controller.js';
+import { usePaginationOpts } from './features/pagination/use-opts.js';
+import 'lodash-es';
+import '@hi-ui/checkbox';
+import '@hi-ui/radio';
+import '@hi-ui/schema-utils';
+import { useRowSelectionState } from './features/row-selection/hooks/index.js';
+import '@hi-ui/space';
+import '@hi-ui/switch';
+import '@hi-ui/pagination';
+import { usePaginationState } from './features/pagination/use-state.js';
+import { useFilterState } from './features/filter/index.js';
+import { useFilterOpts } from './features/filter/use-opts.js';
+import { useSorterState } from './features/sorter/index.js';
+import { useSorterOpts } from './features/sorter/use-opts.js';
+import '@hi-ui/icons';
+import { useRowExpandedOpts } from './features/row-expanding/use-opts.js';
+import { useRowGroupedOpts } from './features/column-grouping/use-opts.js';
+import './index.scss.js';
+import { useRowSelectionOpts } from './features/row-selection/hooks/use-opts.js';
+import HeaderCell from './cell/header.js';
+import FooterCell from './cell/footer.js';
+import AggregatedCell from './cell/aggregated.js';
+import { BottomRender } from './container/bottom.js';
+
+// @doc-comment-end code-block
+function EditableSchemaTable(props) {
+  var _a, _b, _c, _d;
+  // propsRef 存在的意义是给内部组件一个统一的 props 引用
+  // 避免 props 变化导致的内部 memo 值引用变化
+  var _usePropsRef = usePropsRef(props),
+    propsRef = _usePropsRef.propsRef,
+    staticOptsRef = _usePropsRef.staticOptsRef;
+  // innerRef 存在的意义在于简化发生循环依赖时内部的实例对象的引用方式
+  // 例如 useReactTable 需要 useRowSelectionOpts 来初始化行选择功能
+  // 而 useRowSelectionOpts 又需要用到 table 实例，如果直接引用，则会报【声明之前已使用的块范围变量】的错误
+  var innerRef = useRef({});
+  // 核心数据订阅
+  var tableValue = useSubscription((_b = (_a = props.value) !== null && _a !== void 0 ? _a : props.defaultValue) !== null && _b !== void 0 ? _b : []);
+  // 订阅表格级别的数据变化，自动触发重渲染
+  var _useTableUpdate = useTableUpdate(tableValue),
+    rerender = _useTableUpdate.rerender,
+    forceRerenderFlag = _useTableUpdate.forceRerenderFlag;
+  // 表格列配置
+  var columns = useTableColumns({
+    propsRef: propsRef
+  });
+  // 初始化列状态
+  var initialState = useInitialColumnState(props);
+  // 分页配置
+  var _usePaginationState = usePaginationState({
+      propsRef: propsRef,
+      subscription: tableValue
+    }),
+    paginationState = _usePaginationState.paginationState;
+  var paginationOpts = usePaginationOpts({
+    innerRef: innerRef,
+    staticOptsRef: staticOptsRef
+  });
+  // 筛选配置
+  var _useFilterState = useFilterState(),
+    filterState = _useFilterState.filterState;
+  var filterOpts = useFilterOpts({
+    innerRef: innerRef,
+    staticOptsRef: staticOptsRef
+  });
+  // 排序配置
+  var _useSorterState = useSorterState(),
+    sorterState = _useSorterState.sorterState;
+  var sorterOpts = useSorterOpts({
+    innerRef: innerRef,
+    staticOptsRef: staticOptsRef,
+    propsRef: propsRef
+  });
+  // 行展开配置
+  var rowExpandedOpts = useRowExpandedOpts({
+    staticOptsRef: staticOptsRef
+  });
+  // 列分组配置
+  var rowGroupedOpts = useRowGroupedOpts({
+    staticOptsRef: staticOptsRef
+  });
+  // 表格元数据/操作
+  var tableMeta = useTableMeta(tableValue, {
+    fieldMap: props.fieldMap,
+    onValuesChange: props.onValuesChange,
+    innerRef: innerRef
+  });
+  // 行选择功能
+  var _useRowSelectionState = useRowSelectionState(),
+    rowSelectionState = _useRowSelectionState.rowSelectionState;
+  var rowSelectionOpts = useRowSelectionOpts({
+    rowSelection: propsRef.current.rowSelection,
+    innerRef: innerRef
+  });
+  // 动态的 table 选项，会由内部组件主动调用
+  var _useSetState = useSetState({}),
+    dynamicOpts = _useSetState[0],
+    setDynamicOpts = _useSetState[1];
+  // 核心表格实例
+  var table = useReactTable(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({
+    _features: [OverridesFeature, CustomGetterFeature, CustomRowSelectionFeature, CustomAggregatedFeature, CustomGroupingFeature].concat(propsRef.current.features || []),
+    data: tableValue.getValue(),
+    columns: columns,
+    defaultColumn: Object.assign({
+      cell: DftCell,
+      header: HeaderCell,
+      footer: FooterCell,
+      aggregatedCell: (_d = (_c = props.customCell) === null || _c === void 0 ? void 0 : _c.aggregatedCell) !== null && _d !== void 0 ? _d : AggregatedCell
+    }, propsRef.current.defaultColumn),
+    getCoreRowModel: getCoreRowModel(),
+    getRowId: props.rowKey ? function (row) {
+      return row[props.rowKey];
+    } : undefined,
+    getSubRows: function getSubRows(row) {
+      return row[propsRef.current.subRowKey];
+    }
+  }, propsRef.current.debug), {
+    meta: tableMeta
+  }), rowSelectionOpts), paginationOpts), filterOpts), sorterOpts), rowExpandedOpts), rowGroupedOpts), {
+    initialState: Object.assign(Object.assign({}, initialState), {
+      pagination: Object.assign(Object.assign({}, paginationState.getValue()), paginationOpts.initialState ? paginationOpts.initialState.pagination : {})
+    })
+  }), dynamicOpts), props.customEngineOpts));
+  // 生成全局静态配置
+  var _s_ = tableValue; // 没啥用，就是太长了取个别名，防止换行
+  var globalStaticRef = useGlobalStatic({
+    table: table,
+    subscription: _s_,
+    propsRef: propsRef,
+    staticOptsRef: staticOptsRef
+  });
+  // 生成全局静态函数
+  var globalActionsRef = useGlobalStaticActions({
+    innerRef: innerRef
+  });
+  // 虚拟滚动需要知道可滚动的容器元素
+  var tableContainerRef = React.useRef(null);
+  // 行操作控制器
+  var enableRowEdit = globalStaticRef.current.enableRowEdit;
+  var rowActions = useMemo(function () {
+    return new TableRowController(tableValue, {
+      rowEdit: enableRowEdit,
+      propsRef: propsRef
+    });
+  }, [tableValue, enableRowEdit, propsRef]);
+  // 获取所有可编辑字段的值
+  var getFieldsValue = useGetFieldsValue({
+    innerRef: innerRef
+  });
+  // 获取分组后的所有可编辑字段的值和只读字段的值
+  var getGroupedValues = useGetGroupedValues({
+    innerRef: innerRef
+  });
+  // 组装内部上下文
+  var _useTableInnerCtx = useTableInnerCtx({
+      table: table,
+      setDynamicOpts: setDynamicOpts,
+      subscription: tableValue,
+      tableContainerRef: tableContainerRef,
+      rowActions: rowActions,
+      rerender: rerender,
+      rowSelectionState: rowSelectionState,
+      paginationState: paginationState,
+      filterState: filterState,
+      sorterState: sorterState,
+      propsRef: propsRef,
+      globalStaticRef: globalStaticRef,
+      globalActionsRef: globalActionsRef,
+      getFieldsValue: getFieldsValue,
+      getGroupedValues: getGroupedValues
+    }),
+    ctxValue = _useTableInnerCtx.ctxValue,
+    exposeCtxValue = _useTableInnerCtx.exposeCtxValue;
+  // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+  // @ts-ignore 仅允许此处赋值
+  innerRef.current = ctxValue;
+  React.useImperativeHandle(props.innerCtxRef, exposeCtxValue);
+  // 表头和表尾的 fixed 配置
+  var stickyOpts = propsRef.current.sticky;
+  var TableCtx = EditableSchemaTableCtx;
+  return /*#__PURE__*/React.createElement(TableCtx.Provider, {
+    value: ctxValue
+  }, /*#__PURE__*/React.createElement(EditableControlProvider, {
+    readonly: props.readonly || enableRowEdit
+  }, /*#__PURE__*/React.createElement("div", {
+    key: props.enableForceRerender ? forceRerenderFlag : undefined,
+    className: clsPrefix,
+    "data-is-empty": globalStaticRef.current.isEmpty,
+    "data-is-bordered": !!props.bordered,
+    "data-has-nest-header": globalStaticRef.current.hasNestHeader,
+    "data-has-sticky-footer": globalStaticRef.current.hasStickyFooter,
+    "data-has-selection": !!props.rowSelection,
+    "data-has-operation": !!props.rowOperation,
+    "data-has-left-fixed": globalStaticRef.current.hasLeftFixed,
+    "data-has-right-fixed": globalStaticRef.current.hasRightFixed,
+    "data-has-pagination": globalStaticRef.current.enablePagination
+  }, /*#__PURE__*/React.createElement("div", {
+    className: cls('container'),
+    ref: tableContainerRef
+  }, /*#__PURE__*/React.createElement(TableContainer, {
+    virtualize: propsRef.current.virtualize
+  }, /*#__PURE__*/React.createElement(TableContainer.Header, {
+    sticky: stickyOpts === null || stickyOpts === void 0 ? void 0 : stickyOpts.header,
+    stickyOffset: stickyOpts === null || stickyOpts === void 0 ? void 0 : stickyOpts.headerTop
+  }, /*#__PURE__*/React.createElement(Header, null)), /*#__PURE__*/React.createElement(TableContainer.Body, null, /*#__PURE__*/React.createElement(Body, {
+    getRowStyle: props.getRowStyle
+  })), globalStaticRef.current.showFooter ? ( /*#__PURE__*/React.createElement(TableContainer.Footer, {
+    sticky: stickyOpts === null || stickyOpts === void 0 ? void 0 : stickyOpts.footer,
+    stickyOffset: stickyOpts === null || stickyOpts === void 0 ? void 0 : stickyOpts.footerBottom
+  }, /*#__PURE__*/React.createElement(Footer, null))) : null)), /*#__PURE__*/React.createElement(BottomRender, Object.assign({
+    key: "bottom-container"
+  }, propsRef.current.bottom))), globalStaticRef.current.enableAsyncData ? /*#__PURE__*/React.createElement(AsyncDataGetter, null) : null));
+}
+export { EditableSchemaTable };

package/lib/esm/utils/cls.js

@@ -0,0 +1,13 @@
+/** @LICENSE
+ * @hi-ui/schema-editable-table
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-editable-table#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { createPrefixClassnames } from '@hi-ui/schema-utils';
+var clsPrefix = 'editable-schema-table';
+var cls = createPrefixClassnames(clsPrefix);
+export { cls, clsPrefix };

package/lib/esm/utils/fixed.js

@@ -0,0 +1,48 @@
+/** @LICENSE
+ * @hi-ui/schema-editable-table
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-editable-table#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { ROW_SELECTION_COL_WIDTH } from '../const.js';
+function getFixedStyles(column, opts) {
+  var isPinned = column.getIsPinned();
+  if (!isPinned) return {};
+  var style = {};
+  if (isPinned === 'left') {
+    var className = ['fixed-left'];
+    // 如果开启行选择，则需要增加偏移量，+1是边框的偏移
+    var enableRowSelection = opts.globalStaticRef.current.enableRowSelection;
+    var offset = enableRowSelection ? ROW_SELECTION_COL_WIDTH : 0;
+    style.left = column.getStart('left') + offset;
+    // 增加阴影
+    var isLastLeft = column.getIsLastColumn('left');
+    if (isLastLeft) className.push('last-fixed-left');
+    return {
+      className: className,
+      style: style
+    };
+  }
+  if (isPinned === 'right') {
+    var _className = ['fixed-right'];
+    style.right = column.getAfter('right');
+    // 如果开启行操作，则需要增加偏移量
+    var _opts$globalStaticRef = opts.globalStaticRef.current,
+      enableRowOperation = _opts$globalStaticRef.enableRowOperation,
+      operationColWidth = _opts$globalStaticRef.operationColWidth;
+    var _offset = enableRowOperation ? operationColWidth : 0;
+    style.right = column.getAfter('right') + _offset;
+    // 增加阴影
+    var isFirstRight = column.getIsFirstColumn('right');
+    if (isFirstRight) _className.push('first-fixed-right');
+    return {
+      className: _className,
+      style: style
+    };
+  }
+  return {};
+}
+export { getFixedStyles };

package/lib/esm/utils/grouping.js

@@ -0,0 +1,36 @@
+/** @LICENSE
+ * @hi-ui/schema-editable-table
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-editable-table#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { isNil } from 'lodash-es';
+
+/**
+ * 检查值是否为空值（包括null、undefined、'null'、'undefined'和空字符串）
+ */
+function isEmptyValue(value) {
+  if (isNil(value)) return true;
+  if (value === 'null' || value === 'undefined' || value === '') return true;
+  return false;
+}
+// 参考了内置的 flattenBy 方法
+// https://github.com/TanStack/table/blob/66fbe3a74b129e700e4667d1d5e1b29dd0a7b723/packages/table-core/src/utils.ts#L115-L134
+function getGroupedLeafRows(rows) {
+  var flat = [];
+  var recurse = function recurse(subRows) {
+    subRows.forEach(function (row) {
+      if (!row.getIsGrouped()) flat.push(row);
+      var children = row.subRows;
+      if (children === null || children === void 0 ? void 0 : children.length) {
+        recurse(children);
+      }
+    });
+  };
+  recurse(rows);
+  return flat;
+}
+export { getGroupedLeafRows, isEmptyValue };

package/lib/esm/utils/state-merge.js

@@ -0,0 +1,37 @@
+/** @LICENSE
+ * @hi-ui/schema-editable-table
+ * https://github.com/XiaoMi/hiui/tree/master/packages/schema/schema-editable-table#readme
+ *
+ * Copyright (c) HiUI <mi-hiui@xiaomi.com>.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * 确保状态字段完整性，为被清空的字段添加默认值
+ * @param state 变化前的状态
+ * @param newState 变化后的状态
+ * @param stateKey 要设置默认值的字段名
+ * @param defaultValue 字段被清空时的默认值
+ * @returns 处理后的状态
+ */
+function ensureStateFields(state, newState, stateKey, defaultValue) {
+  // 如果没有前一个状态，直接返回新状态
+  if (!state || state.length === 0) return newState;
+  // 创建新状态的 id 集合
+  var newStateIds = new Set(newState.map(function (item) {
+    return item.id;
+  }));
+  // 找出被删除的字段，为它们添加默认值
+  var missingItems = state.filter(function (item) {
+    return !newStateIds.has(item.id);
+  }).map(function (item) {
+    var _ref;
+    return _ref = {
+      id: item.id
+    }, _ref[stateKey] = defaultValue, _ref;
+  });
+  // 合并新状态和缺失字段的默认值
+  return [].concat(newState, missingItems);
+}
+export { ensureStateFields };

package/lib/types/body/index.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { Row } from '@tanstack/react-table';
+type GetRowStyleCtxType<TData> = {
+    row: Row<TData>;
+};
+export type EditTableBodyProps<TData> = {
+    className?: string;
+    getRowStyle?: (row: TData, ctx: GetRowStyleCtxType<TData>) => React.CSSProperties;
+};
+export type OnBodyRowMountedFn<TData> = (ctx: {
+    row: Row<TData>;
+}) => void;
+declare const _default: <TData>(props: EditTableBodyProps<TData>) => React.ReactElement;
+export default _default;

package/lib/types/body/wrapper.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { Cell, Row } from '@tanstack/react-table';
+type BodyCellWrapperProps = {
+    cell: Cell<AnyType, unknown>;
+    fixed?: boolean;
+};
+type BodyCellWrapperDynamicAttrsCtxType = {
+    cell: Cell<AnyType, unknown>;
+    row: Row<AnyType>;
+    rowData: AnyObject;
+    renderCase: BodyCellRenderCaseType;
+};
+type BodyCellWrapperDynamicAttrsType = React.TdHTMLAttributes<HTMLTableCellElement>;
+export type GetBodyCellWrapperDynamicAttrsFnType = (ctx: BodyCellWrapperDynamicAttrsCtxType) => BodyCellWrapperDynamicAttrsType;
+export declare function BodyCellWrapper(props: BodyCellWrapperProps): JSX.Element;
+export type BodyCellRenderCaseType = ReturnType<typeof useRenderCase>;
+declare function useRenderCase(): "grouping" | "expanding" | "basic";
+export {};

package/lib/types/cell/aggregated.d.ts

@@ -0,0 +1,35 @@
+import React from 'react';
+import type { CellContext } from '@tanstack/react-table';
+export type AggregatedCellProps<TData extends AnyObject> = CellContext<TData, unknown>;
+export type AggregatedCellRenderCtxType<TData extends AnyObject> = AggregatedCellProps<TData> & {
+    /**
+     * 聚合值
+     * - 指聚合列的当前行值
+     */
+    groupingValue: unknown;
+    /** 聚合列的ID */
+    groupingColumnId: string;
+    /**
+     * 聚合列经聚合函数计算后聚合值
+     * - 例如聚合函数为 count，则聚合值为聚合列的行数
+     */
+    groupingColumnAggregatedValue: unknown;
+    /**
+     * 经处理后的聚合值
+     * - 会在为空值时自动展示为【空值】
+     */
+    displayValue: unknown;
+    /**
+     * 标签颜色
+     * - 内部随机生成的标签颜色样式配置
+     * - 会在单次挂载中保持稳定
+     */
+    color: {
+        back: string;
+        fore: string;
+    };
+    /** 默认的内部结构元素 */
+    dftEl: React.ReactElement;
+};
+declare const _default: <TData extends AnyObject>(props: AggregatedCellProps<TData>) => React.ReactElement;
+export default _default;

package/lib/types/cell/custom.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import type { AggregatedCellProps, AggregatedCellRenderCtxType } from './aggregated';
+export type CustomCellType<TData extends AnyObject> = {
+    /**
+     * 聚合单元格【组件】
+     * - 获得全量的渲染能力，内部全部的聚合单元格均会使用此组件
+     * - 但使用难度较大，需自行实现内部的渲染判断逻辑
+     * - 若仅需自定义已知聚合单元格的渲染逻辑，请使用 renderAggregatedCell
+     */
+    aggregatedCell?: (props: AggregatedCellProps<TData>) => React.ReactElement | null;
+    /**
+     * 聚合单元格【渲染函数】
+     * - 用于自定义已知聚合单元格的渲染逻辑
+     * - 已知是指开启聚合后，页面已经展示的【有效聚合单元格】
+     * - 无需再判断单元格是否已经是聚合单元格，可以仅关心所需的渲染逻辑
+     * - 若需获取全量的渲染能力，请使用 aggregatedCell
+     */
+    renderAggregatedCell?: (ctx: AggregatedCellRenderCtxType<TData>) => React.ReactElement | null;
+};

package/lib/types/cell/dependency.d.ts

@@ -0,0 +1,47 @@
+import type { FieldConfigType } from '@hi-ui/schema-core';
+import type { Subscription } from '@hi-ui/use-subscription';
+import type { EditableCaseProps } from '@hi-ui/schema-fields';
+type ExecCellDepsCtxType<TData extends AnyObject = AnyObject> = {
+    /**
+     * 可编辑场景的组件属性
+     * - 所有的操作都围绕着它展开
+     */
+    fieldProps: EditableCaseProps;
+    /** 当前行数据 */
+    rowData: TData;
+    /** 当前行索引 */
+    rowIndex: number;
+    /** 当前字段的数据键 */
+    dataKey: string;
+    /** 变更的依赖值映射（按行索引） */
+    changedDepValues: Record<number, Partial<TData>>;
+    /** 变更的字段名列表 */
+    changedFieldNames: string[] | undefined;
+    /** 表格订阅对象 */
+    tableValue: Subscription<AnyObject[]>;
+};
+export declare function execCellDepsProcess<TData extends AnyObject>(ctx: ExecCellDepsCtxType<TData>): void;
+/**
+ * Props依赖处理的上下文类型
+ */
+export interface PropsDependencyContext<TData extends AnyObject = AnyObject> {
+    /** 字段配置 */
+    field: FieldConfigType<TData>;
+    /** 依赖值 */
+    depValues: Partial<TData>;
+    /** 所有值 */
+    allValues: TData;
+    /** 变更的依赖键列表 */
+    changedDepKeys: string[];
+    /** 表单引用 */
+    formRef: AnyType;
+}
+/**
+ * 处理表格单元格中的值依赖逻辑
+ */
+export declare function execCellValueDepFn<TData extends AnyObject>(ctx: ExecCellDepsCtxType<TData>): void;
+/**
+ * 处理表格单元格中的 Props 依赖逻辑
+ */
+export declare function execCellPropsDepFn<TData extends AnyObject>(ctx: ExecCellDepsCtxType<TData>): void;
+export {};

package/lib/types/cell/editing.d.ts

@@ -0,0 +1,8 @@
+import type { CellContext } from '@tanstack/react-table';
+export declare function useEditingCellFormBinding<TData extends AnyObject>(props: CellContext<TData, unknown>): {
+    value: unknown;
+    onChange: (eventOrValue: unknown) => void;
+    onBlur: () => void;
+    invalid: undefined;
+};
+export declare function normalizeValueFromChange(eventOrValue: unknown): any;

package/lib/types/cell/footer.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { HeaderContext } from '@tanstack/react-table';
+export type FooterCellProps<TData extends AnyObject = AnyObject> = Pick<HeaderContext<TData, unknown>, 'column' | 'table'>;
+declare const _default: <TData extends AnyObject>(props: FooterCellProps<TData>) => React.ReactElement;
+export default _default;

package/lib/types/cell/header.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { HeaderContext } from '@tanstack/react-table';
+type HeaderCellProps<TData extends AnyObject> = Pick<HeaderContext<TData, unknown>, 'column' | 'table'>;
+declare const _default: <TData extends AnyObject>(props: HeaderCellProps<TData>) => React.ReactElement;
+export default _default;

package/lib/types/cell/index.d.ts

@@ -0,0 +1,6 @@
+import type { CellContext } from '@tanstack/react-table';
+export default function DftCell<TData extends AnyObject>(props: CellContext<TData, unknown>): JSX.Element;
+export { default as HeaderCell } from './header';
+export { default as FooterCell } from './footer';
+export { default as AggregatedCell } from './aggregated';
+export { type CustomCellType } from './custom';

package/lib/types/const.d.ts

@@ -0,0 +1,11 @@
+export declare const ROW_HEIGHT = 40;
+export declare const ROW_SELECTION_COL_ID = "_row_selection_";
+export declare const ROW_SELECTION_COL_WIDTH = 50;
+export declare const ROW_INDEX_COL_ID = "_row_index_";
+export declare const ROW_OPERATION_COL_ID = "_row_operation_";
+export declare const ROW_OPERATION_COL_WIDTH = 160;
+export declare function isSystemCol(id: string): id is "_row_index_";
+export { dftPageSize as DFT_PAGINATION_PAGE_SIZE } from './features/pagination/use-opts';
+export { dftSelectionType as DFT_ROW_SELECTION_TYPE } from './features/row-selection/const';
+export declare const EMPTY_VALUE = "__EMPTY_VALUE__";
+export declare const SELECTED_OPTION_RAW = "_selected_raw_option_";

package/lib/types/container/base.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare function NonVirtualContainer(props: React.PropsWithChildren<unknown>): JSX.Element;

package/lib/types/container/bottom.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+import { type ActionsProps } from '@hi-ui/schema-action-trigger';
+import type { EditTableCtxType } from '../index';
+type BottomRenderActionsType = ActionsProps<AnyObject[], BottomRenderCtxType>['actions'];
+export type BottomRenderConfigType = {
+    left?: AnyGetter<CustomLeftActionRenderType>;
+    right?: AnyGetter<CustomLeftActionRenderType>;
+};
+type BuiltinActionsType = AnyObject & {
+    pagination: React.ReactElement | null;
+    rowSelectionIndicator: React.ReactElement | null;
+};
+type CustomLeftActionRenderType = (ctx: BottomRenderCtxType & {
+    builtin: BuiltinActionsType;
+}) => BottomRenderActionsType;
+export type BottomRenderCtxType = {
+    tableCtx: EditTableCtxType;
+};
+export declare function BottomRender(props: BottomRenderConfigType): JSX.Element;
+export {};

package/lib/types/container/col-group.d.ts

@@ -0,0 +1,11 @@
+import type { VirtualItem } from '@tanstack/react-virtual';
+export declare function TableColGroup(): JSX.Element;
+type VirtualColGroupProps = {
+    virtualColumns: VirtualItem[];
+    virtualColPadding: {
+        start: number;
+        end: number;
+    };
+};
+export declare function VirtualColGroup({ virtualColumns, virtualColPadding }: VirtualColGroupProps): JSX.Element;
+export {};

package/lib/types/container/column-virtual.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import type { VirtualizerOptions } from './type';
+type ColumnVirtualContainerProps = React.PropsWithChildren<{
+    options?: VirtualizerOptions;
+}>;
+export declare function ColumnVirtualContainer(props: ColumnVirtualContainerProps): JSX.Element;
+export {};

package/lib/types/container/ctx.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { VirtualItem } from '@tanstack/react-virtual';
+export type TableContainerContextValue = {
+    headerRef: React.RefObject<HTMLDivElement>;
+    bodyRef: React.RefObject<HTMLDivElement>;
+    footerRef: React.RefObject<HTMLDivElement>;
+    colGroup: React.ReactElement;
+    /** 仅在开启虚拟化时存在，存储虚拟化相关数据 */
+    virtualize?: {
+        rows?: VirtualItem[];
+        columns?: VirtualItem[];
+        rowPadding?: {
+            top: number;
+            bottom: number;
+        };
+        colPadding?: {
+            left: number;
+            right: number;
+        };
+    };
+};
+export declare const TableContainerContext: React.Context<TableContainerContextValue | null>;
+export declare function useTableContainer(): TableContainerContextValue;

package/lib/types/container/full-virtual.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { VirtualizerOptions } from './type';
+type FullVirtualContainerProps = React.PropsWithChildren<{
+    rowOptions?: VirtualizerOptions;
+    columnOptions?: VirtualizerOptions;
+}>;
+export declare function FullVirtualContainer(props: FullVirtualContainerProps): JSX.Element;
+export {};