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

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

@@ -0,0 +1,13 @@
+import { type VirtualItem } from '@tanstack/react-virtual';
+import type { VirtualizerOptions } from './type';
+type VirtualizerResult = {
+    virtualItems: VirtualItem[];
+    padding: {
+        start: number;
+        end: number;
+    };
+};
+export declare function useRowVirtualizer(options?: VirtualizerOptions): VirtualizerResult;
+export declare function useColumnVirtualizer(options?: VirtualizerOptions): VirtualizerResult;
+export declare function useTableScroll(): void;
+export {};

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

@@ -0,0 +1,17 @@
+import React from 'react';
+import { TableHeader, TableBody, TableFooter } from './wrapper';
+import type { VirtualizeOpts } from './type';
+export * from './type';
+type TableContainerProps = React.PropsWithChildren<{
+    virtualize?: VirtualizeOpts;
+}>;
+export declare function TableContainer(props: TableContainerProps): JSX.Element;
+export declare namespace TableContainer {
+    var Header: typeof TableHeader;
+    var Body: typeof TableBody;
+    var Footer: typeof TableFooter;
+}
+export { useTableContainer } from './ctx';
+export type { TableStickyOpts } from './type';
+export type { TableHeaderProps, TableFooterProps } from './wrapper';
+export { BottomRender, type BottomRenderConfigType } from './bottom';

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

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

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

@@ -0,0 +1,17 @@
+import type { VirtualizerOptions as OriginalOptions } from '@tanstack/react-virtual';
+import type { BoolConfig } from '@hi-ui/schema-utils';
+export type VirtualizerOptions = Partial<Omit<OriginalOptions<HTMLDivElement, HTMLDivElement>, 'count' | 'getScrollElement'>>;
+export type VirtualizeOpts = {
+    row?: VirtualizerOptions;
+    column?: VirtualizerOptions;
+};
+export type VirtualizeConfig = {
+    row?: BoolConfig<VirtualizerOptions>;
+    column?: BoolConfig<VirtualizerOptions>;
+};
+export type TableStickyOpts = {
+    header?: boolean;
+    footer?: boolean;
+    headerTop?: number;
+    footerBottom?: number;
+};

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

@@ -0,0 +1,12 @@
+import React from 'react';
+export type TableHeaderProps = React.PropsWithChildren<{
+    sticky?: boolean;
+    stickyOffset?: number;
+}>;
+export type TableFooterProps = React.PropsWithChildren<{
+    sticky?: boolean;
+    stickyOffset?: number;
+}>;
+export declare function TableHeader({ children, sticky, stickyOffset }: TableHeaderProps): JSX.Element;
+export declare function TableBody(props: React.PropsWithChildren<unknown>): JSX.Element;
+export declare function TableFooter({ children, sticky, stickyOffset }: TableFooterProps): JSX.Element;

package/lib/types/ctx.d.ts

@@ -0,0 +1,41 @@
+import React from 'react';
+import type { Table, TableOptions, RowSelectionState, PaginationState, ColumnFiltersState, SortingState } from '@tanstack/react-table';
+import type { SetState } from 'ahooks/es/useSetState';
+import type { SubscriptionType } from '@hi-ui/use-subscription';
+import type { ReadonlyRefObject } from '@hi-ui/schema-hooks';
+import type { TableRowController } from './features/row-controller';
+import type { TableCtxRefType } from './table';
+import type { NormalizedProps } from './hooks/use-props';
+import type { GlobalStaticConfigType } from './hooks/use-global-static';
+import type { GlobalStaticActionsType } from './hooks/use-global-actions';
+export type EditableSchemaTableCtxType<TData extends AnyObject = AnyObject> = {
+    table: Table<TData>;
+    setDynamicOpts: SetState<Partial<TableOptions<TData>>>;
+    subscription: SubscriptionType<TData[]>;
+    /** 虚拟滚动依赖的可滚动的容器元素 */
+    tableContainerRef: React.RefObject<HTMLDivElement>;
+    /** 行操作控制器 */
+    rowActions: TableRowController<TData>;
+    /** 行选择状态 */
+    rowSelectionState: SubscriptionType<RowSelectionState>;
+    /** 分页状态 */
+    paginationState: SubscriptionType<PaginationState>;
+    /** 筛选状态 */
+    filterState: SubscriptionType<ColumnFiltersState>;
+    /** 排序状态 */
+    sorterState: SubscriptionType<SortingState>;
+    /** 组件 props 的最新值 */
+    propsRef: ReadonlyRefObject<NormalizedProps<TData>>;
+    /** 全局静态配置 */
+    globalStaticRef: ReadonlyRefObject<GlobalStaticConfigType>;
+    /** 全局静态函数 */
+    globalActionsRef: ReadonlyRefObject<GlobalStaticActionsType<TData>>;
+    /** 获取内部暴露给外部的值 */
+    exposeCtxValueRef: ReadonlyRefObject<() => TableCtxRefType<TData>>;
+};
+export declare const EditableSchemaTableCtx: React.Context<EditableSchemaTableCtxType<AnyObject>>;
+export declare function useEditableSchemaTableCtx<TData extends AnyObject = AnyObject>(): EditableSchemaTableCtxType<TData>;
+type EditableSchemaTableInnerRefType<TData extends AnyObject> = ReadonlyRefObject<EditableSchemaTableCtxType<TData>>;
+type EditableSchemaTablePropsRefType<TData extends AnyObject> = EditableSchemaTableCtxType<TData>['propsRef'];
+type EditableSchemaTableGlobalStaticConfigType<TData extends AnyObject> = EditableSchemaTableCtxType<TData>['globalStaticRef'];
+export { EditableSchemaTableCtx as EditTableCtx, useEditableSchemaTableCtx as useEditTableCtx, type EditableSchemaTableCtxType as EditTableCtxType, type EditableSchemaTableInnerRefType as InnerRefType, type EditableSchemaTablePropsRefType as PropsRefType, type EditableSchemaTableGlobalStaticConfigType as GlobalStaticRefType, };

package/lib/types/features/_overrides/aggregated.d.ts

@@ -0,0 +1,2 @@
+import type { TableFeature } from '@tanstack/react-table';
+export declare const CustomAggregatedFeature: TableFeature<AnyType>;

package/lib/types/features/_overrides/getter.d.ts

@@ -0,0 +1,2 @@
+import type { TableFeature } from '@tanstack/react-table';
+export declare const CustomGetterFeature: TableFeature<AnyType>;

package/lib/types/features/_overrides/grouping.d.ts

@@ -0,0 +1,7 @@
+import type { TableFeature } from '@tanstack/react-table';
+/**
+ * 自定义分组特性
+ * 主要用于处理分组值为null或undefined的情况，将不同类型的空值统一为一个特殊标记
+ * 这样所有的空值都会被归为同一组，而不是分散在不同的组中
+ */
+export declare const CustomGroupingFeature: TableFeature<unknown>;

package/lib/types/features/_overrides/index.d.ts

@@ -0,0 +1,5 @@
+export * from './aggregated';
+export * from './getter';
+export * from './overrides';
+export * from './row-selection';
+export * from './grouping';

package/lib/types/features/_overrides/overrides.d.ts

@@ -0,0 +1,2 @@
+import type { TableFeature } from '@tanstack/react-table';
+export declare const OverridesFeature: TableFeature<AnyType>;

package/lib/types/features/_overrides/row-selection.d.ts

@@ -0,0 +1,2 @@
+import type { TableFeature } from '@tanstack/react-table';
+export declare const CustomRowSelectionFeature: TableFeature<AnyObject>;

package/lib/types/features/async-data/getter.d.ts

@@ -0,0 +1,9 @@
+import { type InnerRefType } from '../../ctx';
+import type { GetDataSourceResType } from './normal';
+export declare function AsyncDataGetter(): null;
+type UseAsyncDataCtxType<TData extends AnyObject> = {
+    innerRef: InnerRefType<TData>;
+};
+export declare function useAsyncData<TData extends AnyObject>(ctx: UseAsyncDataCtxType<TData>): void;
+export declare function validateResData<TData extends AnyObject>(data: unknown): data is GetDataSourceResType<TData>;
+export {};

package/lib/types/features/async-data/group.d.ts

@@ -0,0 +1 @@
+export declare const _ASYNC_DATA_FILTER_GROUP_IGNORE_ME_ = "_ASYNC_DATA_FILTER_GROUP_IGNORE_ME_";

package/lib/types/features/async-data/index.d.ts

@@ -0,0 +1,6 @@
+export { useGetDataSource } from './normal';
+export type { GetDataSourceType, GetDataSourceBasicParamsType, GetDataSourceParamsType, GetDataSourceResType, InnerGetDataSourceType, InnerUpdateDataSourceType, } from './normal';
+export { useResetDataSource, type InnerResetDataSourceType } from './use-reset-data';
+export type { AsyncDataOptsType } from './type';
+export { useDataFetcher, defineDataFetcher } from './use-data-fetcher';
+export { _ASYNC_DATA_FILTER_GROUP_IGNORE_ME_ } from './group';

package/lib/types/features/async-data/normal.d.ts

@@ -0,0 +1,48 @@
+import type { ColumnFiltersState, SortingState } from '@tanstack/react-table';
+import { type PipeGetter } from '@hi-ui/schema-utils';
+import type { InnerRefType } from '../../ctx';
+import type { GetPageDataCtxType } from '../pagination/component';
+export type GetDataSourceCtxType<TData extends AnyObject> = {
+    innerRef: InnerRefType<TData>;
+};
+export type GetDataSourceBasicParamsType = {
+    /**
+     * 分页信息
+     * @desc 启用分页时，分页信息必然存在
+     */
+    pagination?: GetPageDataCtxType;
+    /**
+     * 表头筛选信息
+     * @desc 启用远程筛选时，表头筛选信息必然存在
+     */
+    filters?: ColumnFiltersState;
+    /**
+     * 表头排序信息
+     * @desc 启用远程排序时，表头排序信息必然存在
+     */
+    sorters?: SortingState;
+};
+export type GetDataSourceParamsType = AnyObject & GetDataSourceBasicParamsType & {
+    /**
+     * 原始参数
+     * - 默认为空，可由上层组件自行决定参数类型
+     */
+    raw?: GetDataSourceBasicParamsType;
+};
+/**
+ * 异步数据源的返回类型
+ * @desc 请注意，启用分页时，返回类型中必须包含 total/pageSize/current 字段
+ */
+export type GetDataSourceResType<TData extends AnyObject = AnyObject> = {
+    list: TData[];
+    total?: number;
+    pageSize?: number;
+    current?: number;
+};
+export type GetDataSourceType<TData extends AnyObject> = (params: GetDataSourceParamsType) => Promise<GetDataSourceResType<TData>>;
+export type InnerGetDataSourceType<TData extends AnyObject> = (customParams?: PipeGetter<GetDataSourceParamsType>) => Promise<GetDataSourceResType<TData>>;
+export type InnerUpdateDataSourceType = (customParams?: PipeGetter<GetDataSourceParamsType>) => Promise<void>;
+export declare function useGetDataSource<TData extends AnyObject>(ctx: GetDataSourceCtxType<TData>): {
+    getDataSource: InnerGetDataSourceType<TData>;
+    updateDataSource: InnerUpdateDataSourceType;
+};

package/lib/types/features/async-data/type.d.ts

@@ -0,0 +1,22 @@
+import type { BeCheckedPromiseType } from '@hi-ui/schema-utils';
+import type { GetDataSourceParamsType, GetDataSourceType } from './normal';
+export type AsyncDataOptsType<TData extends AnyObject = AnyObject> = {
+    /**
+     * 请求数据的方法
+     */
+    request: GetDataSourceType<TData>;
+    /**
+     * 请求前的钩子
+     * @desc 返回值为 falsy 时，不执行 request 函数
+     */
+    beforeRequest?: (params: GetDataSourceParamsType) => BeCheckedPromiseType<GetDataSourceParamsType>;
+    /**
+     * 是否阻止默认的初始请求
+     */
+    blockInitialRequest?: boolean;
+    /**
+     * 是否启用数据完整性验证
+     * @desc 建议至少在开发环境下启用
+     */
+    enableDataValidate?: boolean;
+};

package/lib/types/features/async-data/use-data-fetcher.d.ts

@@ -0,0 +1,22 @@
+import { Options as AhooksRequestOptions } from 'ahooks/es/useRequest/src/types';
+import type { GetDataSourceType, GetDataSourceParamsType, GetDataSourceResType } from './normal';
+/**
+ * 定义的可编辑表的异步数据请求方法
+ * @desc 默认需要手动调用 fetchData 方法
+ * @desc 本质是 ahooks 的 useRequest 方法
+ */
+export declare function useDataFetcher<TData extends AnyObject = AnyObject>(getter: GetDataSourceType<TData>, extraOpts?: AhooksRequestOptions<GetDataSourceResType<TData>, [GetDataSourceParamsType]>): {
+    runAsync: (params_0: GetDataSourceParamsType) => Promise<GetDataSourceResType<TData>>;
+    fetchData: (params_0: GetDataSourceParamsType) => Promise<GetDataSourceResType<TData>>;
+    loading: boolean;
+    data?: GetDataSourceResType<TData> | undefined;
+    error?: Error;
+    params: [] | [GetDataSourceParamsType];
+    cancel: import("ahooks/lib/useRequest/src/Fetch").default<TData_1, TParams>["cancel"];
+    refresh: import("ahooks/lib/useRequest/src/Fetch").default<TData_1, TParams>["refresh"];
+    refreshAsync: () => Promise<GetDataSourceResType<TData>>;
+    run: (params_0: GetDataSourceParamsType) => void;
+    mutate: (data?: GetDataSourceResType<TData> | ((oldData?: GetDataSourceResType<TData> | undefined) => GetDataSourceResType<TData> | undefined) | undefined) => void;
+};
+/** 定义表格异步数据请求方法 */
+export declare function defineDataFetcher<TData extends AnyObject = AnyObject>(getter: GetDataSourceType<TData>): GetDataSourceType<TData>;

package/lib/types/features/async-data/use-reset-data.d.ts

@@ -0,0 +1,14 @@
+import type { InnerRefType } from '../../ctx';
+export type ResetDataSourceCtxType<TData extends AnyObject> = {
+    innerRef: InnerRefType<TData>;
+};
+export type InnerResetDataSourceType = (opts?: ResetDataSourceOpts) => Promise<void>;
+export type ResetDataSourceOpts = {
+    /**
+     * 重置状态时，是否强制触发请求，并更新表格数据
+     * @desc 默认情况下，只有状态发生变化时才会触发请求
+     * @desc 启用后，无论状态是否发生变化，都会触发请求
+     */
+    forceRequest?: boolean;
+};
+export declare function useResetDataSource<TData extends AnyObject>(ctx: ResetDataSourceCtxType<TData>): InnerResetDataSourceType;

package/lib/types/features/column-grouping/get-grouping-config.d.ts

@@ -0,0 +1,2 @@
+import type { FieldConfigType, FieldGroupingConfigType } from '@hi-ui/schema-core';
+export declare function getGroupingConfig(field: FieldConfigType): FieldGroupingConfigType | undefined;

package/lib/types/features/column-grouping/index.d.ts

@@ -0,0 +1,3 @@
+export { useRowGroupedOpts } from './use-opts';
+export { getGroupingConfig } from './get-grouping-config';
+export type { GroupingOpts } from './use-opts';

package/lib/types/features/column-grouping/use-opts.d.ts

@@ -0,0 +1,12 @@
+import type { GroupingOptions } from '@tanstack/react-table';
+import { StaticOptsRefType } from '../../hooks/use-global-static';
+export type GroupingOpts = {};
+type UseGroupedOptsCtxType = {
+    staticOptsRef: StaticOptsRefType;
+};
+export declare function useRowGroupedOpts(ctx: UseGroupedOptsCtxType): GroupingOptions;
+/**
+ * 获取列分组配置选项
+ */
+export declare function getRowGroupedOptions(ctx: UseGroupedOptsCtxType): GroupingOptions;
+export {};

package/lib/types/features/column-state.d.ts

@@ -0,0 +1,15 @@
+import type { VisibilityState, ColumnPinningState, ColumnOrderState } from '@tanstack/table-core';
+import type { FieldConfigType } from '@hi-ui/schema-core';
+import type { EditableSchemaTableProps } from '../table';
+export type ColumnState = {
+    columnVisibility: VisibilityState;
+    columnPinning: ColumnPinningState;
+    columnOrder: ColumnOrderState;
+};
+/**
+ * 根据字段配置生成表格列的初始状态
+ */
+export declare function getInitialColumnState(fields: FieldConfigType[]): ColumnState;
+type UseInitialStateCtxType<TData extends AnyObject> = Pick<EditableSchemaTableProps<TData>, 'fields'>;
+export declare function useInitialColumnState<TData extends AnyObject>(ctx: UseInitialStateCtxType<TData>): ColumnState;
+export {};

package/lib/types/features/filter/bridge.d.ts

@@ -0,0 +1,9 @@
+import type { HeaderContext } from '@tanstack/react-table';
+import type { FieldConfigType, FieldFilterConfigType } from '@hi-ui/schema-core';
+type TableFilterBridgeProps<TData extends AnyObject> = {
+    column: HeaderContext<TData, unknown>['column'];
+    field: FieldConfigType;
+    filter?: FieldFilterConfigType;
+};
+export declare function TableFilterBridge<TData extends AnyObject>(props: TableFilterBridgeProps<TData>): JSX.Element;
+export {};

package/lib/types/features/filter/filter-fns/date.d.ts

@@ -0,0 +1,6 @@
+import type { FilterFn } from '@tanstack/react-table';
+/**
+ * 自定义日期范围筛选函数
+ * 用于筛选日期范围内的数据
+ */
+export declare const inDateRange: FilterFn<AnyObject>;

package/lib/types/features/filter/filter-fns/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 导出所有自定义筛选函数
+ */
+export declare const filterFns: {
+    inDateRange: import("@tanstack/table-core").FilterFn<AnyObject>;
+};

package/lib/types/features/filter/get-filter-config.d.ts

@@ -0,0 +1,4 @@
+import type { BuiltInFilterFn as TanStackBuiltInFilterFn } from '@tanstack/react-table';
+import type { FieldConfigType, FieldFilterConfigType } from '@hi-ui/schema-core';
+export type BuiltInFilterFn = TanStackBuiltInFilterFn | 'inDateRange';
+export declare function getFilterConfig(field: FieldConfigType): FieldFilterConfigType | undefined;

package/lib/types/features/filter/index.d.ts

@@ -0,0 +1,8 @@
+import type { ColumnFiltersState } from '@tanstack/react-table';
+export { useFilterOpts, getFilterOptions } from './use-opts';
+export { getFilterConfig } from './get-filter-config';
+export { TableFilterBridge } from './bridge';
+export type { FilterOpts } from './use-opts';
+export declare function useFilterState(): {
+    filterState: import("@hi-ui/use-subscription").SubscriptionType<ColumnFiltersState>;
+};

package/lib/types/features/filter/use-opts.d.ts

@@ -0,0 +1,62 @@
+import type { ColumnFiltersState } from '@tanstack/react-table';
+import { type OnChangeFnCtxType } from '../../utils';
+import type { InnerRefType } from '../../ctx';
+import type { StaticOptsRefType } from '../../hooks/use-global-static';
+export type FilterOpts = {
+    remote?: boolean;
+    onChange?: (state: ColumnFiltersState, ctx: OnChangeFnCtxType<ColumnFiltersState>) => void;
+};
+type UseFilterOptsCtxType<TData extends AnyObject> = {
+    innerRef: InnerRefType<TData>;
+    staticOptsRef: StaticOptsRefType;
+};
+export declare function useFilterOpts<TData extends AnyObject>(ctx: UseFilterOptsCtxType<TData>): {
+    manualFiltering?: undefined;
+    getFacetedUniqueValues?: undefined;
+    onColumnFiltersChange?: undefined;
+    filterFns?: undefined;
+    getFilteredRowModel?: undefined;
+} | {
+    manualFiltering: boolean;
+    getFacetedUniqueValues: (table: import("@tanstack/react-table").Table<TData>, columnId: string) => () => Map<any, number>;
+    onColumnFiltersChange: import("@tanstack/react-table").OnChangeFn<ColumnFiltersState>;
+    filterFns: {
+        inDateRange: import("@tanstack/react-table").FilterFn<AnyObject>;
+    };
+    getFilteredRowModel?: undefined;
+} | {
+    manualFiltering: boolean;
+    getFilteredRowModel: (table: import("@tanstack/react-table").Table<TData>) => () => import("@tanstack/react-table").RowModel<TData>;
+    getFacetedUniqueValues: (table: import("@tanstack/react-table").Table<TData>, columnId: string) => () => Map<any, number>;
+    onColumnFiltersChange: import("@tanstack/react-table").OnChangeFn<ColumnFiltersState>;
+    filterFns: {
+        inDateRange: import("@tanstack/react-table").FilterFn<AnyObject>;
+    };
+};
+/**
+ * 获取表格筛选配置选项
+ */
+export declare function getFilterOptions<TData extends AnyObject>(ctx: UseFilterOptsCtxType<TData>): {
+    manualFiltering?: undefined;
+    getFacetedUniqueValues?: undefined;
+    onColumnFiltersChange?: undefined;
+    filterFns?: undefined;
+    getFilteredRowModel?: undefined;
+} | {
+    manualFiltering: boolean;
+    getFacetedUniqueValues: (table: import("@tanstack/react-table").Table<TData>, columnId: string) => () => Map<any, number>;
+    onColumnFiltersChange: import("@tanstack/react-table").OnChangeFn<ColumnFiltersState>;
+    filterFns: {
+        inDateRange: import("@tanstack/react-table").FilterFn<AnyObject>;
+    };
+    getFilteredRowModel?: undefined;
+} | {
+    manualFiltering: boolean;
+    getFilteredRowModel: (table: import("@tanstack/react-table").Table<TData>) => () => import("@tanstack/react-table").RowModel<TData>;
+    getFacetedUniqueValues: (table: import("@tanstack/react-table").Table<TData>, columnId: string) => () => Map<any, number>;
+    onColumnFiltersChange: import("@tanstack/react-table").OnChangeFn<ColumnFiltersState>;
+    filterFns: {
+        inDateRange: import("@tanstack/react-table").FilterFn<AnyObject>;
+    };
+};
+export {};

package/lib/types/features/header-actions/components/column-collapsing.d.ts

@@ -0,0 +1,4 @@
+import type { FieldCustomHeaderActionsCtxType } from '../type';
+type ColumnCollapsingActionProps = Pick<FieldCustomHeaderActionsCtxType, 'column' | 'field' | 'table'>;
+export declare function ColumnCollapsingAction(props: ColumnCollapsingActionProps): JSX.Element | null;
+export {};

package/lib/types/features/header-actions/get-actions.d.ts

@@ -0,0 +1,13 @@
+import type { HeaderContext } from '@tanstack/react-table';
+import type { FieldConfigType } from '@hi-ui/schema-core';
+import type { GlobalStaticRefType } from '../../ctx';
+type GetHeaderActionsCtxType<TData extends AnyObject> = Pick<HeaderContext<TData, unknown>, 'column' | 'table'> & {
+    field: FieldConfigType;
+    globalStaticRef: GlobalStaticRefType<TData>;
+};
+export declare function getHeaderActions<TData extends AnyObject>(props: GetHeaderActionsCtxType<TData>): {
+    filterAvailable: boolean;
+    sorterAvailable: boolean;
+    elements: any;
+} | null;
+export {};

package/lib/types/features/header-actions/index.d.ts

@@ -0,0 +1,3 @@
+export * from './type';
+export * from './get-actions';
+export * from './components/column-collapsing';

package/lib/types/features/header-actions/type.d.ts

@@ -0,0 +1,20 @@
+import type { Table, Column } from '@tanstack/react-table';
+import type { FieldConfigType } from '@hi-ui/schema-core';
+export type FieldCustomHeaderActionsCtxType = {
+    /** 字段配置 */
+    field: FieldConfigType;
+    builtin: {
+        sorter: React.ReactNode;
+        filter: React.ReactNode;
+    };
+    /** 表格实例 */
+    table: Table<AnyType>;
+    /** 表格实例 */
+    column: Column<AnyType, unknown>;
+};
+export type FieldCustomHeaderActionComponent = React.ComponentType<FieldCustomHeaderActionsCtxType>;
+export type FieldCustomHeaderActionsFn = (ctx: FieldCustomHeaderActionsCtxType) => React.ReactNode[];
+export type HeaderActionOptsType = {
+    /** 是否仅在 hover 时显示 */
+    onlyVisibleOnHover?: boolean;
+};

package/lib/types/features/pagination/component.d.ts

@@ -0,0 +1,15 @@
+import type { PaginationProps as HiUIPaginationProps } from '@hi-ui/pagination';
+export type GetPageDataCtxType = {
+    current: number;
+    pageSize: number;
+};
+export type PaginationProps = Omit<Partial<HiUIPaginationProps>, 'current' | 'total'> & {
+    /** 总条数 */
+    total?: HiUIPaginationProps['total'];
+    /**
+     * pageSize 变化时，自动重置页码至首页
+     * - 默认会回到 current > pageCount ? pageCount : current
+     */
+    autoResetCurrent?: boolean;
+};
+export declare function Pagination(props: PaginationProps): JSX.Element;

package/lib/types/features/pagination/index.d.ts

@@ -0,0 +1,4 @@
+export { Pagination } from './component';
+export type { PaginationProps } from './component';
+export { usePaginationState } from './use-state';
+export { usePaginationOpts, getPaginationOptions } from './use-opts';

package/lib/types/features/pagination/use-opts.d.ts

@@ -0,0 +1,14 @@
+import type { PaginationOptions, TableOptions } from '@tanstack/react-table';
+import type { InnerRefType } from '../../ctx';
+import type { StaticOptsRefType } from '../../hooks/use-global-static';
+type UsePaginationOptsCtxType<TData extends AnyObject = AnyObject> = {
+    innerRef: InnerRefType<TData>;
+    staticOptsRef: StaticOptsRefType;
+};
+export declare function usePaginationOpts<TData extends AnyObject>(ctx: UsePaginationOptsCtxType<TData>): PaginationOptions & Pick<TableOptions<TData>, "initialState">;
+export declare const dftPageSize = 10;
+/**
+ * 获取表格分页配置选项
+ */
+export declare function getPaginationOptions<TData extends AnyObject>(ctx: UsePaginationOptsCtxType<TData>): PaginationOptions & Pick<TableOptions<TData>, 'initialState'>;
+export {};

package/lib/types/features/pagination/use-state.d.ts

@@ -0,0 +1,11 @@
+import type { PaginationState } from '@tanstack/react-table';
+import { type SubscriptionType } from '@hi-ui/use-subscription';
+import type { PropsRefType } from '../../ctx';
+type UsePaginationStateCtx<TData extends AnyObject> = {
+    propsRef: PropsRefType<TData>;
+    subscription: SubscriptionType<TData[]>;
+};
+export declare function usePaginationState<TData extends AnyObject>(ctx: UsePaginationStateCtx<TData>): {
+    paginationState: SubscriptionType<PaginationState>;
+};
+export {};

package/lib/types/features/row-controller.d.ts

@@ -0,0 +1,101 @@
+import { type SubscriptionType } from '@hi-ui/use-subscription';
+import type { EditableSchemaTableCtxType } from '../ctx';
+type TableRowControllerExtraOpts = {
+    /** 是否开启行编辑 */
+    rowEdit?: boolean;
+    propsRef?: EditableSchemaTableCtxType<AnyType>['propsRef'];
+};
+export declare class TableRowController<TData extends AnyObject = AnyObject> {
+    /** 表格数据订阅 */
+    private subscription;
+    /** 当前正在编辑的行索引订阅 */
+    editingSubscription: SubscriptionType<Record<string, boolean>> | null;
+    /** 当前正在编辑的行索引 */
+    private editingIndex;
+    private propsRef;
+    private onValuesChange?;
+    private afterRowsOperation;
+    constructor(subscription: SubscriptionType<TData[]>, opts?: TableRowControllerExtraOpts);
+    private get isEditing();
+    /** 检查是否处于编辑状态 */
+    private checkEditing;
+    /**
+     * 在指定位置添加新行
+     * @param data 行数据
+     * @param index 插入位置索引，可选，默认添加到末尾。如果为负数则插入到开头，如果超出长度则插入到末尾
+     */
+    addRow(data: Partial<TData>, index?: number): void;
+    /**
+     * 删除指定行
+     * @param index 要删除的行索引
+     */
+    deleteRow(index: number): void;
+    /**
+     * 批量添加多行
+     * @param rows 要添加的行数据数组
+     * @param index 插入位置索引，可选，默认添加到末尾。如果为负数则插入到开头，如果超出长度则插入到末尾
+     */
+    addRows(rows: Partial<TData>[], index?: number): void;
+    /**
+     * 批量删除多行
+     * @param indexes 要删除的行索引数组，会自动按从大到小排序处理
+     */
+    deleteRows(indexes: number[]): void;
+    /**
+     * 复制指定行
+     * @param sourceIndex 要复制的行索引
+     * @param options 复制选项
+     * @param options.targetIndex 目标位置索引，可选，默认复制到原位置的下一行
+     * @param options.rowKey 行数据中用于标识唯一性的字段名，默认为 'id'
+     */
+    copyRow(sourceIndex: number, options?: {
+        targetIndex?: number;
+        rowKey?: string;
+    }): void;
+    /**
+     * 交换两行位置
+     * @param sourceIndex 源行索引
+     * @param targetIndex 目标行索引
+     */
+    swapRow(sourceIndex: number, targetIndex: number): void;
+    /**
+     * 移动行到指定位置
+     * @param sourceIndex 要移动的行索引
+     * @param targetIndex 目标位置索引
+     */
+    moveRow(sourceIndex: number, targetIndex: number): void;
+    /**
+     * 获取当前所有数据
+     * @returns 当前表格的所有行数据
+     */
+    getData(): TData[];
+    /**
+     * 获取指定行数据
+     * @param index 行索引
+     * @returns 指定行的数据，如果索引无效则返回 undefined
+     */
+    getRow(index: number): TData | undefined;
+    /**
+     * 开始编辑指定行
+     * @param index 要编辑的行索引
+     */
+    startEdit(index: number): void;
+    /**
+     * 保存当前编辑行的修改
+     */
+    saveEdit(): void;
+    /**
+     * 取消当前行的编辑,还原数据
+     */
+    cancelEdit(): void;
+    /**
+     * 判断指定行是否处于编辑状态
+     * @param index 行索引
+     */
+    isRowEditing(index: number): boolean;
+    /**
+     * 获取当前正在编辑的行索引
+     */
+    getEditingIndex(): number | null;
+}
+export type { TableRowController as TableRowControllerType };

package/lib/types/features/row-edit/actions.d.ts

@@ -0,0 +1,12 @@
+import type { TableCtxRefType } from '../../table';
+/**
+ * 创建行编辑按钮
+ * @param rowActions 行操作对象
+ * @param index 行索引
+ * @returns 编辑按钮对象
+ */
+export declare function createEditButtons(rowActions: TableCtxRefType<AnyType>['rowActions'], index: number): {
+    edit: JSX.Element;
+    save: JSX.Element;
+    cancel: JSX.Element;
+};